虛擬主機 (virtualHost)
虛擬主機提供邏輯分組,可將 Web 應用程式配置成特定主機名稱。預設虛擬主機 (default_host) 適用於大部分簡易的配置。
屬性名稱 | 資料類型 | 預設值 | 說明 |
---|---|---|---|
allowFromEndpointRef | 最上層 httpEndpoint 元素的參照清單(逗點區隔的字串)。 | 指定一或多個 HTTP 端點的 ID,以限制虛擬主機只接受來自指定端點的入埠資料流量。 | |
enabled | boolean | true | 啟用這個虛擬主機。 |
id | string | 唯一的配置 ID。 |
- allowFromEndpoint
說明: 指定一或多個 HTTP 端點的 ID,以限制虛擬主機只接受來自指定端點的入埠資料流量。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 accessLoggingRef 最上層 httpAccessLogging 元素的參照(字串)。 端點的 HTTP 存取記載配置。 enabled boolean true 切換此端點的可用性。如果是 true,分派器便會啟動這個端點來處理 HTTP 要求。 host string localhost 用戶端用來要求資源的 IP 位址、含網域名稱字尾的網域名稱伺服器 (DNS) 主機名稱,或只是 DNS 主機名稱。使用 '*' 來代表所有可用網路介面。 httpOptionsRef 最上層 httpOptions 元素的參照(字串)。 defaultHttpOptions 端點的 HTTP 通訊協定選項。 httpPort int 下限:-1
上限:65535
用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。 httpsPort int 下限:-1
上限:65535
受到 SSL (https) 保護的用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。 id string 唯一的配置 ID。 onError - IGNORE
- FAIL
- WARN
WARN 無法啟動端點之後要採取的動作。 - IGNORE
- 伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
- FAIL
- 伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
- WARN
- 伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
sslOptionsRef 最上層 sslOptions 元素的參照(字串)。 端點的 SSL 通訊協定選項。 tcpOptionsRef 最上層 tcpOptions 元素的參照(字串)。 defaultTCPOptions 端點的 TCP 通訊協定選項。 - allowFromEndpoint > accessLogging
說明: 端點的 HTTP 存取記載配置。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 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 下限:0
20 日誌檔在輪替之前的大小上限 (MB);0 值表示無限制。 maxFiles int 下限:0
2 在移除最舊檔案之前,將保留的日誌檔數目上限;0 值表示無限制。
- allowFromEndpoint > httpOptions
說明: 端點的 HTTP 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 keepAliveEnabled boolean true 啟用持續性連線(HTTP 保持作用中)。如果是 true,連線會保持作用中,供多個循序要求和回應重複使用。如果是 false,則會送出回應之後關閉連線。 maxKeepAliveRequests int 下限:-1
100 啟用持續性連線時,單一 HTTP 連線所允許的持續性要求數目上限。值 -1 表示無限制。 persistTimeout 精準度是秒鐘的時間量 30s 允許 Socket 在要求之間保持閒置的時間量。只有在啟用持續性連線時,這項設定才適用。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 readTimeout 精準度是秒鐘的時間量 60s 在進行第一次讀取之後,在 Socket 上等待讀取要求完成的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 removeServerHeader boolean false 將伺服器實作資訊從 HTTP 標頭移除,同時停用預設的 Liberty 設定檔歡迎使用頁面。 writeTimeout 精準度是秒鐘的時間量 60s 在 Socket 上等待傳輸每部分回應資料的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
- allowFromEndpoint > sslOptions
說明: 端點的 SSL 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 sessionTimeout 精準度是秒鐘的時間量 1d 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 sslRef 最上層 ssl 元素的參照(字串)。 預設 SSL 配置儲存庫。預設值是 defaultSSLSettings。 sslSessionTimeout 精準度是毫秒的時間量 8640ms %ssl.sslSessionTimeout.desc. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 suppressHandshakeErrors boolean false 停用 SSL 信號交換記載錯誤。在正常作業期間可能會發生 SSL 信號交換錯誤,不過當 SSL 的行為並非所預期時,這些訊息可能會非常有用。
- allowFromEndpoint > tcpOptions
說明: 端點的 TCP 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 inactivityTimeout 精準度是毫秒的時間量 60s 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 soReuseAddr boolean true 在沒有作用中接聽器的情況下,能夠立即重新連結至埠。