apache mod_proxy_balancer 本身不原生支持 ip_hash，但可通过 mod_remoteip 获取真实ip、mod_rewrite 提取ip、mod_headers 注入 routeid cookie，并配合 stickysession=routeid 实现基于源ip哈希的静态资源访问绑定，确保同一ip始终路由至同一后端节点。
Apache 的 mod_proxy_balancer 本身不原生支持 ip_hash 算法（如 Nginx 那样），但可通过组合模块与合理配置，实现**基于源 IP 哈希的静态资源访问绑定**——即同一客户端 IP 的请求始终落到同一台后端静态服务器，保障缓存一致性、避免重复拉取和 CDN 冗余回源。
确保真实客户端 IP 可被识别
静态资源常经 CDN、Nginx 或云 WAF 转发，原始 IP 会丢失。必须让 Apache 正确提取真实 IP，否则哈希失去意义：
- 启用
mod_remoteip模块（Apache 2.4+ 必需） - 在主配置或虚拟主机中设置：
RemoteIPHeader X-Forwarded-For<br>RemoteIPInternalProxy 10.0.0.0/8 172.16.0.0/12 192.168.0.0/16 127.0.0.1
（根据你实际代理链中的可信内网段调整） - 验证生效：在日志中加入
%{REMOTE_ADDR}e或用echo $_SERVER['REMOTE_ADDR']（PHP）测试是否已为用户真实 IP
配置 Balancer 并启用 IP 基于粘性路由
核心不是“哈希函数”，而是将客户端 IP 映射为稳定 route 标识，并通过 stickysession 强制绑定：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- 定义 balancer，为每个后端成员显式指定
route（建议用简短编号，如route=static1） - 使用
ProxySet stickysession关联 IP 字符串本身（无需后端 Cookie）：<proxy><br> BalancerMember http://192.168.1.20:8080 route=static1<br> BalancerMember http://192.168.1.21:8080 route=static2<br> BalancerMember http://192.168.1.22:8080 route=static3<br> ProxySet lbmethod=byrequests<br> ProxySet stickysession=ROUTEID<br></proxy>
- 关键一步：用
mod_headers+mod_rewrite将真实 IP 注入ROUTEIDCookie（首次请求触发）：<ifmodule mod_rewrite.c><br>RewriteCond %{HTTP:Cookie} !ROUTEID= [NC]<br>RewriteCond %{REMOTE_ADDR} ^([0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3})$<br>RewriteRule .* - [E=CLIENTIP:%1]<br></ifmodule><br><ifmodule mod_headers.c><br>Header always set Set-Cookie "ROUTEID=%{CLIENTIP}e; Path=/; HttpOnly; Max-Age=31536000" env=CLIENTIP<br></ifmodule>这样首次请求后，浏览器会携带ROUTEID=1.2.3.4，Balancer 自动按该值匹配route
静态资源路径单独分离并启用强缓存
绑定只是前提，真正提升性能还需配合静态资源特性优化：
- 仅对静态路径启用该 balancer，例如只代理
/static/、/assets/、/images/等目录，避免干扰动态业务 - 在后端静态服务器（如 Nginx 或独立 Apache）上配置长期缓存头：
Cache-Control: public, max-age=31536000<br>ETag on
- 若前端资源已做内容哈希（如
main.a1b2c3.js），可放心设为 1 年强缓存；未哈希的上传类目录（如/uploads/）则设为较短周期（如 1 天）并启用协商缓存
验证与调试要点
上线前务必确认三点是否闭环：
- 用
curl -H "X-Forwarded-For: 203.0.113.5" http://yourdomain/static/test.jpg模拟不同 IP，检查响应头中Set-Cookie: ROUTEID=...是否一致且对应后端节点 - 查看
balancer-manager页面（需提前放行访问权限），观察各route的请求计数是否呈现“IP 分区”特征——相同 IP 的请求应集中在单个成员上 - 禁用浏览器缓存后多次刷新，用开发者工具 Network 面板确认
ROUTEIDCookie 不变，且响应来自同一后端 IP
