Proxy 伺服器設定

請利用這個主題來執行 Proxy 伺服器的進階配置。Proxy 設定可讓系統管理者適當調整 Proxy 伺服器的行為。 尤其是,您可以配置應用程式伺服器的連線和要求、啟用快取、配置必須拒絕的要求、定義處理錯誤回應的方式,以及指定 Proxy 日誌的位置。

建立時,Proxy 伺服器會自動感應環境,能夠將要求遞送至產品。 您也可以針對 Proxy 伺服器套用額外的配置,以符合特定環境的需求。

如果要檢視這個管理主控台頁面,請按一下伺服器 > 伺服器類型 > WebSphere Proxy 伺服器 > proxy_server_name > HTTP Proxy 伺服器設定 > Proxy 設定

避免困難 避免困難: 如果您建立的 Proxy 伺服器是 Proxy 伺服器叢集的一部分,則在 Proxy 伺服器層次上,您所能修改的唯一 HTTP Proxy 伺服器設定為本端出埠 TCP 位址。 其他 HTTP Proxy 伺服器設定必須在 Proxy 叢集層次設定。如需如何配置屬於 Proxy 伺服器叢集之 Proxy 伺服器的相關資訊,請參閱修改 Proxy 伺服器叢集Proxy 叢集成員設定主題。gotcha

您可以在「配置」標籤中,編輯 Proxy 伺服器的可配置欄位設定。

啟用 Web 服務支援

指定是否啟用 Proxy 伺服器來遞送 Web 服務資料流量。

參考資訊
資料類型 布林
預設值 True

排除

Proxy 伺服器會檢查每個送入的要求。 您可以定義要排除的特定方法,如果所要求的 HTTP 方法符合要排除的任何一個已配置的方法,Proxy 伺服器會拒絕要求,且會發出「不接受方法」的錯誤。請將每個方法打成一行輸入。

靜態遞送檔案目錄

指定 Proxy 伺服器上靜態遞送檔案所在的目錄。

參考資訊
資料類型 String
預設值 profile_home/staticRoutes

已停用的 HTTP 方法

指定已針對 Proxy 伺服器停用的 HTTP 方法清單。選取啟用這項設定的勾選框。按一下新建刪除來新增或移除清單中的 HTTP 方法。

參考資訊
資料類型 String
預設值 空白

出埠連線設定

指定 Proxy 伺服器與內容伺服器之間的基本 HTTP 連線參數。

出埠要求讀取逾時
指定在內容伺服器要求逾時之前,Proxy 伺服器等候回應的預設秒數。 當變更這個值時,請仔細考慮這個選項。
出埠要求寫入逾時
指定 Proxy 伺服器等待向內容伺服器發出要求寫入的預設秒數。當變更這個值時,請仔細考慮這個選項。
出埠連線逾時值
指定 Proxy 伺服器等待連接伺服器的毫秒數。如果過了此時間,Proxy 伺服器會試著連接不同的伺服器。如果已無其他可用的伺服器,則要求即發生逾時。值 0 表示 Proxy 伺服器應使用作業系統核心逾時值。
內容伺服器儲存區連線
指定選項以將伺服器的連線放入儲存區,這是最佳化功能。 儲存區作業可讓 Proxy 伺服器將伺服器的 Socket 連線放到儲存區中供重複使用,使您不需經常建立及毀損這些連線。
每部伺服器的連線數目上限
指定將任何單一內容伺服器的連線放入儲存區的連線數目上限。
本端出埠 TCP 位址
指定進出 SIP 儲存器之資料的本端出埠「傳輸控制通訊協定」(TCP) 位址。 這個設定值是在網路分段時,在 SIP Proxy 和 SIP 儲存器之間所有通訊所用的主機名稱或 IP 位址。
參考資訊
資料類型 String
預設值 *
範圍 IP 位址或有效主機名稱
下列 Proxy 自訂內容可用來調整出埠連線。
  • key=http.maxTargetReconnects:每一個要求重新連線至同一目標內容伺服器的數目上限。 預設值是 5。
  • key=http.maxTargetRetries:Proxy 針對每一個要求嘗試選取新的目標內容伺服器的次數上限。 預設值是 5。
  • key=http.routing.sendReverseProxyNameInHost:決定不在 WebSphere® Application Server 內容伺服器上的內容是否要重新撰寫主機標頭。選項包括 truefalse,並且不區分大小寫。 如果這個內容的值是預設值 false,便會重新撰寫主機標頭,作為目標伺服器的主機。如果這個內容的值是 true,便不會重新撰寫主機標頭。
  • key=http.compliance.disable:決定是否要在 Proxy 內容伺服器連線中,強制執行 HTTP V1.1 標準。選項包括 truefalse,並且不區分大小寫。 預設值是 false。
  • key=http.compliance.via:附加至符合 HTTP 標準的要求和回應之 Via 標頭值。 如果這個值是空值,就不會附加 Via 標頭。 如果這個值是 true,就會附加預設的 Via 值。 不然的話,會附加指定的字串 Via 值。預設值是空值。

入埠連線 SSL 配置

從下列其中一個來源指定 SSL 配置。

集中管理
選取之後,指定使用這個端點所設範圍的 SSL 配置。
這個端點專用
選取之後,啟用選取 SSL 配置清單。
選取 SSL 配置
指定預先定義的 SSL 配置。
參考資訊
資料類型 String
預設值
範圍 NONE、CellDefaultSSLSettings 或 NodeDefaultSSLSettings

快取

指定是否啟用 Proxy 伺服器來快取伺服器內容。

當選取啟用快取時,會依照 HTTP 1.1 規格所定義來啟用 Proxy 伺服器的靜態內容快取。 依預設會啟用快取內容。

如果有啟用快取,下列內容才適用:
快取實例名稱
指定動態快取物件快取實例,其配置在資源 > 快取實例 > 物件快取實例中,用來快取所有動態與靜態內容回應。 這個物件快取實例必須配置為可支援最新的 I/O (NIO) 應用程式設計介面 (API)。
快取 SSL 內容
針對 Proxy 伺服器所終止的用戶端 Proxy 伺服器 SSL 連線,決定是否應該要快取它們的回應。
攻擊快取
啟用快取 HTTP 回應,但通常並不快取此類回應。如果要取得快取最佳化狀態,可能會破壞 HTTP 1.1 定義的快取規則。
快取動態內容
指定是否要快取 WebSphere Application Servers 6.02 版或更新的版本所產生的動態內容。不支援快取 WebSphere Application Server 6.02 版之前的內容伺服器所產生的動態內容。
限制記憶體快取項目大小
選取之後,會啟用記憶體快取項目大小設定。
記憶體快取項目大小
指定個別快取回應的大小上限 (MB)。 任何快取的回應,只要超出這個大小,便不進行快取。

記載

Proxy 伺服器會產生 Proxy 日誌,其儲存快取要求。當選取啟用存取記載時,您可以指定存取日誌的大小和位置。

存取日誌大小上限
指定存取日誌的大小上限 (MB)。
參考資訊
資料類型 Integer
單位 MB
預設值 500
Proxy 存取日誌
指定 Proxy 存取日誌的目錄位置。
參考資訊
資料類型 String
預設值 ${SERVER_LOG_ROOT}/proxy.log
快取存取日誌
指定快取存取日誌的目錄位置。
參考資訊
資料類型 String
預設值 ${SERVER_LOG_ROOT}/cache.log
本端存取日誌
指定本端存取日誌的目錄位置。
參考資訊
資料類型 String
預設值 ${SERVER_LOG_ROOT}/local.log
註: 有一個稱為 ${SERVER_LOG_ROOT}/local.log 的日誌用來記載本端提供的 Proxy 內容。 這個內容不在 Proxy 快取中。
HTTP 要求會記載在三個日誌的其中一個:Proxy、快取和本端。 管理主控台目前無法使用本端日誌配置,但您可以在 ${SERVER_LOG_ROOT}/local.log 中找到它。 如果要指定此日誌位置,可以將 http.log.localFileName 自訂內容設為該檔案位置。 每個日誌的內容都是採用 National Center for Supercomputing Applications (NCSA) 的一般日誌格式來建立格式。
  • Proxy 存取日誌 - 記載從遠端伺服器收到的回應。
  • 快取存取日誌 - 記載從本端快取提供的回應。
  • 本端存取日誌:記載所有非快取的本端回應,例如,重新導向和內部錯誤。
可用來調整記載的 Proxy 自訂內容如下所示:
  • key=http.log.disableAll:這個內容會停用所有記載。值為 true 時,會停止 Proxy、快取以及本端記載。
  • key=http.log.maxSize:日誌大小上限,以 MB 為單位。值為 UNLIMITED 表示沒有限制。
  • key=http.log.localFileName:包含本端日誌的名稱。值為 NULL 表示會使用預設值 ${SERVER_LOG_ROOT}/local.log

安全

請利用這個區段來設定安全選項。

使用 Proxy 遮罩伺服器標頭
選取之後,指定將內容伺服器的名稱轉遞給用戶端。
使用後端伺服器標頭
選取之後,指定當作內容伺服器名稱來傳送的預設伺服器名稱。
指定伺服器標頭值
選取之後,會啟用伺服器標頭設定。
伺服器標頭
指定 HTTP 回應中所用的伺服器名稱。
授信安全 Proxy
指定利用 Proxy 伺服器以外的中介程式來處理要求。這項設定識別哪些 Proxy 伺服器是可信的。WebSphere Application Server 外掛程式用戶端會將 私密標頭新增至它們所要轉遞的要求中。為了讓 Proxy 伺服器使用那些標頭,要求必須來自其中一個授信安全 Proxy。如果要求不是來自這其中一個授信安全 Proxy,在 Proxy 伺服器轉遞要求之前,就會忽略那些私密標頭,並從要求移除。請在這個欄位中使用 IP 或完整的主機名稱。如果執行 WebSphere Application Server 外掛程式用戶端的系統上有多個 IP 位址,則授信清單中的值,必須符合該系統出埠連線的 IP 位址。 如果您不知道連線中之外掛程式端所用的 IP 位址,則應將所有 IP 位址指定給該系統,以確定無論指向 Proxy 伺服器的出埠連線中使用哪一個 IP 位址,該 IP 位址必定符合授信清單中的其中一個 IP 位址。
選取啟用安全 Proxy 的勾選框。 按一下新建刪除來新增或移除清單中的 Proxy。
註: 空的授信安全 Proxy 清單(此為預設值)表示 WebSphere Application Server 外掛程式用戶端都未授信。
參考資訊
資料類型 String
預設值 空白
範圍 IP 位址或有效主機名稱

Proxy 外掛程式配置原則

請利用這個區段來配置 Proxy 外掛程式。

產生外掛程式配置
指定產生 Proxy 外掛程式配置檔,供您在部署於 Proxy 伺服器前端的 Web 伺服器上使用這個檔案。 這個外掛程式可以決定 Proxy 代替應用程式伺服器來處理的 URI。 這個外掛程式可以決定端點或 Proxy 的界限,以便將收到的要求適當遞送給 Proxy。
可用來產生下表所說明之外掛程式的選項如下:
範圍 說明
無範圍。
全部 Proxy 伺服器會產生一個外掛程式配置,其中含有本端 Cell 及核心群組橋接器所連接的所有 Cell 中 Proxy 伺服器所處理的所有 URI。
Cell Proxy 伺服器會產生一個外掛程式配置,其中含有 Cell 中的所有 Proxy 伺服器所處理的所有 URI。
節點 包括節點所配置的所有 URI。
伺服器 Proxy 伺服器只會針對目前配置的 Proxy 伺服器來產生外掛程式配置檔。
外掛程式配置變更 Script
指定在產生 WebSphere Application Server 外掛程式配置後執行之 Script 的路徑。

自訂錯誤頁面原則

請利用這個區段來配置要求處理期間,發生錯誤時的錯誤頁面設定。

預設不會產生任何自訂錯誤頁面。
本端錯誤頁面處理
將本端產生的錯誤回應遞送給應用程式。您可以使用兩種方式來處理錯誤,並指定特定錯誤碼的錯誤對映:
  • 處理 Proxy 伺服器產生的錯誤。
  • 處理應用程式伺服器產生的錯誤。
遠端錯誤頁面處理
選取之後,在 Proxy 內容伺服器連線錯誤回應上,會指定處理 Proxy 伺服器產生的 HTTP 回應錯誤狀態碼,以及 Proxy 之後的任何位置所產生的 HTTP 回應錯誤狀態碼。 若未選取,便只會處理 Proxy 伺服器產生的 HTTP 回應錯誤狀態碼。 最理想的作法是在和 Proxy 伺服器相同的實體機器上,配置一支錯誤頁面應用程式。
產生錯誤頁面應用程式 URI
指定如果提供了已安裝應用程式的有效統一資源定址器 (URL),便啟用自訂錯誤頁面原則。 如果未提供指向已安裝應用程式的有效 URI,自訂錯誤頁面原則便不會處理要求。處理錯誤的方式有下列兩種:
  • 將本端產生的錯誤回應遞送給應用程式。
  • 將遠端伺服器的錯誤回應遞送給錯誤頁面產生器應用程式。
轉遞給錯誤頁面應用程式的標頭
指定在用戶端要求中,要當作查詢參數轉遞給錯誤頁面應用程式的其他標頭值。 除了配置的參數之外,也一定會傳送 responseCode 和 URI 兩個查詢參數給錯誤頁面應用程式。 responseCode 參數是內部產生或由內容伺服器傳回的 HTTP 狀態碼。 URI 參數則是用戶端的要求 URI。
範例 - 錯誤頁面 URI 是 /ErrorPageApp/ErrorPage,要轉遞的標頭包含 Host,並且用戶端傳送下列要求:
GET  /house/rooms/kitchen.jpg HTTP/1.1
Host:  homeserver.companyx.com
這個要求會產生 HTTP 404 回應(本端或遠端),傳遞給錯誤頁面應用程式的要求 URI 會是:
/ErrorPageApp/ErrorPage?responseCode=404&uri=/house/rooms/kitchen.jpg&Host= homeserver.companyx.com
要視為錯誤的 HTTP 狀態碼
指定錯誤頁面原則提供的回應所針對的狀態碼。 如果未指定狀態碼,就會傳回含有這個狀態碼之回應的原始內容。 如果未指定任何 HTTP 狀態碼,就會使用預設值 4045XX。 建議您使用下列各項方法來代表狀態碼的範圍,不要個別指定狀態碼:
  • 5XX:500-599
  • 4XX:400-499
  • 3XX:300-399
  • 2XX:200-299

調整自訂錯誤頁面時,要使用的 Proxy 自訂內容:key=http.statuscode.errorPageRedirect。 此自訂內容決定要使用重新導向來產生錯誤頁面,或是使用 Proxy 錯誤頁面應用程式。 有效值為 truefalse。 預設值是 false

靜態檔案提供

指定 Proxy 伺服器執行靜態檔案提供所需要的值。

靜態檔案文件根目錄
指定檔案系統中,靜態文件檔案所在的位置。
參考資訊
資料類型 String
預設值 ${USER_INSTALL_ROOT}/staticContent
內容對映
指定特定副檔名的內容類型對映。 指定下列設定的值。
參考資訊
副檔名 對映至環境定義類型的主體檔副檔名
標頭 傳給用戶端的標頭名稱
在 context-type 標頭中傳給用戶端的標頭值
加權 用來計算這個副檔名之檔案等級的浮點數值

工作量管理

指定 Proxy 伺服器管理工作量所需要的值。

高可用性監視器逾時
指定在高可用性監視器逾時之前的時間量(秒)。
參考資訊
資料類型 String
單位
預設值 300
顧問 URI
指定顧問的統一資源識別碼 (URI)。
參考資訊
資料類型 String
預設值 /
負載平衡演算法
指定 Load Balancer 的演算法。
參考資訊
資料類型 String
預設值 空白


檔名: ujpx_proxy.html