Apache 模組 mod_proxy

BalancerGrowth 指令

此指令允許在可供應給虛擬主機的代理負載平衡器數量（預先組態的數量以外）中有成長的可能性。僅當至少預先組態了一個代理負載平衡器時，此指令才會生效。

BalancerInherit 指令

此指令將會導致目前的伺服器/vhost「繼承」主伺服器中定義的針對 ProxyPass 的代理負載平衡器和工作者。若使用代理負載平衡器管理程式，此動作可能會造成問題和行為不一致，因此在使用該功能時，應該禁用此指令。

全域伺服器中的設定值定義所有 vhost 的預設值。

BalancerMember 指令

此指令將成員新增至負載平衡群組中。它可以在 <Proxy balancer://...> 容器指令中使用，並可以使用 ProxyPass 指示可用的任一關鍵值對參數。

只有一個附加參數僅適用於 BalancerMember 指令：loadfactor。這是成員負載係數，介於 1.0（預設值）與 100.0 之間的小數數字，用來定義要套用至相關成員的加權負載。

僅在未包含於 <Proxy balancer://...> 容器指令時，才需要 balancerurl。它與在 ProxyPass 指令中定義的平衡器 URL 相符。

任何 <Proxy balancer://...> 容器指令中，平衡器 URL 的路徑組件都會被忽略。

通常應該從 BalancerMember 的 URL 中移除尾隨斜線。

BalancerPersist 指令

此指令將讓與平衡器和平衡器成員關聯的共用記憶體儲存在重新啟動後仍然存在。如此一來，這些本機變更就不會在正常的重新啟動/正常狀態過渡期間遺失。

NoProxy 指令

此指令僅適用於內部網路中的 Apache httpd 代理伺服器。NoProxy 指令會指定一串子網域、IP 位址、主機和/或網域，並以空格分隔。針對與其中一項或多項相符的主機發出的請求，會直接提供服務，而不會轉發至已設定的 ProxyRemote 代理伺服器。

ProxyRemote  "*"  "http://firewall.example.com:81"
NoProxy         ".example.com" "192.168.112.0/21"

NoProxy 指令中的 host 引數屬於下列型別清單之一

網域

網域 是部分限定的 DNS 網域名稱，前面有句點。它代表一群在邏輯上屬於同一 DNS 網域或區域的主機（即，所有主機名稱的字尾都以 網域 結尾）。

範例

.com .example.org.

為了區分 網域 和 主機名稱（在語法和語義上；DNS 網域也可以有 DNS A 記錄！），網域 通常會寫成前面有句點。

注意

網域名稱比較時不區分大小寫，且Domain預設固定在 DNS 樹狀結構的根節點；因此，.ExAmple.com 和 .example.com.（注意結尾的句點）這兩個網域視為相等。由於網域比較不涉及 DNS 查詢，所以比子網路比較更有效率。

子網路

SubNet 是一種網域名稱，採用數字 (點分十進位數) 格式，並可選擇加上斜線和網路遮罩，規定為SubNet 中的有效位元數。用於表示可透過共用網路介面存取的主機子網路。如果沒有明確指定網路遮罩，則會假設省略 (或為零) 的尾數位元組指定遮罩。(在此情況下，網路遮罩只能為 8 位元的倍數。)範例

192.168 或 192.168.0.0

子網路 192.168.0.0，暗示網路遮罩為 16 個有效位元 (有時會使用 255.255.0.0 的網路遮罩格式)

192.168.112.0/21

子網路 192.168.112.0/21，網路遮罩為 21 個有效位元 (也採用 255.255.248.0 的格式)

極端情況下，具有 32 個有效位元 的SubNet等同於IPAddr，而具有零個有效位元的SubNet (例如，0.0.0.0/0) 則與常數_Default_相同，適用於任何 IP 位址。

IP 位址

IPAddr 表示使用數字 (點分十進位數) 格式的完整網際網路位址。通常，這個位址代表一個主機，但與該位址連結不一定會有 DNS 網域名稱。

範例

192.168.123.7

注意

IPAddr 不需要由 DNS 系統解析，所以可提升 apache 的效能。

主機名稱

Hostname 是一個完整的 DNS 網域名稱，可透過 DNS 網域名稱服務解析為一個或多個IPAddrs。它表示一個邏輯主機 (與Domain不同，如上所述)，而且必須可解析為至少一個IPAddr (或通常是解析為具有不同IPAddr 的主機清單)。

範例

prep.ai.example.edu
www.example.org

注意

在許多情況下，將Hostname指定為IPAddr會更有效率，因為可以避免 DNS 查詢。當與名稱伺服器的連線使用速度較慢的 PPP 連結時，Apache httpd 中的名稱解析會花費相當長的時間。

Hostname 比較時不區分大小寫，且預設會將Hostname固定在 DNS 樹狀結構的根節點；因此，WWW.ExAmple.com 和 www.example.com.（注意結尾的句點）這兩個主機視為相等。

另請參閱

• DNS 問題

<Proxy> 指令

置於 <Proxy> 區段的指令僅適用於符合的代理內容。允許使用 shell 型式的萬用字元。

例如，下列指令只會允許 yournetwork.example.com 中的主機透過您的代理伺服器存取內容

<Proxy "*">
  Require host yournetwork.example.com
</Proxy>

當下列範例中的 foo 目錄中的所有檔案透過代理伺服器傳送時，將使用 INCLUDES 篩選器處理這些檔案

<Proxy "http://example.com/foo/*">
  SetOutputFilter INCLUDES
</Proxy>

另請參閱

• <ProxyMatch>

Proxy100Continue 指令

此指令決定代理伺服器是否應將 100-continue Expect:ation 轉發至原始伺服器，進而讓原始伺服器決定何時/是否讀取 HTTP 要求本體，或是在 Off 狀態下，代理伺服器應自行產生 100 Continue 中間回應再轉發請求本體。

ProxyAddHeaders 指令

此指令決定是否透過 X-Forwarded-For、X-Forwarded-Host 及 X-Forwarded-Server HTTP 標頭將代理相關資訊傳遞至後端伺服器。

ProxyBadHeader 指令

如果 mod_proxy 從原始伺服器接收語法無效的回應標頭列（例如不含冒號），ProxyBadHeader 指令會決定 mod_proxy 的行為。可用參數如下

IsError

中止要求並產生 502 (Bad Gateway) 回應。這是預設行為。

Ignore

將錯誤標頭列視為未傳送。

StartBody

在收到第一個錯誤的標頭行時，完成標頭的讀取，並將其餘部分視為主體。這有助於應對會忘記在標頭與主體間插入空行的後端伺服器錯誤。

ProxyBlock 指令

ProxyBlock 指令指定一個以空格分隔的文字、主機和/或網域清單。代理伺服器會封鎖名稱包含符合的文字、主機或網域的 HTTP、HTTPS 和 FTP 文件要求。代理模組也會在啟動時嘗試找出清單項目（可能是主機名稱）的 IP 位址，並將其快取以進行配對測試。這可能會減慢伺服器的啟動時間。

ProxyBlock "news.example.com" "auctions.example.com" "friends.example.com"

請注意，example 也足以與這些網站中的任何一個配對。

主機也會在被 IP 位址參照時配對。

另請注意

ProxyBlock "*"

會封鎖與所有網站的連線。

ProxyDomain 指令

此指令僅適用於內部網路內的 Apache httpd 代理伺服器。ProxyDomain 指令指定 Apache 代理伺服器所屬的預設網域。若遇到一個沒有網域名稱的主機要求，系統會產生一個重新導向回應，並加上已設定的 網域 附加到相同的主機。

ProxyRemote  "*"  "http://firewall.example.com:81"
NoProxy         ".example.com" "192.168.112.0/21"
ProxyDomain     ".example.com"

ProxyErrorOverride 指令

此指令適用於反向代理設定，您希望在使用者看到的錯誤頁面上擁有相同的外觀和感覺。這也允許包含的文件（透過 mod_include 的 SSI）取得錯誤代碼並採取相應的動作。（預設行為會顯示代理伺服器的錯誤頁面。開啟此選項會顯示 SSI 錯誤訊息。）

此指令不會影響資訊 (1xx)、正常成功 (2xx) 或重新導向 (3xx) 回應的處理。

預設情況下，ProxyErrorOverride 會影響所有代碼介於 400（包含）到 600（不包含）之間的回應。

ProxyErrorOverride  On

若要變更預設行為，您可以指定狀態代碼，以空格分隔。如果您這樣做，所有其他狀態代碼將被忽略。您只能指定被視為錯誤代碼的狀態代碼：介於 400（包含）到 600（不包含）之間。

ProxyErrorOverride  On 403 405 500 501 502 503 504

ProxyIOBufferSize 指令

ProxyIOBufferSize 指令調整用於輸入與輸出之間資料暫存區的內部緩衝區大小。大小必須至少為 512。

在幾乎所有情況下，都不需要變更該值。

若與 AJP 使用，此指令會設定最大 AJP 封包大小（以位元組為單位）。大於 65536 的值會設為 65536。如果您將其變更為預設值，也必須變更 Tomcat 端上 AJP 連接器的 packetSize 屬性！packetSize 屬性僅在 Tomcat 5.5.20+ 和 6.0.2+ 中可用。

通常不需要變更最大封包大小。在傳送憑證或憑證鏈時，已報告預設值有問題。

＜ProxyMatch＞ 指令

＜ProxyMatch＞ 指令與 ＜Proxy＞ 指令相同，差別在於它使用 正規表示法來比對 URL。

從 2.4.8 起，命名的群組和反向參考會被擷取並寫入至環境，對應名稱加上前置詞「MATCH_」並以大寫表示。這允許從 表示式和 mod_rewrite 等模組中參照 URL 的元素。為了避免混淆，已忽略編號（未命名）反向參考。請改用命名群組。

<ProxyMatch "^http://(?<sitename>[^/]+)">
    Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
</ProxyMatch>

另請參閱

• ＜Proxy＞

ProxyMaxForwards 指令

ProxyMaxForwards 指令指定請求可能通過的最大代理數目（如果請求中沒有提供 Max-Forwards 標頭）。可設定此選項以防止無限代理迴圈或 DoS 攻擊。

ProxyMaxForwards 15

請注意，設定 ProxyMaxForwards 違反 HTTP/1.1 協定（RFC2616），這會禁止 Proxy 設定 Max-Forwards（如果 Client 沒有設定）。舊版的 Apache httpd 會始終設定它。負 ProxyMaxForwards 值（包括預設值 -1）會提供相符協定的行為，但可能會讓您暴露於迴圈中。

ProxyPass 指令

此指令允許將遠端伺服器對映到本機伺服器的空間中。本機伺服器不會像傳統意義上的代理伺服器那樣作為代理伺服器，而是看起來是遠端伺服器的鏡像。本機伺服器通常稱為反向代理伺服器或閘道。‹var›路徑‹/var›是本機虛擬路徑的名稱；‹var›網址‹/var›是遠端伺服器的一部分網址，且不能包含查詢字串。

在 2.4.7 及後續版本中，支援使用 Unix Domain Socket，方法是使用一個之前加上 unix:/path/lis.sock| 的目標。例如，要代理 HTTP，並將 UDS 目標設定為 /home/www.socket，則可以使用 unix:/home/www.socket|https://127.0.0.1/whatever/。

當在 <Location> 區段中使用時，第一個參數會被略過，而本機目錄會從 <Location> 取得。在 <LocationMatch> 區段中也會發生相同的情況；但是，ProxyPass 不會 將正規表示法詮釋為正規表示法，因此必須在此情況下改用 ProxyPassMatch。

假設本機伺服器的位址為 http://example.com/；那麼

<Location "/mirror/foo/">
    ProxyPass "http://backend.example.com/"
</Location>

會將本機針對 http://example.com/mirror/foo/bar 的請求在內部轉換為對 http://backend.example.com/bar 的代理請求。

如果你需要更彈性的反向代理組態，請參閱具有 [P] 旗標的 RewriteRule 指令。

下列替代語法是可行的；但是，當存在大量替代語法時，可能會造成效能下降。下列語法的優點是它允許透過負載平衡管理員介面進行動態控制。

ProxyPass "/mirror/foo/" "http://backend.example.com/"

! 指令在你不想要反向代理子目錄的情況下很有用，例如

<Location "/mirror/foo/">
    ProxyPass "http://backend.example.com/"
</Location>
<Location "/mirror/foo/i">
    ProxyPass "!"
</Location>

ProxyPass "/mirror/foo/i" "!"
ProxyPass "/mirror/foo" "http://backend.example.com"

將會將所有對 /mirror/foo 的請求代理到 backend.example.com，除了對 /mirror/foo/i 的請求。

在不同內容中混合 ProxyPass 設定不會起作用

ProxyPass "/mirror/foo/i" "!"
<Location "/mirror/foo/">
    ProxyPass "http://backend.example.com/"
</Location>

在這種情況下，傳送給 /mirror/foo/i 的要求將會透過代理傳送，因為 ProxyPass 指令在位置區塊中將會率先評估。ProxyPass 支援伺服器和目錄背景，並沒有表示在組態檔案中的範圍和位置會保證任何順序或覆寫。

ProxyPass key=value 參數

在 Apache HTTP Server 2.1 和後續版本中，mod_proxy 支援後端伺服器的共同連線。可以依據需求建立的連線可以保留在共同連線中，以供未來使用。可以在 ProxyPass 指令上以 key=value 參數編碼共同連線大小和其他設定，這些設定於下列表格中說明。

使用 ttl 參數設定選擇性的到期時間；未使用長達 ttl 秒的連線將會關閉。ttl 可以用來避免使用可能會因為後端伺服器的保活逾時而關閉的連線。

ProxyPass "/example" "http://backend.example.com" max=20 ttl=120 retry=300

ProxyPass "/special%3Fsegment" "https://example.com/special%3Fsegment" mapping=encoded

<Location "/special%3Fsegment">
  Require ip 172.17.2.0/24
</Location>

ProxyPass "/some/path" "https://servlet.example.com/some/path" mapping=servlet

<Location "/some/path">
  Require valid-user
</Location>

如果 Proxy 指令綱要從 balancer:// 開始（例如：balancer://cluster），則任何路徑資訊都會被略過，然後會建立一個實際上不會與後端伺服器通訊的虛擬執行緒。取而代之的是，它負責管理數個「實際」的執行緒。在這種情況下，可以將特殊的一組參數新增到這個虛擬執行緒。請參閱 mod_proxy_balancer 以進一步了解 balancer 的運作方式。

平衡器設定範例

ProxyPass "/special-area" "http://special.example.com" smax=5 max=10
ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofailover=On
<Proxy "balancer://mycluster">
    BalancerMember "ajp://1.2.3.4:8009"
    BalancerMember "ajp://1.2.3.5:8009" loadfactor=20
    # Less powerful server, don't send as many requests there,
    BalancerMember "ajp://1.2.3.6:8009" loadfactor=5
</Proxy>

組態備用伺服器有助於確保每組負載平衡器在任何時候都有一定數量的可用工作執行緒

ProxyPass "/" "balancer://sparecluster/"
<Proxy balancer://sparecluster>
    BalancerMember ajp://1.2.3.4:8009
    BalancerMember ajp://1.2.3.5:8009
    # The servers below are hot spares. For each server above that is unusable
    # (draining, stopped, unreachable, in error state, etc.), one of these spares
    # will be used in its place. Two servers will always be available for a request
    # unless one or more of the spares is also unusable.
    BalancerMember ajp://1.2.3.6:8009 status=+R
    BalancerMember ajp://1.2.3.7:8009 status=+R
</Proxy>

設定熱備用，僅在負載平衡器組中沒有其他成員（或備用伺服器）可用時使用

ProxyPass "/" "balancer://hotcluster/"
<Proxy "balancer://hotcluster">
    BalancerMember "ajp://1.2.3.4:8009" loadfactor=1
    BalancerMember "ajp://1.2.3.5:8009" loadfactor=2.25
    # The server below is on hot standby
    BalancerMember "ajp://1.2.3.6:8009" status=+H
    ProxySet lbmethod=bytraffic
</Proxy>

其他 ProxyPass 關鍵字

通常，mod_proxy 會將 ProxyPassed URL正規化。但這可能與部分後端不相容，特別是那些使用 PATH_INFO 的後端。可選擇的 nocanon 關鍵字會抑制此行為，並向後端傳遞「未處理」的 URL 路徑。請注意，這個關鍵字可能會影響後端的安全性，因為它移除 proxy 所提供的針對基於 URL 的攻擊的正常限制性保護。

通常，mod_proxy 在產生 SCRIPT_FILENAME 環境變數時會包含查詢字串。可選擇的 noquery 關鍵字（於 httpd 2.4.1 及更新版本中提供）可防止此行為。

選項的interpolate 關鍵字與 ProxyPassInterpolateEnv 相結合，導致 ProxyPass 參照環境變數，使用語法 ${VARNAME}。請注意在這個參照發生時，許多標準的 CGI 派生的環境變數將不存在，因此你可能仍需要訴諸 mod_rewrite 以進行複雜的規則。另請注意，僅透過在指令分析時可用的變數（例如 Define）來支援 URL 中的 scheme/hostname/port 部分的參照。利用 mod_rewrite 可以動態決定這些欄位。以下範例說明如何使用 mod_rewrite 動態設定 scheme 為 http 或 https

RewriteEngine On

RewriteCond "%{HTTPS}" =off
RewriteRule "." "-" [E=protocol:http]
RewriteCond "%{HTTPS}" =on
RewriteRule "." "-" [E=protocol:https]

RewriteRule "^/mirror/foo/(.*)" "%{ENV:protocol}://backend.example.com/$1" [P]
ProxyPassReverse  "/mirror/foo/" "http://backend.example.com/"
ProxyPassReverse  "/mirror/foo/" "https://backend.example.com/"

ProxyPassInherit 指令

此指令將導致目前的伺服器/vhost「繼承」在主伺服器中定義的 ProxyPass 指令。如果使用 Balancer Manager 進行動態變更，此舉可能會導致問題和不一致的行為，因此建議在使用此功能時將其停用。

全域伺服器中的設定值定義所有 vhost 的預設值。

停用 ProxyPassInherit 也會停用 BalancerInherit。

ProxyPassInterpolateEnv 指令

此指令，與 interpolate 引數一起用於 ProxyPass、ProxyPassReverse、ProxyPassReverseCookieDomain 和 ProxyPassReverseCookiePath，讓反向代理伺服器可以使用環境變數進行動態配置，而這些變數可以由另一個模組設定，例如 mod_rewrite。它會影響 ProxyPass、ProxyPassReverse、ProxyPassReverseCookieDomain 和 ProxyPassReverseCookiePath 指令，如果設定 interpolate 選項，會讓這些指令替換組態指令中字串 ${varname} 為環境變數 varname 的值。

ProxyPass 的程式/主機名稱/連接埠部分可能包含變數，但僅限於在解析指令時可用的變數（例如，使用 Define）。對於所有其他使用案例，請考慮改用 mod_rewrite。

ProxyPassMatch 指令

此指令相當於 ProxyPass，但使用正規表示式代替簡單的前置比對。提供的正規表示式會對 url 進行比對，如果比對成功，伺服器會將任何括弧內的比對內容替換至指定的字串中，並將其用為新的 url。

假設本機伺服器的位址為 http://example.com/；那麼

ProxyPassMatch "^/(.*\.gif)$" "http://backend.example.com/$1"

會將本機對 http://example.com/foo/bar.gif 的要求在內部轉換為對 http://backend.example.com/foo/bar.gif 的代理要求。

在不希望對子目錄進行反向代理的情況下，！ 指令會很有用。

在 <LocationMatch> 區段內使用時，第一個引數會省略，正規表示式會從 <LocationMatch> 取得。

如果你需要更彈性的反向代理組態，請參閱具有 [P] 旗標的 RewriteRule 指令。

ProxyPassReverse 指令

這項指令允許 Apache httpd 調整 HTTP 重新導向回應上的 Location、Content-Location 和 URI 標頭中的 URL。當使用 Apache httpd 做為反向代理伺服器（或閘道器）時，這非常重要，可以避免因為反向代理伺服器後方的後端伺服器上的 HTTP 重新導向，而繞過反向代理伺服器。

只有特別提到上述的 HTTP 回應標頭會被改寫。Apache httpd 既不會改寫其他的回應標頭，也不會預設改寫 HTML 頁面內的 URL 參照。這表示如果被代理內容包含絕對 URL 參照，他們會繞過代理伺服器。若要改寫 HTML 內容以符合代理伺服器，您必須載入並啟用 mod_proxy_html。

path 是本機虛擬路徑的名稱；url 是遠端伺服器的部分 URL。這些參數的用法與 ProxyPass 指令相同。

例如，假設本機伺服器有位址 http://example.com/，那麼

ProxyPass         "/mirror/foo/" "http://backend.example.com/"
ProxyPassReverse  "/mirror/foo/" "http://backend.example.com/"
ProxyPassReverseCookieDomain  "backend.example.com"  "public.example.com"
ProxyPassReverseCookiePath  "/"  "/mirror/foo/"

不只會將 http://example.com/mirror/foo/bar 的區域要求，內部轉換成對 http://backend.example.com/bar 的代理要求（這正是 ProxyPass 指令在此擔任的功能）。它還會處理伺服器 backend.example.com 在將 http://backend.example.com/bar 重新導向到 http://backend.example.com/quux 時發送的重新導向。Apache httpd 會將此調整為 http://example.com/mirror/foo/quux，然後再將 HTTP 重新導向回應傳送給用戶端。請注意，用於建構 URL 的主機名稱，是根據 UseCanonicalName 指令的設定來選擇的。

請注意，此 ProxyPassReverse 指令也可以與 mod_rewrite 的代理功能 (RewriteRule ... [P]) 聯合使用，因為它不依賴於對應的 ProxyPass 指令。

選用的 interpolate 關鍵字和 ProxyPassInterpolateEnv 搭配使用時，可插入使用 ${VARNAME} 格式指定的环境變數。請注意，一個 URL 的 scheme 部份不支援插入。

當在 <Location> 區段內使用時，會省略第一個引數，本機目錄會從 <Location> 取得。在 <LocationMatch> 區段內也會發生相同情況，但可能會無法如預期般運作，因為 ProxyPassReverse 會照字面解釋 regexp 為路徑；如有需要，可在區段外，或是獨立的 <Location> 區段內指定 ProxyPassReverse。

此指令不支援 <Directory> 或 <Files> 區段。

ProxyPassReverseCookieDomain 指令

用法基本上類似於 ProxyPassReverse，但它並非改寫 URL 標頭，而是改寫 Set-Cookie 標頭內的 domain 字串。

ProxyPassReverseCookiePath 指令

與 ProxyPassReverse 指令配合使用，適用於反向代理中，後端網址路徑對應到公開路徑的情況。此指令會改寫 Set-Cookie 標頭中的 path 字串。如果 cookie 路徑開頭與 internal-path 相符，cookie 路徑就會替換為 public-path。

使用 ProxyPassReverse 的範例中，指令

ProxyPassReverseCookiePath  "/"  "/mirror/foo/"

會將後端路徑為 /（或 /example，任何路徑都可以）的 cookie 改寫為 /mirror/foo/。

ProxyPreserveHost 指令

如果啟用此選項，會將傳入要求中的 Host: 列傳遞給受代理的主機，而非傳遞在 ProxyPass 列指定的主機名稱。

此選項通常應設為 關閉。它多半適用於特殊設定，例如代理大量基於名稱的虛擬主機，後端伺服器需要評估原始 Host 標頭。

ProxyReceiveBufferSize 指令

ProxyReceiveBufferSize 指令指定代理 HTTP 和 FTP 連線的明確（TCP/IP）網路緩衝區大小，以提高傳輸量。它必須大於 512 或是設為 0，表示應使用系統的預設緩衝區大小。

ProxyReceiveBufferSize 2048

ProxyRemote 指令

這會定義此代理伺服器的遠端代理伺服器。match 可能是遠端伺服器支援的 URL 範本名稱，或是應使用遠端伺服器的部分 URL，或是 * 表示伺服器應聯絡所有要求。 remote-server 是遠端伺服器的部分 URL。語法

scheme 實際上就是應使用來與遠端伺服器溝通的通訊協定；此模組僅支援 http 和 https。使用 https 時，會使用 HTTP CONNECT 方法傳送要求到遠端代理伺服器。

ProxyRemote "http://goodguys.example.com/" "http://mirrorguys.example.com:8000"
ProxyRemote "*" "http://cleverproxy.localdomain"
ProxyRemote "ftp" "http://ftpproxy.mydomain:8080"

在最後一個範例中，代理伺服器會將 FTP 要求封裝成另一個 HTTP 代理伺服器要求，然後轉送至可以處理這些要求的另一個代理伺服器。

這個選項也支援反向代理設定；線上伺服器可以內嵌在 virtualhost URL 空間中，即使該伺服器被另一個轉發代理伺服器所隱藏。

可以提供一個選用的第三個引數 username:password，用於定義傳遞給已設定遠端代理伺服器時的基本認證資格。資格將會永遠傳送，不會先等待遠端代理伺服器傳送基本認證質詢。如果使用這個引數，Proxy-Chain-Auth 環境變數將沒有效果。

ProxyRemoteMatch 指令

ProxyRemoteMatch 指令和 ProxyRemote 指令相同，不同之處在於第一個引數是請求 URL 的 正規表示式 相符。

ProxyRequests 指令

這能允許或禁止 Apache httpd 當成順向代理伺服器運作。（將 ProxyRequests 設定為 Off 並不會停用 ProxyPass 指令。）

在典型的反向代理伺服器或閘道設定中，這個選項應該設定為 Off。

若要取得代理 HTTP 或 FTP 網站的功能，伺服器中還需要 mod_proxy_http 或 mod_proxy_ftp（或兩者兼具）。

若要取得代理 HTTPS 網站的功能（順向），伺服器需要啟用 mod_proxy_connect。

另請參閱

• 順向和反向代理伺服器/閘道

ProxySet 指令

這個指令用於當成替用方法，來設定 Proxy 平衡器和工作人員所提供的任何參數，這些參數通常會透過 ProxyPass 指令來設定。如果在 <Proxy balancer url|worker url> 容器指令內使用，則不需要 url 引數。當成副作用，會建立相對應的平衡器或工作人員。當通過 RewriteRule 而不是 ProxyPass 指令來進行反向代理伺服器時，這會很有用。

<Proxy "balancer://hotcluster">
    BalancerMember "http://www2.example.com:8080" loadfactor=1
    BalancerMember "http://www3.example.com:8080" loadfactor=2
    ProxySet lbmethod=bytraffic
</Proxy>

<Proxy "http://backend">
    ProxySet keepalive=On
</Proxy>

ProxySet "balancer://foo" lbmethod=bytraffic timeout=15

ProxySet "ajp://backend:7001" timeout=15

ProxySourceAddress 指令

此指令允許設定特定的本地位址在連線到後端伺服器時綁定。

ProxyStatus 指令

此指令決定是否透過 mod_status 伺服器狀態頁面顯示代理程式負載平衡器狀態資料。

ProxyTimeout 指令

此指令允許使用者在代理程式請求上指定逾時。當您有一個緩慢/有漏洞且會當掉的應用程式伺服器時，這很有用，您可以選擇僅傳回逾時並優雅地失敗，而不用等待伺服器回應花費大量時間。

ProxyVia 指令

此指令控制代理程式使用 Via: HTTP 標頭。其預期用途是控制一串代理伺服器連線中的代理請求流程。請參閱 RFC 2616 (HTTP/1.1) 之第 14.45 段以了解 Via: 標頭行的說明。

• 如果設為 Off (預設值)，則不會執行特殊處理。如果請求或回應包含 Via: 標頭，則會不變地傳遞。
• 如果設為 On，則每個請求和回應都會為目前主機新增 Via: 標頭行。
• 如果設為 Full，則每個產生的 Via: 標頭行都會另外顯示 Apache httpd 伺服器版本，作為 Via: 註解欄位。
• 如果設為 Block，則每個代理請求的所有 Via: 標頭行都會移除。不會產生新的 Via: 標頭。