ProxyPass性能取决于连接管理、超时控制与模块协同配置，需启用mod_proxy.so等核心模块，严格匹配路径顺序与斜杠，配置keepalive、timeout等参数，并配合后端调优。
ProxyPass 本身只是转发指令，真正影响高并发下性能的，是它背后一整套连接管理、超时控制和模块协同配置。光写一行 ProxyPass /api http://127.0.0.1:8080/api 很容易在流量上来时出现延迟飙升、连接耗尽或后端拒绝服务。
必须启用的模块和基础结构
确保以下模块已加载（在 httpd.conf 或 mods-enabled 中取消注释）：
-
mod_proxy.so—— 代理核心框架 -
mod_proxy_http.so—— 处理 HTTP/HTTPS 后端（漏掉会导致 503） -
mod_proxy_balancer.so—— 若用负载均衡或需要 ping/ttl/retry 等高级参数 -
mod_ssl.so—— 后端为 HTTPS 时必需，并配合SSLProxyEngine on
所有 ProxyPass 规则应放在 <VirtualHost> 块内，且禁用正向代理：ProxyRequests Off。
路径匹配顺序与斜杠一致性
Apache 按配置从上到下匹配，一旦命中就停止。错误顺序会导致规则失效：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- 先写具体路径，再写宽泛路径：比如
/admin/api/→/api/→/ - ProxyPass 和 ProxyPassReverse 的路径末尾斜杠必须严格一致：
ProxyPass /app/ http://backend:8000/，不是/app或/app/对http://backend:8000 - 若后端服务部署在子路径（如 http://backend:8000/myapp），需让后端生成资源链接时带前缀，或用
ProxyPassReverseCookieDomain/ProxyPassReverseCookiePath修正 Cookie 路径
关键性能参数组合写法
单个后端直连场景（如 Tomcat）：
<Proxy "http://127.0.0.1:8080">
ProxySet keepalive=On keepalive_timeout=5 max=50 acquire=3000
ProxySet connectiontimeout=3 timeout=15
</Proxy>
ProxyPass /api/ http://127.0.0.1:8080/api/ keepalive=On
ProxyPassReverse /api/ http://127.0.0.1:8080/api/
-
keepalive=On开启后端连接复用（减少 TCP 建连开销） -
keepalive_timeout=5表示空闲连接最多保留 5 秒，应 ≤ 后端connectionTimeout（如 Tomcat 默认 20000ms） -
connectiontimeout=3控制建连阶段最大等待时间（SYN→SYN-ACK），只在<Proxy>块中生效 -
timeout=15是整个代理生命周期上限（含建连、发请求、收响应），避免长尾请求拖垮线程池
负载均衡多节点场景（推荐方式）：
<Proxy "balancer://myapp">
BalancerMember http://192.168.1.10:8080 keepalive=On ttl=30 retry=15 ping=5,HEAD,/health
BalancerMember http://192.168.1.11:8080 keepalive=On ttl=30 retry=15 ping=5,HEAD,/health
ProxySet lbmethod=byrequests maxattempts=2
</Proxy>
ProxyPass /app/ balancer://myapp/ stickysession=JSESSIONID|jsessionid
ProxyPassReverse /app/ balancer://myapp/
-
ttl=30主动关闭空闲连接，防止被防火墙或中间设备静默断连 -
ping=5,HEAD,/health每 5 秒在调度前探测健康接口（需 Apache ≥2.4.33） -
stickysession保证 Java Session 粘性，避免登录态丢失
配套全局与后端协同项
仅配 ProxyPass 不够，还需同步调整：
- 前端 KeepAlive：
KeepAlive On、KeepAliveTimeout 5、MaxKeepAliveRequests 100 - MPM 推荐使用
event（非 prefork 或 worker），更适合高并发长连接 - Tomcat 需启用 NIO 连接器，
maxConnections至少 ≥ Apache 保持的连接数 × 并发请求数 - 务必加
ProxyPreserveHost On，避免 Host 头丢失导致后端路由或证书校验失败 - 透传真实 IP：
RequestHeader set X-Forwarded-For "%{REMOTE_ADDR}s"+ 后端读取该头
