Apache mod_proxy_balancer 生产环境部署实战教程-Apache-PHP中文网

apache mod_proxy_balancer不是开箱即用组件，而是需严格启用mod_proxy、mod_proxy_http、mod_proxy_balancer、mod_slotmem_shm、调度算法模块及mod_status，通过定义集群、proxyset指定算法、balancermember配置节点，并配合proxypass/proxypassreverse路由与头修正的生产级负载均衡方案。

apache mod_proxy_balancer 在生产环境不是“配好就能用”的开箱组件，而是一套需严格校验模块、精细控制状态、兼顾可观测性与安全边界的负载均衡方案。它适合已有 apache 运维体系、重视配置可审计性、需与 .htaccess 或复杂 rewriterule 深度集成的场景。

模块启用：必须全量确认，不能只开 proxy

仅启用 mod_proxy 只能做单点反向代理；要支撑生产级负载均衡，以下模块缺一不可：

mod_proxy：提供连接池、请求转发骨架
mod_proxy_http：处理 HTTP/1.1 协议细节（如 keep-alive 复用、chunked 解包、自动修正 Content-Length）
mod_proxy_balancer：管理集群成员、维护运行时状态、支持故障隔离
mod_slotmem_shm：为 balancer-manager 和算法模块提供共享内存——缺失将导致界面无法打开、bytraffic 等算法失效
mod_lbmethod_byrequests（或 bytraffic / bybusyness）：调度算法必须显式加载，Apache 不内置默认算法
mod_status（推荐）：支撑 /balancer-manager 界面，也是部分算法依赖的状态采集源

验证命令：
Ubuntu/Debian：a2enmod proxy proxy_http proxy_balancer slotmem_shm lbmethod_byrequests status
RHEL/CentOS：检查 /etc/httpd/conf.modules.d/00-proxy.conf 中对应 LoadModule 行未被注释，再执行 httpd -M | grep -E 'proxy|slotmem|lbmethod|status' 确认全部在列。

集群定义：结构清晰、参数务实

集群必须用 <proxy></proxy> 块明确定义，不能只靠 ProxyPass 引用。生产配置建议写在 <ifmodule proxy_balancer_module></ifmodule> 条件块内，避免模块未启用时报错。

典型示例（含关键参数说明）：

<ifmodule proxy_balancer_module><proxy>
    BalancerMember http://10.10.1.10:8080 route=api1 loadfactor=3 ping=5 retry=60 maxattempts=3
    BalancerMember http://10.10.1.11:8080 route=api2 loadfactor=3 ping=5 retry=60 maxattempts=3
    BalancerMember http://10.10.1.12:8080 status=+H  # 热备节点，仅当其他全宕时启用
    ProxySet lbmethod=byrequests
    ProxySet timeout=8
    ProxySet failonstatus=500,502,503,504
  </proxy></ifmodule>

loadfactor：相对权重，数值越大分得请求越多；两节点设相同值即等效轮询
ping=5：每 5 秒主动发 HEAD 探测，早于真实请求发现故障
retry=60：节点失败后，60 秒内不再尝试，避免雪崩
maxattempts=3：单次请求最多重试 3 次（非全局重试次数）
failonstatus：返回指定 HTTP 状态码即标记该节点为故障，比单纯超时更精准

路由与安全：路径映射 + 权限收敛

流量入口必须通过 ProxyPass 显式绑定到集群，且必须配对使用 ProxyPassReverse 修正响应头：

CPA Update - Secure CLI Proxy API Maintenance

安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。

下载

<virtualhost>
  ServerName api.example.com
  SSLEngine on
  # …… SSL 配置省略
<h1>关键：禁止正向代理，防滥用</h1>
<p>ProxyRequests Off</p>
<h1>传递原始 Host，避免后端生成错误跳转链接</h1>
<p>ProxyPreserveHost On</p>
<h1>路径映射：/ → balancer://prod-api/</h1>
<p>ProxyPass / balancer://prod-api/
ProxyPassReverse / balancer://prod-api/</p>
<h1>启用管理界面（仅限内网或白名单IP）</h1>
<p><location>
SetHandler balancer-manager
Require ip 192.168.10.0/24
Require ip 10.10.5.100
</location></p></virtualhost>

ProxyRequests Off 是硬性要求，否则可能沦为开放代理被黑产利用
/balancer-manager 必须限制访问来源，生产环境严禁 Require all granted
若需灰度或蓝绿切换，可定义 balancer://blue 和 balancer://green 两组，仅修改 ProxyPass 目标并执行 apachectl graceful 即可平滑切流

可观测性与排障：从日志到实时状态

生产环境必须建立三层可观测能力：

访问日志增强：在 LogFormat 中加入 %{BALANCER_NAME}e 和 %{BALANCER_ROUTE}e，可追踪每个请求落到哪个节点
实时状态面板：启用 /balancer-manager 后，可查看各节点当前连接数、已处理请求数、权重、健康状态，支持手动启停节点、临时调整权重
错误日志定位：开启 LogLevel proxy:debug（临时）可捕获连接建立、重试、失败原因等细节；日常建议设为 warn 级别平衡性能与信息量

常见问题排查顺序：模块是否全启 → balancer-manager 是否能打开 → 日志中是否有 proxy_balancer: error → 后端服务是否真实可连（用 curl -v http://ip:port 验证）→ ProxyPassReverse 是否遗漏导致跳转异常。