HTTP Proxy 伺服器自訂內容

您可以新增下列自訂內容到 HTTP Proxy 伺服器的配置設定中。

如果要指定特定 HTTP Proxy 伺服器的自訂內容,請導覽至自訂內容頁面,然後指定自訂內容值。

  1. 在管理主控台中,展開伺服器 > 伺服器類型 > WebSphere Proxy 伺服器 > proxy_server_name,開啟伺服器的配置標籤。
  2. 展開 HTTP Proxy 伺服器設定,按一下 Proxy 設定
  3. 其他內容之下,按一下自訂內容 > 新建
  4. 在設定頁面中,在名稱欄位輸入要配置的自訂內容,在欄位輸入自訂內容的值。
  5. 按一下套用確定
  6. 按一下主控台工作列中的儲存,儲存配置變更。
  7. 重新啟動伺服器。

cache.ignore.header.Authorization

指定如果您將這個自訂內容設為 true,則 Proxy 會忽略要求中的 Authorization 標頭。如果也能快取回應,Proxy 將快取回應。

資訊
資料類型 布林
預設值 false

cache.ignore.header.Cookie

指定如果您將這個自訂內容設為 true,則 Proxy 會忽略要求中的 Cookie 標頭。如果也能快取回應,Proxy 將快取回應。

資訊
資料類型 布林
預設值 false

cache.ignore.header.Proxy-Authorization

指定如果您將這個自訂內容設為 true,則 Proxy 會忽略要求中的 Proxy-Authorization 標頭。如果也能快取回應,Proxy 將快取回應。

資訊
資料類型 布林
預設值 false

cache.query.string

指定預設 Proxy 快取金鑰產生器是否同時使用 URL 路徑和查詢字串資訊,來產生快取金鑰。如果要啟用這項功能,請將自訂內容設為 true。不過,如果您在 Proxy 伺服器上啟用 Edge Side Include (ESI) 快取,就不會使用這個自訂內容。如果您未設定這個自訂內容,Proxy 伺服器在產生快取金鑰時,只會根據 URL 路徑,而不會根據查詢字串資訊。

如需 ESI 快取的相關資訊,請參閱「配置 Edge Side Include 快取」。

資訊
資料類型 字串

http.auto.redirect.correction

指定當通用伺服器叢集傳回 302 回應時,Proxy 伺服器是否應嘗試更正位置標頭中的值。

如果您將這個內容指定為 none,當傳回 302 回應時,Proxy 伺服器永不嘗試更正位置標頭中的值。

如果您將這個內容指定為 gsc,唯有當通用伺服器叢集傳回 302 回應時,Proxy 伺服器才會嘗試更正位置標頭中的值。

如果您將這個內容指定為 managed,唯有當受管理伺服器叢集傳回 302 回應時,Proxy 伺服器才會嘗試更正位置標頭中的值。

如果您將這個內容指定為 all,只要傳回 302 回應,Proxy 伺服器就會嘗試更正位置標頭中的值。

避免困難 避免困難: 接合重新編寫規則會置換指定給這個自訂內容的值。gotcha
資訊
資料類型 字串
可接受的值 nonegscmanagedall
預設值 gsc

http.cache.nocache.headers

指定當 Proxy 伺服器收到回應時,您不想快取的 set-cookie 標頭。依預設,Proxy 伺服器會將 set-cookie 標頭儲存在 Proxy 快取中。如果未設定適當 Cache-Control 標頭資訊,Proxy 伺服器可能會儲存某些與階段作業相關的使用者私密 Cookie。您可以利用這個自訂內容,指定您不想儲存在 Proxy 快取中的 set-cookie 標頭。

資訊
資料類型 以逗點區隔的 HTTP 標頭名稱字串

舉例來說,您可以提供下列值:Set-Cookie,Set-Cookie2。如此一來,Proxy 伺服器不會將 Set-Cookie 和 Set-Cookie2 HTTP 標頭儲存在 Proxy 快取中。

http.clientInfoFromTrustedIntermediary

指定 Proxy 是否應從要求中的 WebSphere Application Server 私密標頭擷取 IP 位址。如果將外掛程式部署在 Proxy 前端,Proxy 伺服器會從通道(而非從外掛程式轉遞來的私密標頭)來擷取用戶端 IP 位址。如果這個內容設為 true,Proxy 伺服器會從授信外掛程式傳來的私密 HTTP 標頭,而不是從通道,來擷取用戶端資訊。

資訊
資料類型 字串
預設值 false

http.connectionPoolUseForPOST

指定 Proxy 伺服器對 POST 要求,是否要使用連線儲存區。依預設,POST 要求不會放在儲存區,也不會持續存在。因此,如果經由 Proxy 伺服器傳來太多 POST 要求,可能出現埠耗盡情況,導致連結異常。如果將這個內容設為 true,會對 POST 要求使用連線儲存區。

資訊
資料類型 布林
預設值 false

http.connectRetryLimit

指定在將後端伺服器標示為關閉之前,WebSphere Proxy 伺服器嘗試與該伺服器建立連線的次數。

如果您不將這個自訂內容新增至 WebSphere Proxy 伺服器設定,每當 WebSphere Proxy 伺服器無法建立連線至後端伺服器時,該伺服器都會被標示為關閉,且不會再有其他的要求遞送至該伺服器,直到過了指定給 retryAfterValue 自訂內容的時間量為止 (即使另一個連線嘗試順利完成亦然)。例如,第一次嘗試連線可能會失敗,這是因為太快就重複使用暫時埠,而先前的連線仍處於 TIME_WAIT 狀態。

資訊
資料類型 整數
預設值 0

http.disable.retry.on.503.uriprefix

指定特定的 URI 字首,如此一來,當 Proxy 伺服器傳送起始要求給後端伺服器,並收到 503 回應時,Proxy 伺服器不針對這些 URI 字首,自動重試其他伺服器。

一般而言,當 Proxy 伺服器收到後端伺服器的 503 回應時,會將該後端伺服器標示為正在關閉,並嘗試將要求傳送給另一部伺服器。對於特定 URI 字首,如果您不希望 Proxy 伺服器將後端伺服器標示為關閉並自動嘗試其他伺服器,您可以指定那些字首作為這個自訂內容的值。只要是指定給這個內容的 URI 字首,當 Proxy 伺服器收到後端伺服器對該要求的 503 回應時,Proxy 伺服器就會直接將 503 回應傳回給用戶端,而不重試該要求。Proxy 伺服器也不會將後端伺服器標示為正在關閉。

資訊
資料類型 由以逗點區隔的 URI 字首組成的字串
預設值 無預設值

http.disableresponsebufferingurls

指定 Proxy 伺服器要在哪些情況下,將活動訊號應用程式的回應放在緩衝區中。

此內容的值是一個以逗點區隔的 URL 型樣,例如 /application_a/.*html;/application_b/.*html。舉例來說,如果 Proxy 伺服器收到 /application_a/heartbeat.html 要求,其符合自訂內容的其中一個 URI 型樣,因此 Proxy 伺服器不會將該要求的回應內文放在緩衝區中。在本例中,如果 Proxy 伺服器傳回一個位元組,它會將該位元組轉遞至用戶端而不放在緩衝區。

如果沒有設定這個自訂內容,Proxy 伺服器在收到回應時,會將回應內文放在緩衝區,直到抵達局部回應內文限制為止。

重要: 緩衝處理可能改良 Proxy 伺服器效能,但也可能造成某些活動訊號應用程式的用戶端連線逾時。

http.isDisable10ResponseCaching

指定 Proxy 是否應解除分段,並將 HTTP 1.0 用戶端回應放在緩衝區。

如果將 http.isDisable10ResponseCaching 內容設為 true,Proxy 伺服器不會產生內容長度標頭,並且不會在用戶端回應中包含分段資料。Proxy 伺服器反而關閉回應內文結束標示的連線。

資訊
資料類型 布林
預設值 false

http.log.history

可讓您增加 Proxy 伺服器日誌檔的歷程檔數目。

Proxy 伺服器日誌檔是 proxy.loglocal.logcache.log 檔。如果沒有設定這個自訂內容,這些 Proxy 伺服器日誌檔只會有一個歷程檔。

資訊
資料類型 布林
預設值 1

http.log.history.backup.list

可讓您檢查 Proxy 伺服器 logs 目錄中是否有歷程檔,若有找到,則將它們附加到您建立的任何新日誌檔中。

如果您將 http.log.history.backup.list 自訂內容設為 1,Proxy 伺服器會在 Proxy 伺服器 logs 目錄中搜尋 cache.log、local.log 和 proxy.log 檔的歷程版本。若有找到歷程版本,會附加到您建立的任何新日誌檔中。

如果要讓這個自訂內容生效,必須啟用 HTTP Proxy 伺服器的日誌記載。

資訊
資料類型 布林
預設值 0

http.maxCachedPayload

指定分段回應的大小上限,使 Proxy 伺服器據此產生 content-length 標頭。

當 Proxy 伺服器收到 HTTP 1.0 用戶端的分段回應時,Proxy 伺服器會假設 HTTP 1.0 用戶端無法處理分段訊息,而嘗試解除訊息的分段,並計算回應內文的內容長度。如果分段回應的大小等於或小於指定給這個內容的大小限制,Proxy 伺服器會產生該回應的 content-length 標頭。如果分段回應超過指定給這個內容的大小限制,Proxy 會傳回 500 錯誤訊息。

資訊
資料類型 整數
預設值 100000 個位元組

http.odcUpdateTimeout

指定在伺服器啟動期間,HTTP Proxy 伺服器在遞送資訊之前要等待的秒數。Proxy 伺服器會等過了指定的秒數之後,再連結其埠。

這個自訂內容可用來配置啟動期間的延遲時間(連結 HTTP/HTTPS 埠之前),以便能夠傳播遞送資訊。如果您設為值 300,Proxy 伺服器會等待 300 秒,以便有時間將遞送資訊傳播到 Proxy 伺服器。如果在 300 秒之前,將遞送資訊傳播到 Proxy 伺服器,伺服器就會回復啟動。

資訊
資料類型 字串
預設值 150

http.pmiTimerInterval

指定預估的時間間隔(毫秒),一旦過了此時間,即將 PMI 統計資料記錄在 Proxy 伺服器中。

避免困難 避免困難: 如果指定的值低於預設值 100 毫秒,可能影響 Proxy 伺服器的效能,因為 Proxy 得更頻繁地檢查現行時間。gotcha
資訊
資料類型 整數
預設值 100

http.routing.sendReverseProxyNameInHost

指定對於不在 WebSphere Application Server 內容伺服器上的內容,是否要重新編寫其主機標頭。

這個內容的選項是 truefalse,且不區分大小寫。如果這個內容的值是 false,會將主機標頭重新編寫成目標伺服器的主機。如果這個內容的值是 true,便不會重新編寫主機標頭。

資訊
資料類型 布林
預設值 false

http.virtual.port.map

指定伺服器埠對映資訊,讓後端伺服器用來將回應傳回給正確的外部網站埠。

如果在位於 Proxy 伺服器前端的負載平衡器上配置埠對映資訊,Proxy 伺服器不見得能將正確的外部網站埠資訊轉遞給後端伺服器,這是因為外部網站埠號有可能不同於 Web 伺服器外掛程式埠或 Proxy 伺服器接聽埠。您可以先使用這個自訂內容來更正埠資訊,再讓 Proxy 伺服器將它傳遞給後端伺服器。

舉例來說,如果 Proxy 伺服器或 Web 伺服器外掛程式使用埠 20080 和 20443 來接聽,為 Proxy 伺服器設定下列自訂內容,可讓 Proxy 伺服器提供正確的埠資訊給後端伺服器。之後,後端伺服器就可以傳送回應給正確的外部網站埠。
名稱:    http.virtual.port.map
值:   20080:80;20443:443
資訊
資料類型 埠對映配對字串值,並以分號區隔
預設值

HTTPProxyAdvisorMethodName

指定 HTTP 方法名稱,對所用的方法來說,通常是 HEAD、GET。HTTP 方法名稱也是前端負載平衡器上所設定的顧問方法。這個自訂內容可讓 Proxy 比對送入的要求,判斷要求是否來自負載平衡器。

資訊
資料類型 字串值(HTTP 方法名稱,例如 GET 或 READ)
預設值

HTTPProxyAdvisorStartupDelay

指定「HTTP 顧問」啟動延遲秒數。預設值為 0 秒。

如果有定義自訂內容(LBIPAddr、HTTPProxyAdvisorURI、HTTPProxyAdvisorURI、HTTPProxyAdvisorStartupDelay),當 Proxy 收到要求時,會嘗試拿來與這些自訂內容相比對。
註: 您不需要定義這所有的自訂內容。
如果都符合這所有的自訂內容,會將要求視為來自前端負載平衡器的顧問要求。

如果現行 Proxy 啟動時間少於 HTTPProxyAdvisorStartupDelay 自訂內容所定義的值,Proxy 伺服器會直接傳回 HTTP 503 錯誤碼,讓負載平衡器得知 Proxy/後端伺服器尚未備妥處理 HTTP 要求。

如果現行 Proxy 啟動時間大於 HTTPProxyAdvisorStartupDelay 自訂內容所定義的值,Proxy 伺服器會將顧問要求轉遞給後端,並將回應傳回給前端負載平衡器。前端負載平衡器會根據後端伺服器傳回的狀態碼,來判斷 Proxy/後端伺服器是否已備妥處理要求。

如果 Proxy 正在關閉中,Proxy 伺服器會針對顧問要求,傳回 503 錯誤碼。此錯誤碼會讓負載平衡器得知 Proxy 和後端伺服器無法處理進一步的要求,且前端負載平衡器需要停止傳送要求給這部 Proxy 伺服器。

資訊
資料類型 整數(秒)
預設值 0

HTTPProxyAdvisorURI

指定完整的 URI 字串。這也是前端負載平衡器上所設定的顧問 URI。必須將後端伺服器上的應用程式配置成回答這個要求 URI。這個自訂內容可讓 Proxy 比對送入的要求,判斷要求是否來自負載平衡器。

資訊
資料類型 字串值(完整 URI)
預設值

HTTPProxyAdvisorUserAgent

指定前端負載平衡器的使用者代理程式名稱。這個自訂內容可讓 Proxy 比對送入的要求,判斷要求是否來自負載平衡器。

資訊
資料類型 字串值(HTTP 使用者代理程式的標頭值)
預設值

HTTPSustainedHighVolumeLogging

您可以在 WebSphere Proxy 伺服器 > Proxy 伺服器名稱 > HTTP Proxy 伺服器設定 > Proxy 設定 > 自訂內容畫面上,設定這個自訂內容。

LBIPAddr

指定以分號區隔的 IP 位址清單。這個自訂內容可讓 Proxy 比對送入的要求,判斷要求是否來自負載平衡器。

資訊
資料類型 字串值(以分號區隔的 IP 位址)
預設值

localOutboundTCPAddress

指定專用於 HTTP 資料流量的主機介面。這個內容會判斷當建立指向 HTTP 儲存器的出埠 HTTP 連線時,所要使用的介面。

資訊
資料類型 字串
預設值 *

normalize.redirect.URL

當設為 true 時,會將 Proxy 伺服器重新導向遞送規則中指定的 URI 正規化,並移除尾端斜線 ('/')。如果值是 false,則不變更 URI。預設值是設為 true。


指出主題類型的圖示 參照主題



時間戳記圖示 前次更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjpx_siphttpcustprops
檔名:rjpx_siphttpcustprops.html