virtualHost - Virtuální hostitel (virtualHost)

Virtuální hostitel zajišťuje logické seskupení pro účely konfigurace webových aplikací pro konkrétní název hostitele. Výchozí virtuální hostitel (default_host) je vhodný pro většinu jednoduchých konfigurací.

NameTypeDefaultDescription
idřetězecJedinečné ID konfigurace.
enabledbooleantruePovolí tohoto virtuálního hostitele.
allowFromEndpointRefSeznam odkazů na prvky nejvyšší úrovně httpEndpoint (řetězec oddělený čárkami).Určete identifikátor nejméně jednoho koncového bodu HTTP, chcete-li příchozí provoz pro tohoto virtuálního hostitele omezit jen na určené koncové body.

hostAlias

Přidružte k tomuto virtuálnímu hostiteli hostitele a port s použitím syntaxe hostitel:port. Uvedený hostitel může být adresa IP, jméno hostitele serveru názvů domény (DNS) s příponou názvu domény, název hostitele DNS, nebo zástupný znak *, který odpovídá všem názvům hostitelů. Pozor, adresy IPv6 musí být uzavřeny v [].

allowFromEndpoint

Určete identifikátor nejméně jednoho koncového bodu HTTP, chcete-li příchozí provoz pro tohoto virtuálního hostitele omezit jen na určené koncové body.

NameTypeDefaultDescription
idřetězecJedinečné ID konfigurace.
onError
  • IGNORE
  • WARN
  • FAIL
WARNAkce prováděná po neúspěšném spuštěná koncového bodu.
IGNORE
Server při rozpoznání chyby konfigurace nevygeneruje varovné ani chybové zprávy.
WARN
Server při rozpoznání chyby konfigurace vygeneruje varovné a chybové zprávy.
FAIL
Server při rozpoznání prvního výskytu chyby konfigurace vygeneruje varovnou či chybovou zprávu a poté se zastaví.
enabledbooleantruePřepíná dostupnost koncového bodu. Pokud má hodnotu true, dispečer aktivuje tento koncový bod ke zpracování požadavků HTTP.
hoststringlocalhostAdresa IP, název hostitele DNS (Domain Name Server) s příponou názvu domény nebo jen název hostitele DNS používaný klientem k vyžádání prostředku. Pro všechna dostupná síťová rozhraní použijte '*'.
httpPortint
Min: -1

Max: 65535
Port použitý pro požadavky HTTP klienta. Chcete-li tento port zakázat, použijte hodnotu -1.
httpsPortint
Min: -1

Max: 65535
Port použitý pro požadavky HTTP klienta zabezpečený prostřednictvím protokolu SSL (https). Chcete-li tento port zakázat, použijte hodnotu -1.
httpOptionsRefOdkaz na prvek nejvyšší úrovně httpOptions (řetězec).defaultHttpOptionsVolby protokolu HTTP koncového bodu.
sslOptionsRefOdkaz na prvek nejvyšší úrovně sslOptions (řetězec).Volby protokolu SSL koncového bodu.
tcpOptionsRefOdkaz na prvek nejvyšší úrovně tcpOptions (řetězec).defaultTCPOptionsVolby protokolu TCP koncového bodu.
accessLoggingRefOdkaz na prvek nejvyšší úrovně httpAccessLogging (řetězec).Konfigurace protokolování přístupu HTTP pro koncový bod.

allowFromEndpoint > httpOptions

Volby protokolu HTTP koncového bodu.

NameTypeDefaultDescription
keepAliveEnabledbooleantruePovolí trvalá připojení (udržení aktivity HTTP). Pokud má hodnotu true, je pomocí vícenásobných sekvenčních požadavků a odezev udržována aktivita připojení pro opětovné použití. Pokud má hodnotu false, připojení jsou po odeslání odezvy uzavřena.
maxKeepAliveRequestsint
Min: -1
100Určuje maximální počet trvalých požadavků povolený pro jedno připojení HTTP, pokud jsou povolena trvalá připojení. Hodnota -1 znamená neomezený počet.
persistTimeoutČasové období s přesností na sekundy30sDoba, po kterou může soket zůstat v nečinnosti mezi jednotlivými požadavky. Toto nastavení platí pouze, pokud jsou povolena trvalá připojení. Zadejte kladné celé číslo následované jednotkou času, což může být hodina (h), minuta (m) nebo sekunda (s). Například 30 sekund zadejte jako 30s. Do jedné položky můžete zahrnout více hodnot. Například 1m30s je ekvivalentní 90 sekundám.
readTimeoutČasové období s přesností na sekundy60sDoba čekání na zpracování požadavku na čtení v soketu po prvním čtení. Zadejte kladné celé číslo následované jednotkou času, což může být hodina (h), minuta (m) nebo sekunda (s). Například 30 sekund zadejte jako 30s. Do jedné položky můžete zahrnout více hodnot. Například 1m30s je ekvivalentní 90 sekundám.
writeTimeoutČasové období s přesností na sekundy60sDoba čekání na přenesení jednotlivých částí dat odpovědi prostřednictvím soketu. Zadejte kladné celé číslo následované jednotkou času, což může být hodina (h), minuta (m) nebo sekunda (s). Například 30 sekund zadejte jako 30s. Do jedné položky můžete zahrnout více hodnot. Například 1m30s je ekvivalentní 90 sekundám.
removeServerHeaderbooleanfalseOdebírá informace o implementaci serveru ze záhlaví HTTP a rovněž zakazuje úvodní stránku profilu Liberty.
NoCacheCookiesControlbooleantrueUmožňuje uživateli určit, zda má přítomnost záhlaví Set-Cookie aktualizovat záhlaví Cache-Control odpovídající no-cache hodnotou. Tato možnost také přidává záhlaví Expires.
AutoDecompressionbooleantrueUrčuje, zda kanál HTTP automaticky dekomprimuje data těla příchozích požadavků.

allowFromEndpoint > sslOptions

Volby protokolu SSL koncového bodu.

NameTypeDefaultDescription
sessionTimeoutČasové období s přesností na sekundy1dDoba, kterou se má počkat, než bude požadavek čtení nebo zápisu na soketu dokončen. Tato hodnota je potlačena časovými limity specifickými pro protokol. Zadejte kladné celé číslo následované jednotkou času, což může být hodina (h), minuta (m) nebo sekunda (s). Například 30 sekund zadejte jako 30s. Do jedné položky můžete zahrnout více hodnot. Například 1m30s je ekvivalentní 90 sekundám.
suppressHandshakeErrorsbooleanfalseZakázat protokolování chyb navázání komunikace přes zabezpečení SSL. K chybám navázání komunikace přes zabezpečení SSL může při normálním provozu docházet, ale tyto zprávy mohou být důležité, když se SSL chová nečekaným způsobem.
sslRefOdkaz na prvek nejvyšší úrovně ssl (řetězec).Repertoár konfigurace výchozího SSL. Výchozí hodnota je defaultSSLSettings.
sslSessionTimeoutČasové období s přesností na milisekundy8640msČasový limit relace SSL zřízené kanálem SSL. Zadejte kladné celé číslo následované jednotkou času, což může být hodina (h), minuta (m), sekunda (s) nebo milisekunda (ms). Například 500 milisekund zadejte jako 500ms. Do jedné položky můžete zahrnout více hodnot. Například 1s500ms je ekvivalentní 1,5 sekundy.

allowFromEndpoint > tcpOptions

Volby protokolu TCP koncového bodu.

NameTypeDefaultDescription
inactivityTimeoutČasové období s přesností na milisekundy60sDoba, kterou se má počkat, než bude požadavek čtení nebo zápisu na soketu dokončen. Tato hodnota je potlačena časovými limity specifickými pro protokol. Zadejte kladné celé číslo následované jednotkou času, což může být hodina (h), minuta (m), sekunda (s) nebo milisekunda (ms). Například 500 milisekund zadejte jako 500ms. Do jedné položky můžete zahrnout více hodnot. Například 1s500ms je ekvivalentní 1,5 sekundy.
soReuseAddrbooleantrueUmožňuje okamžité převázání na port bez aktivního listeneru.
addressIncludeListstringSeznam adres oddělený čárkami, kterým je povoleno navazovat příchozí připojení v tomto koncovém bodu. Zadat můžete adresu IPv4 nebo IPv6. Všechny hodnoty v adresách IPv4 nebo IPv6 musí být vyjádřeny číslem nebo zástupným znakem hvězdičky.
addressExcludeListstringSeznam adres oddělený čárkami, kterým není povoleno navazovat příchozí připojení v tomto koncovém bodu. Zadat můžete adresu IPv4 nebo IPv6. Všechny hodnoty v adresách IPv4 nebo IPv6 musí být vyjádřeny číslem nebo zástupným znakem hvězdičky.
hostNameIncludeListstringSeznam názvů hostitelů oddělený čárkami, kterým je povoleno navazovat příchozí připojení v tomto koncovém bodu. Názvy hostitelů rozlišují velká a malá písmena a mohou začínat hvězdičkou, což je zástupný znak. Nicméně hvězdičky nemohou být v názvu hostitele na jiném místě. Např. *.abc.com je platné, ale *.abc.* platné není.
hostNameExcludeListstringSeznam názvů hostitelů oddělený čárkami, kterým není povoleno navazovat příchozí připojení v tomto koncovém bodu. Názvy hostitelů rozlišují velká a malá písmena a mohou začínat hvězdičkou, což je zástupný znak. Nicméně hvězdičky nemohou být v názvu hostitele na jiném místě. Např. *.abc.com je platné, ale *.abc.* platné není.

allowFromEndpoint > accessLogging

Konfigurace protokolování přístupu HTTP pro koncový bod.

NameTypeDefaultDescription
enabledbooleantruePovoluje protokolování přístupu.
filePathCesta k souboru${server.output.dir}/logs/http_access.logCesta k adresáři s názvem souboru protokolu přístupu. Při zadávání cesty k adresáři lze použít standardní substituce proměnných, jako například ${server.output.dir}.
logFormatstring%h %u %{t}W "%r" %s %bUrčuje formát protokolu, jenž má být použit k protokolování informací o klientském přístupu.
maxFileSizeint
Min: 0
20Maximální velikost souboru protokolu v megabajtech před založením nového souboru. Hodnota 0 znamená neomezenou velikost.
maxFilesint
Min: 0
2Maximální počet souborů protokolu, které budou uchovány před tím, než bude odebrán nejstarší soubor. Hodnota 0 znamená neomezený počet.