virtualHost - 虛擬主機 (virtualHost)

虛擬主機提供邏輯分組,可將 Web 應用程式配置成特定主機名稱。預設虛擬主機 (default_host) 適用於大部分簡易的配置。

NameTypeDefaultDescription
idstring唯一的配置 ID。
enabledbooleantrue啟用這個虛擬主機。
allowFromEndpointRef最上層 httpEndpoint 元素的參照清單(逗點區隔的字串)。指定一或多個 HTTP 端點的 ID,以限制虛擬主機只接受來自指定端點的入埠資料流量。

hostAlias

使用 host:port 語法來建立主機和埠與此虛擬主機的關聯性。指定的主機可以是 IP 位址、含網域名稱字尾的網域名稱伺服器 (DNS) 主機名稱、DNS 主機名稱,或 * 表示以萬用字元比對所有主機名稱。請注意,IPv6 位址必須以 [] 括住。

allowFromEndpoint

指定一或多個 HTTP 端點的 ID,以限制虛擬主機只接受來自指定端點的入埠資料流量。

NameTypeDefaultDescription
idstring唯一的配置 ID。
onError
  • IGNORE
  • WARN
  • FAIL
WARN無法啟動端點之後要採取的動作。
IGNORE
伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
WARN
伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
FAIL
伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
enabledbooleantrue切換此端點的可用性。如果是 true,分派器便會啟動這個端點來處理 HTTP 要求。
hoststringlocalhost用戶端用來要求資源的 IP 位址、含網域名稱字尾的網域名稱伺服器 (DNS) 主機名稱,或只是 DNS 主機名稱。使用 '*' 來代表所有可用網路介面。
httpPortint
Min: -1

Max: 65535
用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。
httpsPortint
Min: -1

Max: 65535
受到 SSL (https) 保護的用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。
httpOptionsRef最上層 httpOptions 元素的參照(字串)。defaultHttpOptions端點的 HTTP 通訊協定選項。
sslOptionsRef最上層 sslOptions 元素的參照(字串)。端點的 SSL 通訊協定選項。
tcpOptionsRef最上層 tcpOptions 元素的參照(字串)。defaultTCPOptions端點的 TCP 通訊協定選項。
accessLoggingRef最上層 httpAccessLogging 元素的參照(字串)。端點的 HTTP 存取記載配置。

allowFromEndpoint > httpOptions

端點的 HTTP 通訊協定選項。

NameTypeDefaultDescription
keepAliveEnabledbooleantrue啟用持續性連線(HTTP 保持作用中)。如果是 true,連線會保持作用中,供多個循序要求和回應重複使用。如果是 false,則會送出回應之後關閉連線。
maxKeepAliveRequestsint
Min: -1
100啟用持續性連線時,單一 HTTP 連線所允許的持續性要求數目上限。值 -1 表示無限制。
persistTimeout精準度是秒鐘的時間量30s允許 Socket 在要求之間保持閒置的時間量。只有在啟用持續性連線時,這項設定才適用。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
readTimeout精準度是秒鐘的時間量60s在進行第一次讀取之後,在 Socket 上等待讀取要求完成的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
writeTimeout精準度是秒鐘的時間量60s在 Socket 上等待傳輸每部分回應資料的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
removeServerHeaderbooleanfalse將伺服器實作資訊從 HTTP 標頭移除,同時停用預設的 Liberty 設定檔歡迎使用頁面。
NoCacheCookiesControlbooleantrue容許使用者控制 Set-Cookie 標頭的顯示狀態是否應以相符的「無快取」值來更新 Cache-Control 標頭。這也會新增 Expires 標頭。
AutoDecompressionbooleantrue指定 HTTP 通道是否要自動解壓縮送入要求內文資料。

allowFromEndpoint > sslOptions

端點的 SSL 通訊協定選項。

NameTypeDefaultDescription
sessionTimeout精準度是秒鐘的時間量1d在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
suppressHandshakeErrorsbooleanfalse停用 SSL 信號交換記載錯誤。在正常作業期間可能會發生 SSL 信號交換錯誤,不過當 SSL 的行為並非所預期時,這些訊息可能會非常有用。
sslRef最上層 ssl 元素的參照(字串)。預設 SSL 配置儲存庫。預設值是 defaultSSLSettings。
sslSessionTimeout精準度是毫秒的時間量8640ms「SSL 通道」所建立之 SSL 階段作業的逾時限制。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。

allowFromEndpoint > tcpOptions

端點的 TCP 通訊協定選項。

NameTypeDefaultDescription
inactivityTimeout精準度是毫秒的時間量60s在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
soReuseAddrbooleantrue在沒有作用中接聽器的情況下,能夠立即重新連結至埠。
addressIncludeListstring容許在這個端點上建立入埠連線的位址清單(以逗點區隔)。您可以指定 IPv4 或 IPv6 位址。IPv4 或 IPv6 位址中的所有值都必須用數字或星號萬用字元來表示。
addressExcludeListstring不容許在這個端點上建立入埠連線的位址清單(以逗點區隔)。您可以指定 IPv4 或 IPv6 位址。IPv4 或 IPv6 位址中的所有值都必須用數字或星號萬用字元來表示。
hostNameIncludeListstring容許在這個端點上建立入埠連線的主機名稱清單(以逗點區隔)。主機名稱不區分大小寫,且開頭可以是星號(作為萬用字元)。不過,星號不能位於主機名稱中的其他位置。例如,* abc.com 有效,但 *.abc.* 無效。
hostNameExcludeListstring不容許在這個端點上建立入埠連線的主機名稱清單(以逗點區隔)。主機名稱不區分大小寫,且開頭可以是星號(作為萬用字元)。不過,星號不能位於主機名稱中的其他位置。例如,* abc.com 有效,但 *.abc.* 無效。

allowFromEndpoint > accessLogging

端點的 HTTP 存取記載配置。

NameTypeDefaultDescription
enabledbooleantrue啟用存取記載。
filePath檔案的路徑${server.output.dir}/logs/http_access.log存取日誌檔的目錄路徑和名稱。指定目錄路徑時,可以使用標準變數替代項目,例如 ${server.output.dir}。
logFormatstring%h %u %{t}W "%r" %s %b指定記載用戶端存取資訊時要使用的日誌格式。
maxFileSizeint
Min: 0
20日誌檔在輪替之前的大小上限 (MB);0 值表示無限制。
maxFilesint
Min: 0
2在移除最舊檔案之前,將保留的日誌檔數目上限;0 值表示無限制。