Apache模块 mod_proxy

AllowCONNECT 指令

AllowCONNECT指令指定了此代理的CONNECT方法可以连接的端口号列表。当今的浏览器在进行https连接请求时使用这种方法，而代理默认会将其转为http。在默认情况下，只启用了默认的https端口（443）和默认的snews端口（563）。使用AllowCONNECT指令来覆盖默认设置而改为仅允许连接列出的端口。

NoProxy 指令

此指令仅适用于局域网内的Apache代理服务器。NoProxy指令指定了一个中间以空格分隔的子网、IP地址、主机和/或域的列表。对某个匹配上述一个或多个列表项的主机的请求将直接被其伺服而不会前转到配置好的ProxyRemote代理服务器。

NoProxy指令的主机参数可以为以下选项之一：

域

域是一个DNS域名的一部分，preceded by a period. It represents a list of hosts which logically belong to the same DNS domain or zone (i.e., the suffixes of the hostnames are all ending in Domain).
Examples: .com .apache.org.
To distinguish Domains from Hostnames (both syntactically and semantically; a DNS domain can have a DNS A record, too!), Domains are always written with a leading period.
Note: Domain name comparisons are done without regard to the case, and Domains are always assumed to be anchored in the root of the DNS tree, therefore two domains .MyDomain.com and .mydomain.com. (note the trailing period) are considered equal. Since a domain comparison does not involve a DNS lookup, it is much more efficient than subnet comparison.

子网

子网以数字（点号分隔的四个部分）的形式表示了一个因特 网地址的一部分，有时会跟着一个斜杠和子网掩码， numeric (dotted quad) form, optionally followed by a slash and the netmask, specified as the number of significant bits in the SubNet. It is used to represent a subnet of hosts which can be reached over a common network interface. In the absence of the explicit net mask it is assumed that omitted (or zero valued) trailing digits specify the mask. (In this case, the netmask can only be multiples of 8 bits wide.)
示例：

192.168或192.168.0.0

the subnet 192.168.0.0 with an implied netmask of 16 valid bits (sometimes used in the netmask form 255.255.0.0)

192.168.112.0/21

the subnet 192.168.112.0/21 with a netmask of 21 valid bits (also used in the form 255.255.248.0)

As a degenerate case, a SubNet with 32 valid bits is the equivalent to an IPAddr, while a SubNet with zero valid bits (e.g., 0.0.0.0/0) is the same as the constant _Default_, matching any IP address.

IP地址

IP地址以数字（点号分隔的四个部分）的形式表示了一个完整的因特网地址。一般来说，此地址代表一个主机，但这里不需要一个DNS域名与这个地址对应。
比如说： 192.168.123.7
注意：一个IP地址不需要为一个DNS系统所解析，所以它能使apache获取更高性能。

主机名

主机名是一个完整的DNS域名，可以通过DNS域名服务解析为一个或多个 IP地址。它代表了一个逻辑主机（与域相反，见上）而且必须解析成至少一个IP地址（或经常解析成具有不同IP地址的主机列表）。
示例：prep.ai.mit.edu www.apache.org.
注意：在很多情况下，指定一个IP地址 代替主机名会更有效率。因为可以避免一次DNS查询。 当使用一个低速的PPP与域名服务器连接时，Apache的域名解析会花费相当 可观的时间。
注意：主机名 comparisons are done without regard to the case, and Hostnames are always assumed to be anchored in the root of the DNS tree, therefore two hosts WWW.MyDomain.com and www.mydomain.com. (note the trailing period) are considered equal.

参见

• DNS相关问题

<Proxy> 指令

位于<Proxy>配置段中的指令仅施用于匹配的代理内容。语句中可以使用shell风格的通配符。

比如说：下例将仅允许yournetwork.example.com中的主机通 过您的代理服务器访问代理内容：

下例将在所有example.com的foo目录下的文件通过代理服务器发送之前用INCLUDES过滤器进行处理：

ProxyBlock 指令

ProxyBlock指令指定了一个由空格分隔的语句、主机和/或域的列表。所有对匹配这些语句、主机和/或域的站点的HTTP、HTTPS和FTP文档的请求都将被代理服务器阻断。代理模块亦会在启动时尝试确定列表中可能是主机名的项目对应的IP地址，并将其缓冲用于匹配测试。比如说：

“rocky.wotsamattau.edu”将由于IP地址同样被匹配。

请注意“wotsamattau”已经足够匹配“wotsamattau.edu”了。

请注意

将屏蔽所有站点的连接。

ProxyDomain 指令

此指令仅对位于局域网内的Apache代理服务器有用。ProxyDomain指令指定了apache代理服务器归属的默认域。如果遇到了一个对没有域名的主机的请求，就会自动生成一个对根据配置加上了域的同一主机的重定向回应。

ProxyErrorOverride 指令

此指令用于反向代理设置中您想为最终用户提供观感一致的错误页面时。它也同样允许包含文件（通过 mod_include 的SSI）获取错误号并作出相应行动。（默认行为是显示被代理的服务器的错误页面，将此项目设为on将显示SSI错误信息）。

ProxyIOBufferSize 指令

<ProxyMatch> 指令

<ProxyMatch>与<Proxy>指令基本相同，只是匹配字串可以为正则表达式。

ProxyMaxForwards 指令

ProxyMaxForwards指令指定了同时进行前转的代理请求的最大数目。这个设置是为了避免无限代理循环或DoS攻击的发生。

ProxyPass 指令

指令对于您不想对某个子目录进行反向代理时很有用。比如说：

将会代理除对/mirror/foo/i请求之外的所有对 foo.com 的/mirror/foo请求。

当在<Location>配置段中使用时，第一个参数会被忽略而是采用由<Location>指令指定的本地目录。

如果您需要一个更加灵活的反向代理配置，请参见使用[P]标记的RewriteRule指令。

ProxyPassReverse 指令

此指令使 Apache 调整HTTP重定向回应中Location，Content-Location和URI头里的URL。这就是Apache在作为反向代理使用时，避免以因为位于反向代理之后的后端服务器的HTTP重定向造成的绕过反向代理的实质。

路径是本地虚拟路径的名称。
url远端服务器的部分URL。与ProxyPass指令中的使用方法相同。

示例：
假定本地服务器拥有地址http://wibble.org/；那么

不仅会把所有对<http://wibble.org/mirror/foo/bar>的请求直接转为对 <http://foo.com/bar> 的代理请求，（由ProxyPass提供的功能）。它还会改变服务器foo.com的发送：当http://foo.com/bar被它重定向到http://foo.com/quux时，Apache会在前转HTTP重定向回应到客户端之前调整它为http://wibble.org/mirror/foo/quux。请注意：被选做用于构建URL的主机名与UseCanonicalName指令的设置有关。

请注意，此ProxyPassReverse指令亦可与mod_rewrite的代理穿透特性（"RewriteRule ...[P]"）联用。因为它不依赖于相应的ProxyPass指令。

当在<Location>配置段中使用时，第一个参数会被忽略而是采用由<Location>指令指定的本地目录。

ProxyPreserveHost 指令

当启用时，此选项将把传入请求的Host:行传递给被代理的主机，而不是传递在proxypass行中指定的主机名。

此选项一般为禁用状态。

ProxyReceiveBufferSize 指令

ProxyReceiveBufferSize指令为增加的吞吐量指定了一个明确的向外的HTTP和FTP连接的网络缓冲大小。这个值必须大于512，或设置为0代表使用系统默认的缓冲大小。

ProxyRemote 指令

此指令定义了此代理的远端代理。match可以是远端服务器支持的URL形式的名称，或是远端服务器使用的部分URL，或是'*'以代表服务器可以接受所有的请求。remote-server是远端服务器的部分URL。语法为：

  remote-server = protocol://hostname[:port]

protocol是与远端服务器交换信息时使用的协议；本模块暂时只支持"http"。

举例如下：

在最后一个例子中，代理会将封装到另外一个HTTP代理请求中的FTP请求前转到另外一个能处理它们的代理去。

此选项也支持反向代理配置 - 一个后端web服务器可以被嵌入到一个虚拟主机的URL空间中，哪怕它是由另一个代理前转过来的。

ProxyRemoteMatch 指令

ProxyRemoteMatch与ProxyRemote指令基本相同。除了第一个参数是由一个请求的URL变成了匹配的正则表达式。

ProxyRequests 指令

此指令将允许或禁止Apache作为前转代理服务器的功能。（将ProxyRequests设置为'off'并不会禁用ProxyPass指令。）

在一个典型的反向代理配置中，此可选项一般设置为'off'。

ProxyTimeout 指令

此指令允许用户对代理请求指定一个超时值。当你有一个很慢/错误多多的应用服务器经常挂起，而您宁愿返回一个超时的失败信息也不愿意继续等待不知道多久的时候，这个功能是很有用的。

ProxyVia 指令

此指令控制了代理对于Via:HTTP头的使用。它的使用目的是控制位于一个代理服务器链中的代理请求的流向。参阅 RFC2068 （HTTP/1.1）获得关于Via:头部分的解释。

• 如果设置为默认值off，将不会采取特殊的处理。如果一个请求或回应包含Via:头，它将不进行任何修改的通过。
• 如果设置为on，每个请求和回应都会对应当前主机得到一个Via:头。
• 如果设置为full，每个产生的Via:头行中都会额外加入Apache服务器的版本，以Via:注释域出现。
• 如果设置为block，每个代理请求中的所有Via:头行都将被移除。且不会产生新的Via:头。