virtualHost - Host wirtualny (virtualHost)

Host wirtualny udostępnia grupę logiczną na potrzeby konfigurowania konkretnej nazwy hosta w aplikacjach WWW. W większości prostych konfiguracji odpowiednim ustawieniem jest domyślny host wirtualny (default_host).

NameTypeDefaultDescription
idłańcuchUnikalny identyfikator konfiguracji.
enabledbooleantrueWłącz ten host wirtualny.
allowFromEndpointRefLista odwołań do elementów httpEndpoint najwyższego poziomu (łańcuch rozdzielany przecinkami).Określ identyfikator jednego lub więcej punktów końcowych HTTP, aby ograniczyć ruch przychodzący tego hosta wirtualnego do określonych punktów końcowych.

hostAlias

Powiąż host i port z tym hostem wirtualnym, używając składni host:port. Host może być określony jako adres IP, nazwa hosta serwera nazw domen (DNS) z przyrostkiem nazwy domeny, sama nazwa hosta serwera DNS lub jako znak wieloznaczny * umożliwiający dopasowanie wszystkich nazw hostów. Adresy IPv6 muszą być ujęte w nawiasy [].

allowFromEndpoint

Określ identyfikator jednego lub więcej punktów końcowych HTTP, aby ograniczyć ruch przychodzący tego hosta wirtualnego do określonych punktów końcowych.

NameTypeDefaultDescription
idłańcuchUnikalny identyfikator konfiguracji.
onError
  • IGNORE
  • WARN
  • FAIL
WARNDziałanie wykonywane po nieudanym uruchomieniu punktu końcowego.
IGNORE
Serwer nie będzie wysyłał żadnych ostrzeżeń ani komunikatów o błędach, gdy znajdzie błąd konfiguracji.
WARN
Serwer wyśle ostrzeżenie i komunikaty o błędach, gdy znajdzie błąd konfiguracji.
FAIL
Serwer wyśle ostrzeżenie lub komunikaty o błędach po pierwszym wystąpieniu błędu, a następnie serwer zostanie zatrzymany.
enabledbooleantruePrzełącz dostępność danego punktu końcowego. Wartość true oznacza, że dany punkt końcowy będzie aktywowany przez program rozsyłający do obsługi żądań HTTP.
hoststringlocalhostAdres IP, nazwa hosta serwera nazw domen (DNS) z przyrostkiem nazwy domeny lub po prostu nazwa hosta systemu DNS używana przez klient w żądaniach dotyczących zasobów. Użyj znaku gwiazdki (*) dla określenia wszystkich dostępnych interfejsów sieciowych.
httpPortint
Min: -1

Max: 65535
Port używany na potrzeby żądań HTTP klientów. Ustawienie wartości -1 umożliwia wyłączenie portu.
httpsPortint
Min: -1

Max: 65535
Port używany na potrzeby żądań HTTP klientów zabezpieczonych przy użyciu protokołu SSL (HTTPS). Ustawienie wartości -1 umożliwia wyłączenie portu.
httpOptionsRefOdwołanie do elementu httpOptions najwyższego poziomu (łańcuch).defaultHttpOptionsOpcje protokołu HTTP dla tego punktu końcowego.
sslOptionsRefOdwołanie do elementu sslOptions najwyższego poziomu (łańcuch).Opcje protokołu SSL dla tego punktu końcowego.
tcpOptionsRefOdwołanie do elementu tcpOptions najwyższego poziomu (łańcuch).defaultTCPOptionsOpcje protokołu TCP dla tego punktu końcowego.
accessLoggingRefOdwołanie do elementu httpAccessLogging najwyższego poziomu (łańcuch).Konfiguracja rejestrowania dostępu HTTP dla punktu końcowego.

allowFromEndpoint > httpOptions

Opcje protokołu HTTP dla tego punktu końcowego.

NameTypeDefaultDescription
keepAliveEnabledbooleantrueWłącza połączenia trwałe (utrzymywanie aktywności połączenia HTTP). Wartość true oznacza, że utrzymywana jest aktywność połączeń na potrzeby ponownego wykorzystania przez wiele sekwencyjnych żądań i odpowiedzi. Wartość false oznacza, że połączenia są zamykane po wysłaniu odpowiedzi.
maxKeepAliveRequestsint
Min: -1
100Maksymalna liczba trwałych żądań dozwolonych w ramach jednego połączenia HTTP, gdy włączone są połączenia trwałe. Wartość -1 oznacza nieograniczoną liczbę.
persistTimeoutOkres z dokładnością do sekundy30sCzas, przez który gniazdo może pozostać bezczynne między żądaniami. To ustawienie obowiązuje jedynie w przypadku włączenia połączeń trwałych. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.
readTimeoutOkres z dokładnością do sekundy60sCzas oczekiwania na zakończenie żądania odczytu w gnieździe po wystąpieniu pierwszego odczytu. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.
writeTimeoutOkres z dokładnością do sekundy60sCzas oczekiwania w gnieździe na przesłanie poszczególnych porcji danych odpowiedzi. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.
removeServerHeaderbooleanfalseUsuwa informacje o implementacji serwera z nagłówków HTTP oraz wyłącza domyślną stronę powitania profilu Liberty.
NoCacheCookiesControlbooleantrueUmożliwia użytkownikowi wskazywanie, czy obecność nagłówka Set-Cookie powinna powodować aktualizowanie nagłówka Cache-Control przy użyciu wartości no-cache. To powoduje także dodanie nagłówka Expires.
AutoDecompressionbooleantrueWskazuje, czy kanał HTTP automatycznie dekompresuje dane treści żądania przychodzącego.

allowFromEndpoint > sslOptions

Opcje protokołu SSL dla tego punktu końcowego.

NameTypeDefaultDescription
sessionTimeoutOkres z dokładnością do sekundy1dCzas oczekiwania na zakończenie żądania odczytu lub zapisu w gnieździe. Ta wartość jest przesłaniana przez limity czasu specyficzne dla protokołu. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m) lub sekundy (s). Na przykład określ 30 sekund jako 30s. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1m30s oznacza 90 sekund.
suppressHandshakeErrorsbooleanfalseWyłącz rejestrowanie błędów uzgadniania SSL. Błędy uzgadniania SSL mogą występować w czasie normalnego działania, jednak komunikaty mogą być pomocne, jeśli protokół SSL zachowuje się w sposób nieoczekiwany.
sslRefOdwołanie do elementu ssl najwyższego poziomu (łańcuch).Domyślny repertuar konfiguracji SSL. Wartość domyślna to defaultSSLSettings.
sslSessionTimeoutOkres z dokładnością do milisekundy8640msLimit czasu sesji SSL, która jest nawiązana przez kanał SSL. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m), sekundy (s) lub milisekundy (ms). Na przykład określ 500 milisekund jako 500ms. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1s500ms oznacza 1,5 sekundy.

allowFromEndpoint > tcpOptions

Opcje protokołu TCP dla tego punktu końcowego.

NameTypeDefaultDescription
inactivityTimeoutOkres z dokładnością do milisekundy60sCzas oczekiwania na zakończenie żądania odczytu lub zapisu w gnieździe. Ta wartość jest przesłaniana przez limity czasu specyficzne dla protokołu. Określ dodatnią liczbę całkowitą, po której następuje jednostka czasu, taka jak godziny (h), minuty (m), sekundy (s) lub milisekundy (ms). Na przykład określ 500 milisekund jako 500ms. W pojedynczej pozycji można zawrzeć wiele wartości. Na przykład 1s500ms oznacza 1,5 sekundy.
soReuseAddrbooleantrueWłącza natychmiastowe ponowne powiązanie z portem bez aktywnego programu nasłuchującego.
addressIncludeListstringRozdzielana przecinkami lista adresów, które mogą nawiązywać połączenia przychodzące w tym punkcie końcowym. Można podać adres IPv4 lub IPv6. Wszystkie wartości w adresach typu IPv4 lub IPv6 muszą być reprezentowane przez liczbę lub znak wieloznaczny w postaci gwiazdki.
addressExcludeListstringRozdzielana przecinkami lista adresów, które nie mogą nawiązywać połączeń przychodzących w tym punkcie końcowym. Można podać adres IPv4 lub IPv6. Wszystkie wartości w adresach typu IPv4 lub IPv6 muszą być reprezentowane przez liczbę lub znak wieloznaczny w postaci gwiazdki.
hostNameIncludeListstringRozdzielana przecinkami lista nazw hostów, które mogą nawiązywać połączenia przychodzące w tym punkcie końcowym. Nazwy hostów mogą zaczynać się od gwiazdki (używanej jako znak wieloznaczny) i nie jest w nich rozróżniana wielkość liter. Jednak gwiazdki nie mogą występować w dowolnym miejscu nazwy hosta. Na przykład nazwa *.abc.com jest poprawna, ale nazwa *.abc.* jest niepoprawna.
hostNameExcludeListstringRozdzielana przecinkami lista nazw hostów, które nie mogą nawiązywać połączeń przychodzących w tym punkcie końcowym. Nazwy hostów mogą zaczynać się od gwiazdki (używanej jako znak wieloznaczny) i nie jest w nich rozróżniana wielkość liter. Jednak gwiazdki nie mogą występować w dowolnym miejscu nazwy hosta. Na przykład nazwa *.abc.com jest poprawna, ale nazwa *.abc.* jest niepoprawna.

allowFromEndpoint > accessLogging

Konfiguracja rejestrowania dostępu HTTP dla punktu końcowego.

NameTypeDefaultDescription
enabledbooleantrueWłącza rejestrowanie dostępu.
filePathŚcieżka do pliku${server.output.dir}/logs/http_access.logŚcieżka do katalogu i nazwa pliku dziennika dostępu. Określając ścieżkę do katalogu, można stosować standardowe podstawianie zmiennych, na przykład ${katalog.wyjściowy.serwera}.
logFormatstring%h %u %{t}W "%r" %s %bOkreśla format dziennika stosowany przy rejestrowaniu informacji o dostępie klientów.
maxFileSizeint
Min: 0
20Maksymalna wielkość (w megabajtach) pliku dziennika przed jego zastąpieniem. Wartość 0 oznacza brak limitu.
maxFilesint
Min: 0
2Maksymalna liczba przechowywanych plików dziennika, zanim najstarszy plik zostaje usunięty. Wartość 0 oznacza brak limitu.