Apache模块mod_proxy

平衡器增长 指令

除了预配置的数量外，该指令还可以增加虚拟主机可用的均衡器数量的增长潜力。仅在至少有一个预配置的Balancer时才生效。

平衡器继承 指令

该指令将导致当前服务器/虚拟主机“继承”主服务器中定义的ProxyPass平衡器和工作器。如果使用Balancer Manager，这可能会导致问题和不一致的行为，因此，如果使用该功能，应将其禁用。

全局服务器中的设置定义了所有虚拟主机的默认设置。

平衡器成员 指令

该指令将成员添加到负载平衡组。它可以在容器指令中使用，并且可以使用指令可用的任何键值对参数 。<Proxy balancer://...>ProxyPass

另外一个参数仅可用于BalancerMember指令： loadfactor。这是成员负载系数-十进制数字，介于1.0（默认值）和100.0之间，它定义了要施加到相关成员的加权负载。

该balancerurl只需要当不在 容器指令。它对应于指令中定义的平衡器的url 。<Proxy balancer://...>ProxyPass

任何容器指令中的平衡器URL的路径部分都将 被忽略。<Proxy balancer://...>

通常应从的网址中删除斜杠 BalancerMember。

平衡器持久性 指令

该指令将导致与平衡器和平衡器成员相关联的共享内存存储在重新启动后得以保留。这样，在正常的重新启动/正常状态转换期间，这些本地更改不会丢失。

NoProxy 指令

该指令仅对内部网中的Apache httpd代理服务器有用。该NoProxy指令指定的子网，IP地址，主机和/或域的列表，分离由空格。与主机中的一个或多个主机匹配的请求始终直接得到响应，而不会转发到已配置的 ProxyRemote代理服务器。

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

指令的主机参数NoProxy是以下类型列表之一：

域

甲域是部分限定的DNS域名，由一个周期之前。它表示逻辑上属于同一DNS域或区域的主机的列表（即，主机名的后缀均以Domain结尾）。

例子

.com .example.org.

为了区分Domain和Hostname（在语法和语义上； DNS域也可以有DNS A记录！），Domain始终以前置句号编写。

注意

进行域名比较时不考虑大小写，并且 始终假定Domain锚定在DNS树的根中。因此，两个域.ExAmple.com和 .example.com.（注意尾随周期）被认为是相等的。由于域比较不涉及DNS查找，因此它比子网比较有效得多。

子网

阿子网是在数字（点分四组）形式的部分限定的因特网地址，任选地接着斜杠和网络掩码，指定为在显著比特数子网。它用于表示可以通过通用网络接口访问的主机的子网。在没有显式网络掩码的情况下，假定省略（或零值）尾随数字指定掩码。（在这种情况下，网络掩码只能是8位宽的倍数。）示例：

192.168 要么 192.168.0.0

具有16个有效位的隐式网络掩码的子网192.168.0.0（有时以网络掩码形式使用255.255.0.0）

192.168.112.0/21

192.168.112.0/21子网掩码为21个有效位的子网（也以形式使用255.255.248.0）

作为退化情况，一个子网具有32个有效位是相当于一个IPADDR，而子网具有零个有效位（例如，0.0.0.0/0）是一样的恒定 _Default_，匹配的任何IP地址。

IP地址

一个IPADDR代表的数字（点分四组）形式的完全合格的互联网地址。通常，此地址代表一台主机，但不一定需要将DNS域名与该地址连接。

例

192.168.123.7

注意

一个IPADDR并不需要由DNS系统来解决，所以它可能会导致更有效的apache性能。

主机名

一个主机名是一个完全合格的DNS域名，可以被解析为一个或多个IPAddrs通过DNS域名服务。它代表一个逻辑主机（与Domain相比 ，请参见上文），并且必须至少可解析为一个IPAddr（或通常可解析为具有不同IPAddr的主机列表）。

例子

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

注意

在许多情况下，指定IPAddr代替主机名更为有效，因为可以避免DNS查找。当与名称服务器的连接使用慢速PPP链接时，Apache httpd中的名称解析可能会花费大量时间。

主机名比较是在不考虑大小写的情况下进行的，并且始终假定主机名锚定在DNS树的根中。因此，两个主机WWW.ExAmple.com 和www.example.com.（请注意尾随时间段）被视为相等。

也可以看看

• DNS问题

<Proxy> 指令

放在<Proxy> 各节中的指令仅适用于匹配的代理内容。允许使用壳式通配符。

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

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

以下示例将 通过代理服务器发送文件时，处理通过过滤器foo 目录中的所有文件：example.comINCLUDES

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

也可以看看

• <ProxyMatch>

Proxy100Continue 指令

该指令确定代理是否应将100-continue Expect：代理转发 给原始服务器，从而让它决定何时/是否应读取HTTP请求正文，或者Off代理何时应在转发请求之前自行生成100继续中间响应。身体。

ProxyAddHeaders 指令

该指令确定是否应通过X-Forwarded-For，X-Forwarded-Host和X-Forwarded-Server HTTP标头将与代理相关的信息传递给后端服务器。

ProxyBadHeader 指令

该ProxyBadHeader指令确定mod_proxy是否从源服务器接收到语法上无效的响应头行（即，不包含冒号）的行为。以下参数是可能的：

IsError

中止该请求并以502（错误网关）响应结束。这是默认行为。

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_includeSSI）获取错误代码并采取相应措施。（默认行为将显示代理服务器的错误页面。将其打开会显示SSI错误消息。）

该指令不影响信息性（1xx），正常成功（2xx）或重定向（3xx）响应的处理。

ProxyIOBufferSize 指令

该ProxyIOBufferSize指令调整内部缓冲区的大小，该缓冲区用作输入和输出之间数据的暂存器。大小必须至少为512。

在几乎每种情况下，都没有理由更改该值。

如果与AJP一起使用，则此伪指令设置最大AJP数据包大小（以字节为单位）。大于65536的值将设置为65536。如果将其更改为默认值，则还必须packetSize在Tomcat端更改AJP连接器的属性！该属性 packetSize仅在Tomcat 5.5.20+ 和6.0.2+

通常，没有必要更改最大数据包大小。发送证书或证书链时，已报告默认值问题。

<ProxyMatch> 指令

该<ProxyMatch>指令与指令相同<Proxy>，除了它使用正则表达式匹配URL 。

从2.4.8开始，将捕获命名的组和反向引用，并将其以大写的前缀“ MATCH_”的相应名称写入环境。这样可以从表达式和模块（如）中 引用URL的元素mod_rewrite。为了避免混淆，将忽略编号（未命名）的反向引用。请改用命名组。

<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），Max-Forwards如果客户端未进行设置，则该设置将禁止代理设置。早期的Apache httpd版本将始终对其进行设置。负值 ProxyMaxForwards（包括默认值-1）可为您提供符合协议的行为，但可能会导致循环。

ProxyPass 指令

该指令允许将远程服务器映射到本地服务器的空间。本地服务器在常规意义上不充当代理，而似乎是远程服务器的镜像。本地服务器通常称为反向代理或网关。该路径是本地虚拟路径的名称; url是远程服务器的部分URL，不能包含查询字符串。

在2.4.7及更高版本中，可以通过使用prepens目标来支持使用Unix域套接字unix:/path/lis.sock|。例如，要代理HTTP并将UDS定位于/home/www.socket，可以使用 unix:/home/www.socket|http://localhost/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。

如果您需要更灵活的反向代理配置，请参阅RewriteRule带有[P]标志的 指令 。

以下替代语法是可能的；但是，当数量很大时，它可能会降低性能。以下语法的优点是它允许通过Balancer Manager界面进行动态控制 ：

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将对请求进行代理，因为ProxyPassLocation块中的指令将首先被评估。这一事实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