virtualHost - Gazdă virtuală (virtualHost)

O gazdă virtuală asigură o grupare logică pentru configurarea aplicaţiilor web la un anumit nume de gazdă. Gazda implicită virtuală (default_host) este potrivită pentru cele mai simple configuraţii.

NameTypeDefaultDescription
idşirUn ID de configuraţie unic.
enabledbooleantrueActivaţi această gazdă virtuală.
allowFromEndpointRefListă de referinţe la elemente de nivel înalt httpEndpoint (şir separat prin virgule).Specificaţi identificatorul pentru unul sau mai multe puncte finale HTTP pentru a restricţiona traficul de intrare pentru această gazdă virtuală către punctele finale specificate.

hostAlias

Asociaţi o gazdă şi un port cu această gazdă virtuală, utilizând sintaxa host:port. Gazda specificată poate fi o adresă IP, un nume de gazdă de server de nume de domenii (DNS) cu un sufix de nume de domeniu, numele de gazdă DNS sau * pentru o potrivire de metacaractere pe toate numele de gazde. Observaţi că adresele IPv6 trebuie să fie între [].

allowFromEndpoint

Specificaţi identificatorul pentru unul sau mai multe puncte finale HTTP pentru a restricţiona traficul de intrare pentru această gazdă virtuală către punctele finale specificate.

NameTypeDefaultDescription
idşirUn ID de configuraţie unic.
onError
  • IGNORE
  • WARN
  • FAIL
WARNAcţiune de efectuat după eşecul de pornire a unui punct final.
IGNORE
Serverul nu va emite niciun avertisment şi niciun mesaj de eroare când apare o eroare de configurare.
WARN
Serverul va emite un avertisment şi mesaje de eroare când apare o eroare de configurare.
FAIL
Serverul va emite un avertisment sau un mesaj de eroare la prima apariţie a unei erori şi apoi va opri serverul.
enabledbooleantrueComutare disponibilitate punct final. Când este adevărat, acest punct final va fi activat de către dispecer pentru manipularea cererilor HTTP.
hoststringlocalhostAdresă IP, nume gazdă DNS (domain name server) cu sufix de nume domeniu sau doar nume DNS gazdă utilizat de către un client pentru solicitarea unei resurse. Folosiţi '*' pentru toate interfeţele de reţea disponibile.
httpPortint
Min: -1

Max: 65535
Portul folosit pentru cererile HTTP de client. Folosiţi -1 pentru a dezactiva acest port.
httpsPortint
Min: -1

Max: 65535
Portul folosit pentru cererile HTTP de client securizate cu SSL (https). Folosiţi -1 pentru a dezactiva acest port.
httpOptionsRefO referinţă la elementul de nivel înalt httpOptions (şir).defaultHttpOptionsOpţiuni de protocol HTTP pentru punctul final.
sslOptionsRefO referinţă la elementul de nivel înalt sslOptions (şir).Opţiuni de protocol SSL pentru punctul final.
tcpOptionsRefO referinţă la elementul de nivel înalt tcpOptions (şir).defaultTCPOptionsOpţiuni de protocol TCP pentru punctul final.
accessLoggingRefO referinţă la elementul de nivel înalt httpAccessLogging (şir).Configurarea înregistrării în istoric a accesului HTTP pentru punctul final.

allowFromEndpoint > httpOptions

Opţiuni de protocol HTTP pentru punctul final.

NameTypeDefaultDescription
keepAliveEnabledbooleantruePermite conexiuni persitente (ţinere în viaţă HTTP). Dacă e adevărat, conexiunile sunt ţinute în viaţă pentru reutilizare de mai multe cereri şi răspunsuri secvenţiale. Dacă e fals, conexiunile sunt închise după ce se trimite răspunsul.
maxKeepAliveRequestsint
Min: -1
100Numărul maxim de cereri persistente care sunt permise pe o singură conexiune HTTP dacă sunt activate conexiunile persistente. Valoarea -1 înseamnă nelimitat.
persistTimeoutO perioadă de timp cu precizie de secunde30sDurata cât îi este permis unui socket să rămână nefolosit între cereri. Această setare se aplică numai dacă sunt activate conexiunile persistente. Specificaţi un întreg pozitiv urmat de o unitate de timp, care poate fi ore (o), minute (m) sau secunde (s). De exemplu, specificaţi 30 secunde ca 30s. Puteţi include valori multiple într-o singură intrare. De exemplu, 1m30s este echivalent cu 90 secunde.
readTimeoutO perioadă de timp cu precizie de secunde60sTimpul de aşteptare până la finalizarea unei cereri de citire pe un socket după apariţia primei citiri. Specificaţi un întreg pozitiv urmat de o unitate de timp, care poate fi ore (o), minute (m) sau secunde (s). De exemplu, specificaţi 30 secunde ca 30s. Puteţi include valori multiple într-o singură intrare. De exemplu, 1m30s este echivalent cu 90 secunde.
writeTimeoutO perioadă de timp cu precizie de secunde60sTimpul de aşteptare al unui socket pentru ca fiecare porţiune a datelor de răspuns să fie transmisă. Specificaţi un întreg pozitiv urmat de o unitate de timp, care poate fi ore (o), minute (m) sau secunde (s). De exemplu, specificaţi 30 secunde ca 30s. Puteţi include valori multiple într-o singură intrare. De exemplu, 1m30s este echivalent cu 90 secunde.
removeServerHeaderbooleanfalseÎnlătură informaţiile de implementare a serverului din anteturile HTTP şi, de asemenea, dezactivează pagina de bun venit a profilului implicit Liberty.
NoCacheCookiesControlbooleantruePermite utilizatorului să controleze dacă prezenţa unui antet Set-Cookie va actualiza sau nu antetul Cache-Control cu o valoare no-cache care să se potrivească. Aceasta va adăuga şi antetul Expires.
AutoDecompressionbooleantrueSpecifică dacă canalul HTTP decomprimă automat datele corpul cererii de intrare.

allowFromEndpoint > sslOptions

Opţiuni de protocol SSL pentru punctul final.

NameTypeDefaultDescription
sessionTimeoutO perioadă de timp cu precizie de secunde1dCantitatea de timp de aşteptare pentru a citi sau scrie cererea pentru a finaliza un socket. Această valoare este înlocuită de timeout-urile specifice protocolului. Specificaţi un întreg pozitiv urmat de o unitate de timp, care poate fi ore (o), minute (m) sau secunde (s). De exemplu, specificaţi 30 secunde ca 30s. Puteţi include valori multiple într-o singură intrare. De exemplu, 1m30s este echivalent cu 90 secunde.
suppressHandshakeErrorsbooleanfalseDezactivaţi înregistrarea în istoric a erorilor de dialog de confirmare SSL. Erorile de dialog de confirmare SSL pot apărea în timpul operaţiei normale, totuşi aceste mesaje pot fi utile când SSL se comportă neaşteptat.
sslRefO referinţă la elementul de nivel înalt ssl (şir).Repertoriul SSL de configuraţie implicit. Valoarea implicită este defaultSSLSettings.
sslSessionTimeoutO perioadă de timp cu precizie de milisecunde8640msLimita de timeout pentru o sesiune SSL care este stabilită de canalul SSL. Specificaţi un întreg pozitiv urmat de o unitate de timp, care poate fi ore (o), minute (m), secunde (s) sau milisecunde (ms). De exemplu, specificaţi 500 milisecunde ca 500ms. Puteţi include valori multiple într-o singură intrare. De exemplu, 1s500ms este echivalent cu 1.5 secunde.

allowFromEndpoint > tcpOptions

Opţiuni de protocol TCP pentru punctul final.

NameTypeDefaultDescription
inactivityTimeoutO perioadă de timp cu precizie de milisecunde60sCantitatea de timp de aşteptare pentru a citi sau scrie cererea pentru a finaliza un socket. Această valoare este înlocuită de timeout-urile specifice protocolului. Specificaţi un întreg pozitiv urmat de o unitate de timp, care poate fi ore (o), minute (m), secunde (s) sau milisecunde (ms). De exemplu, specificaţi 500 milisecunde ca 500ms. Puteţi include valori multiple într-o singură intrare. De exemplu, 1s500ms este echivalent cu 1.5 secunde.
soReuseAddrbooleantrueActivează relegarea imdiată la un port cu un ascultător activ.
addressIncludeListstringO listă separată de virgule de adrese cărora li se permite să facă conexiuni de intrare la acest punct final. Puteţi specifica adrese IPv4 sau IPv6. Toate valorile din adresele IPv4 sau IPv6 trebuie reprezentate de un număr sau de un metacaracter asterisc.
addressExcludeListstringO listă separată de virgule de adrese cărora nu li se permite să facă conexiuni de intrare la acest punct final. Puteţi specifica adrese IPv4 sau IPv6. Toate valorile din adresele IPv4 sau IPv6 trebuie reprezentate de un număr sau de un metacaracter asterisc.
hostNameIncludeListstringO listă separată de virgule de nume de gazde cărora li se permise să facă conexiuni de intrare la acest punct final. Numele de gazde nu sunt sensibile la majuscule şi pot începe cu un asterisc, care este folosit ca un metacaracter. Dar, asteriscurile nu pot fi în altă parte în numele de gazde. De exemplu, *.abc.com este valid, dar *.abc.* nu este valid.
hostNameExcludeListstringO listă separată de virgule de nume de gazde cărora nu li se permise să facă conexiuni de intrare la acest punct final. Numele de gazde nu sunt sensibile la majuscule şi pot începe cu un asterisc, care este folosit ca un metacaracter. Dar, asteriscurile nu pot fi în altă parte în numele de gazde. De exemplu, *.abc.com este valid, dar *.abc.* nu este valid.

allowFromEndpoint > accessLogging

Configurarea înregistrării în istoric a accesului HTTP pentru punctul final.

NameTypeDefaultDescription
enabledbooleantruePermiteţi jurnalizarea accesului
filePathCalea la un fişier${server.output.dir}/logs/http_access.logCalea de director şi numele fişierului istoric de acces. Substituţii de variabile standard, precum ${server.output.dir}, pot fi folosite când specificaţi calea directorului.
logFormatstring%h %u %{t}W "%r" %s %bSpecifică formatul istoricului folosit la înregistrarea în istoric a informaţiilor de acces client.
maxFileSizeint
Min: 0
20dimensiune maximă a unui fişier istoric, în megaocteţi, înainte de a fi derulat înapoi; o valoare de 0 înseamnă nicio limită.
maxFilesint
Min: 0
2Numărul maxim de fişiere istoric care vor fi păstrate, înainte ca fişierul cel mai vechi să fie înlăturat; o valoare de 0 înseamnă nicio limită.