Apache反向代理转发分布式集群的核心是mod_proxy与mod_proxy_balancer协同实现请求分发与高可用,通过定义balancer://集群、配置BalancerMember节点、设置lbmethod调度算法及stickysession会话粘性,并配合健康检查、真实IP透传和/balancer-manager监控,确保多后端服务稳定协同。

Apache 反向代理转发分布式集群,核心是用 mod_proxy + mod_proxy_balancer 实现请求分发与高可用,不是简单把流量甩给一台后端,而是让多台服务节点(如 Tomcat、Node.js、Spring Boot 实例)组成逻辑集群,由 Apache 统一调度。
启用必要模块
确保以下模块已加载(Linux 常见发行版):
-
proxy_module—— 代理基础功能 -
proxy_http_module—— 支持 HTTP 协议转发 -
proxy_balancer_module—— 提供负载均衡能力 -
lbmethod_byrequests或lbmethod_bytraffic—— 负载算法模块(通常随 balancer 自动启用) -
headers_module(可选)—— 用于传递真实客户端 IP 或修改响应头
Ubuntu/Debian 执行:sudo a2enmod proxy proxy_http proxy_balancer lbmethod_byrequests headers
CentOS/RHEL:确认 /etc/httpd/conf/httpd.conf 中对应 LoadModule 行未被注释。
定义后端集群(balancer)
在 <VirtualHost> 内或独立配置段中声明集群,例如:
<Proxy balancer://myapp>
BalancerMember http://192.168.1.10:8080 route=node1 retry=60 timeout=5
BalancerMember http://192.168.1.11:8080 route=node2 retry=60 timeout=5
BalancerMember http://192.168.1.12:8080 status=+H # 热备节点(H = hot standby)
ProxySet lbmethod=byrequests
ProxySet stickysession=JSESSIONID|PHPSESSID|__session
</Proxy>说明:
Apache Superset 是一个广泛采用的开源 BI 平台,用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时,此技能非常有用。
-
route=nodeX配合后端应用的 session 路由标识(如 Tomcat 的jvmRoute),实现粘性会话 -
status=+H表示该节点不参与轮询,仅当其他节点失效时启用 -
retry=60表示失败后 60 秒内不再尝试该节点;timeout=5是连接超时秒数 -
stickysession后跟 Cookie 名(常见为JSESSIONID、PHPSESSID或自定义名),Apache 自动提取并绑定请求到对应 route
绑定代理路径与集群
将用户请求映射到集群:
ProxyPass / http://localhost:8080/ # ❌ 错误:直接指向单点
ProxyPass / balancer://myapp/ # ✅ 正确:指向集群
同时必须配对使用:
-
ProxyPassReverse / balancer://myapp/—— 重写响应中的Location、Set-Cookie等头,避免重定向跳转到内部地址 - 若后端返回绝对 URL(如
http://192.168.1.10:8080/login),需加ProxyPreserveHost On并配合ProxyPassReverseCookieDomain和ProxyPassReverseCookiePath修正 Cookie 域和路径
增强可用性与可观测性
生产环境建议补充以下配置:
-
健康检查:添加
ping=5(每 5 秒发 HEAD 请求探测)或failonstatus=500,503(返回这些状态码即判为故障) -
访问控制:用
<RequireAll>限制管理界面(如/balancer-manager)仅允许内网 IP 访问 -
监控入口:启用内置管理页:
<Location "/balancer-manager"><br> SetHandler balancer-manager<br> Require ip 10.0.0.0/8<br> </Location> -
真实 IP 透传:后端日志要记录访客真实 IP,需设置:
RequestHeader set X-Forwarded-For "%{REMOTE_ADDR}s"<br> ProxyPreserveHost On
不复杂但容易忽略。关键不在“能不能转”,而在“怎么稳、怎么查、怎么容错”。集群不是堆机器,而是靠 Apache 把流量、状态、故障都管住。

















