描述：將遠程服務器映射到本地服務器的URL空間
語法：ProxyPass [路徑] !|url [鍵=值 鍵=值 ...]] [nocanon]
上下文： server config, virtual host, directory
狀態：擴展
模 塊：mod_proxy

該指令可以將遠程服務器映射到本地服務器的URL空間；本地的服務器并不是扮演傳統意義上的代理服務器的角色，而是表現為遠程服務器的一個鏡像。此 本地服務器常被成為反向代理（reversed proxy）或者是網關（gateway）。路 徑是指本地虛擬路徑的名字；url指遠程服務器的一個部分URL，不能包含查詢字符串。

注意：在使用ProxyPass指令的時候，ProxyRequests指令通常都應該是關閉的。

假設本地服務器的地址是 http://example.com/ ， 那么

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

將會把對http://example.com/mirror/foo/bar的 本地請求內部轉換成到http://backend.example.com/bar的 代理請求。

其中，!指令當你不想對某個子目錄進行反向代理的時候就有用 了，例如：

ProxyPass /mirror/foo/i !

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

將會把所有的/mirror/foo請求重定向到backend.example.com除了對/mirror/foo/i的請求。

注意：

順序很重要：排除的指令必須在一般的ProxyPass指令 之前。

和Apache 2.1一樣，具備了使用到后端服務器的線程池的能力。使用“鍵=值” 的參數便可調節線程池的分配。硬性最大值（Hard Maximum）的 默認值為當前MPM中每個進程的線程數量。在Prefork MPM中，該值總是為1，在Worker MPM中，該值受ThreadsPerChild控制。

設置min可以決定有多少到后端服務器的鏈接始終打開。根據 需要最多創建數量為柔性最大值（Soft Maximum），也就是smax的 鏈接。任何超出smax數量的鏈接都會指定一個生存時間也就是ttl。Apache不會同時創建超過硬性最大值（或max）數量的到后端服務器的鏈接。

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

如果代理的指令類型以balancer://開頭那么會創建 一個虛擬工作單元，并不直接和后端服務器通訊。它負責對一些“真正”的工作單元進行管理。這種情況下可以給虛擬工作單元添加一系列額外參數。更多關于均衡 器如何工作的信息請查看mod_proxy_balancer。

均衡器設置范例

ProxyPass /special-area http://special.example.com/ smax=5 max=10

ProxyPass / balancer://mycluster stickysession=JSESSIONID|jsessionid nofailover=On

<Proxy balancer://mycluster>

BalancerMember http://1.2.3.4:8009

BalancerMember http://1.2.3.5:8009 smax=10

# 性能較弱的服務器，不要給他發送太多請求

BalancerMember http://1.2.3.6:8009 smax=1 loadfactor=20

</Proxy>

設置一個熱備份，也就是只有當沒有其他成員可用的時候才使用：

ProxyPass / balancer://hotcluster/

<Proxy balancer://hotcluster>

BalancerMember http://1.2.3.4:8009 loadfactor=1

BalancerMember http://1.2.3.5:8009 loadfactor=2

# 以下是熱備份

BalancerMember http://1.2.3.6:8009 status=+H

ProxySet lbmethod=bytraffic </Proxy>

正常情況下，mod_proxy會標準化被ProxyPass的URL。但它可能會和某些后端不兼容，尤其是那些利用了PATH_INFO的。 可選的nocanon關鍵詞可以禁止它，并不動地直接將URL路徑傳遞給后端。注意它可能會影響到后端的安全性，因為它跳過了由代理提供的對常見的基于 URL的攻擊的保護。

當用在<Location>節中的時候， 第一個參數應被忽略，并且本地的路徑將從<Location>取得。

如果你需要更加有彈性的反向代理配置，參見是用[P]標志的RewriteRule指令。