虛擬主機提供邏輯分組,可將 Web 應用程式配置成特定主機名稱。預設虛擬主機 (default_host) 適用於大部分簡易的配置。
Name | Type | Default | Description |
---|---|---|---|
id | string | 唯一的配置 ID。 | |
enabled | boolean | true | 啟用這個虛擬主機。 |
allowFromEndpointRef | 最上層 httpEndpoint 元素的參照清單(逗點區隔的字串)。 | 指定一或多個 HTTP 端點的 ID,以限制虛擬主機只接受來自指定端點的入埠資料流量。 |
使用 host:port 語法來建立主機和埠與此虛擬主機的關聯性。指定的主機可以是 IP 位址、含網域名稱字尾的網域名稱伺服器 (DNS) 主機名稱、DNS 主機名稱,或 * 表示以萬用字元比對所有主機名稱。請注意,IPv6 位址必須以 [] 括住。
指定一或多個 HTTP 端點的 ID,以限制虛擬主機只接受來自指定端點的入埠資料流量。
Name | Type | Default | Description |
---|---|---|---|
id | string | 唯一的配置 ID。 | |
onError |
| WARN | 無法啟動端點之後要採取的動作。 IGNORE 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。 WARN 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。 FAIL 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。 |
enabled | boolean | true | 切換此端點的可用性。如果是 true,分派器便會啟動這個端點來處理 HTTP 要求。 |
host | string | localhost | 用戶端用來要求資源的 IP 位址、含網域名稱字尾的網域名稱伺服器 (DNS) 主機名稱,或只是 DNS 主機名稱。使用 '*' 來代表所有可用網路介面。 |
httpPort | int Min: -1 Max: 65535 | 用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。 | |
httpsPort | int 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 通訊協定選項。
Name | Type | Default | Description |
---|---|---|---|
keepAliveEnabled | boolean | true | 啟用持續性連線(HTTP 保持作用中)。如果是 true,連線會保持作用中,供多個循序要求和回應重複使用。如果是 false,則會送出回應之後關閉連線。 |
maxKeepAliveRequests | int 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 秒。 |
removeServerHeader | boolean | false | 將伺服器實作資訊從 HTTP 標頭移除,同時停用預設的 Liberty 設定檔歡迎使用頁面。 |
NoCacheCookiesControl | boolean | true | 容許使用者控制 Set-Cookie 標頭的顯示狀態是否應以相符的「無快取」值來更新 Cache-Control 標頭。這也會新增 Expires 標頭。 |
AutoDecompression | boolean | true | 指定 HTTP 通道是否要自動解壓縮送入要求內文資料。 |
allowFromEndpoint > sslOptions
端點的 SSL 通訊協定選項。
Name | Type | Default | Description |
---|---|---|---|
sessionTimeout | 精準度是秒鐘的時間量 | 1d | 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 |
suppressHandshakeErrors | boolean | false | 停用 SSL 信號交換記載錯誤。在正常作業期間可能會發生 SSL 信號交換錯誤,不過當 SSL 的行為並非所預期時,這些訊息可能會非常有用。 |
sslRef | 最上層 ssl 元素的參照(字串)。 | 預設 SSL 配置儲存庫。預設值是 defaultSSLSettings。 | |
sslSessionTimeout | 精準度是毫秒的時間量 | 8640ms | 「SSL 通道」所建立之 SSL 階段作業的逾時限制。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 |
allowFromEndpoint > tcpOptions
端點的 TCP 通訊協定選項。
Name | Type | Default | Description |
---|---|---|---|
inactivityTimeout | 精準度是毫秒的時間量 | 60s | 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 |
soReuseAddr | boolean | true | 在沒有作用中接聽器的情況下,能夠立即重新連結至埠。 |
addressIncludeList | string | 容許在這個端點上建立入埠連線的位址清單(以逗點區隔)。您可以指定 IPv4 或 IPv6 位址。IPv4 或 IPv6 位址中的所有值都必須用數字或星號萬用字元來表示。 | |
addressExcludeList | string | 不容許在這個端點上建立入埠連線的位址清單(以逗點區隔)。您可以指定 IPv4 或 IPv6 位址。IPv4 或 IPv6 位址中的所有值都必須用數字或星號萬用字元來表示。 | |
hostNameIncludeList | string | 容許在這個端點上建立入埠連線的主機名稱清單(以逗點區隔)。主機名稱不區分大小寫,且開頭可以是星號(作為萬用字元)。不過,星號不能位於主機名稱中的其他位置。例如,* abc.com 有效,但 *.abc.* 無效。 | |
hostNameExcludeList | string | 不容許在這個端點上建立入埠連線的主機名稱清單(以逗點區隔)。主機名稱不區分大小寫,且開頭可以是星號(作為萬用字元)。不過,星號不能位於主機名稱中的其他位置。例如,* abc.com 有效,但 *.abc.* 無效。 |
allowFromEndpoint > accessLogging
端點的 HTTP 存取記載配置。
Name | Type | Default | Description |
---|---|---|---|
enabled | boolean | true | 啟用存取記載。 |
filePath | 檔案的路徑 | ${server.output.dir}/logs/http_access.log | 存取日誌檔的目錄路徑和名稱。指定目錄路徑時,可以使用標準變數替代項目,例如 ${server.output.dir}。 |
logFormat | string | %h %u %{t}W "%r" %s %b | 指定記載用戶端存取資訊時要使用的日誌格式。 |
maxFileSize | int Min: 0 | 20 | 日誌檔在輪替之前的大小上限 (MB);0 值表示無限制。 |
maxFiles | int Min: 0 | 2 | 在移除最舊檔案之前,將保留的日誌檔數目上限;0 值表示無限制。 |