Apache的ProxyPass授命详解
日期：2014-05-17 浏览次数：21130 次
原文地址：http://httpd.apache.org/docs/2.2/mod/mod_proxy.html#proxypass
翻译：ShiningRay
描述：将远程服务器映射到本地服务器的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
?
?
| min | 0 | 到后端服务器的总是打开的链接最小数。 |
| max | 1…n | 允许连接到后端服务器的硬性最大链接数。硬性最大值的默认值为当前MPM中每个进程的线程数量。在Prefork MPM中，该值总是为1，在Worker MPM中，该值受ThreadsPerChild控制。 |
| smax | max | 根据需要最多创建数量为柔性最大值（Soft Maximum），也就是smax的链接。任何超出smax数量的链接都会指定一个生存时间也就是ttl。 |
| acquire | - | 如果设置了该参数，它就会成为等待链接池中空闲链接的最大时间。如果链接池中没有任何空闲链接，那么Apache将会给客户端返回SERVER_BUSY状态。 |
| flushpackets | off | 决定代理模块是否要在接受到每段数据的时候自动冲掉输出缓冲。‘off’表示只有当需要的时候才冲掉，‘on’表示每段数据后都冲，‘auto’表示轮询／等待一段长度为‘flushwait’毫秒的时间后如果没有输入便冲掉。目前该参数仅对AJP有效。 |
| flushwait | 10 | 表示如果‘flushpackets’为‘auto’，在冲掉输出组前等待额外输入的时间，单位毫秒。 |
| keepalive | Off | 该参数应该在你的Apache和后端服务器之间有防火墙的时候时候，因为防火墙有可能会丢弃不活动的链接。该标志将会告诉操作系统在不活动的链接中发送KEEP_ALIVE消息（时间间隔由全局的OS设置决定，一般为120ms），这样避免防火墙丢弃该链接。要启用keepalive可以将该属性设置为On。 |
| lbset | 0 | 对该工作单元所属的负载均衡集群进行设置。负载均衡器会先尝试较小的lbset，然后尝试大的。 |
| ping | 0 | Ping数据告诉Web服务器在对ajp13链接递交请求前发送一个CPING请求。参数为等待CPONG响应的延迟，单位为秒。添加该功能是为了避免挂起和忙碌的Tomcat的一些问题。该功能需要ajp13 的ping/pong支持，已经在Tomcat 3.3.2+、4.1.28+、5.0.13+中实现。它会增加普通操作中的网络流量，有可能是个问题，但是它在集群节点失效或者繁忙的时候减少网络流量。目前该参数只对AJP有效。 |
| loadfactor | 1 | 工作单元负载系数。用于BalancerMember。它是一个1到100之间的数字，用于定义应用于该工作单元的正规化权重负载。 |
| redirect | - | 工作单元的重定向路由（Redirection Route）。该值通常被动态设置用于从集群中安全地移除某个节点。如果被设置了，所有不包含会话ID的请求都会被重定向到有等值route参数的BalancerMember中。 |
| retry | 60 | 线程池工作单元重试的超时时间，以秒为单位。如果到后端服务器的线程池工作单元状态是出错，Apache将不会递交任何请求到该服务器，直到超时结束。这可以令后端服务器关闭进行维护，并稍后上线。如果值为0则表示总是重试错误状态的工作单元不等待任何时间。 |
| route | - | 工作单元的路由，用于负载均衡器中。该路由是附加给会话ID的一个值。 |
| status | - | 用一个字符定义该工作单元的初始状态：‘D’表示禁用，‘S’表示已停止，‘I’表示忽略错误，‘H’表示热备，‘E’表示出错。状态可以通过前置‘+’表示设置或者‘-’表示清楚。这样，‘S-E’表示设置该工作单元为已停止并清除出错标志。 |
| timeout | Timeout | 链接超时时间，单位为秒。如果未设置，那么Apache会一直等到有可用的链接位置。该指令常和max参数一起使用来限制到后端服务器的链接。 |
| ttl | - | 超出smax连接数的非活动链接的生存时间（Time To Live），单位为秒。Apache会关闭在这段时间内没有被用过的所有链接。 |
如果代理的指令类型以balancer://开头那么会创建一个虚拟工作单元，并不直接和后端服务器通讯。它负责对一些“真正”的工作单元进行管理。这种情况下可以给虚拟工作单元添加
