Apache需显式加载mod_proxy_http.so、mod_proxy_ajp.so等子模块，通过balancer://逻辑地址统一调度HTTP、AJP、WebSocket等协议后端，并按路径精准路由，各协议组须独立定义且差异化配置头信息与超时参数。
Apache 本身不自动识别或“适配”后端应用协议，必须通过显式加载对应模块、分组定义和精准路由来实现多协议共存。核心是把 HTTP、AJP、WebSocket 等不同协议的后端，统一抽象为 balancer:// 逻辑地址，再由 ProxyPass 按路径调度，而非让 Apache 去“理解”协议语义。
启用并加载对应协议代理模块
只加载 mod_proxy.so 不够，每种协议需单独启用子模块：
-
mod_proxy_http.so：代理 HTTP/HTTPS 后端（如 Node.js、Go、Spring Boot） -
mod_proxy_ajp.so：代理 Tomcat 等 AJP 后端（需 Tomcat 开启 AJP Connector，默认端口 8009） -
mod_proxy_wstunnel.so（Apache ≥2.4.5）：代理 WebSocket，且ProxyPass必须用ws://或wss://前缀 -
mod_proxy_fcgi.so：代理 PHP-FPM（FastCGI），配合SetHandler使用
在 httpd.conf 或独立配置文件中确认已加载，例如：
LoadModule proxy_module modules/mod_proxy.so
</IfModule>
<IfModule !proxy_http_module>
LoadModule proxy_http_module modules/mod_proxy_http.so
</IfModule>
<IfModule !proxy_ajp_module>
LoadModule proxy_ajp_module modules/mod_proxy_ajp.so
</IfModule>
为每类协议单独定义 balancer 组
不同协议不能混在同一 <Proxy> 块中；每个组仅含同协议成员，但可复用负载策略：
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
-
balancer://http-api：只包含http://10.0.1.10:3000类成员，用于/api/ -
balancer://tomcat-app：只包含ajp://10.0.1.20:8009成员，用于/admin/ -
balancer://ws-chat：只包含ws://10.0.1.30:8080/chat成员，用于/ws/
示例配置：
<Proxy balancer://http-api>BalancerMember http://10.0.1.10:3000 retry=5 timeout=30
</Proxy>
<Proxy balancer://tomcat-app>
BalancerMember ajp://10.0.1.20:8009 retry=10 max=50
</Proxy>
ProxyPass /api/ balancer://http-api/api/
ProxyPass /admin/ balancer://tomcat-app/
ProxyPass /ws/ balancer://ws-chat/
校准头信息与连接行为
不同协议后端对请求头、超时、连接复用敏感度不同，需差异化设置：
- 开启
ProxyPreserveHost On：确保后端收到原始 Host，避免重定向或 CORS 错误 - AJP 后端依赖
RemoteAddr和SSL_*头做鉴权，建议ProxyAddHeaders Off+ 手动注入真实 IP：RequestHeader set X-Real-IP "%{REMOTE_ADDR}e" - WebSocket 必须透传升级头：
RequestHeader set Connection "upgrade"和RequestHeader set Upgrade "websocket" - 为各 balancer 组设独立超时：
ProxySet timeout=30（HTTP）、ProxySet retry=60（AJP 故障恢复周期更长）
验证与调试要点
配置完成后，用以下方式快速确认是否生效：
- 运行
apachectl -M | grep proxy，输出应含proxy_module (shared)、proxy_http_module (shared)等，状态为shared - 访问对应路径，检查响应头中的
X-Powered-By或服务标识，确认流量确实打到目标后端 - 查看 Apache error log，重点排查
proxy: No protocol handler was valid（模块未加载）或connection refused（后端未监听） - WebSocket 连接失败时，检查浏览器开发者工具 Network 面板是否返回 400 或 500，常见原因是
Upgrade头未透传或后端未启用 ws 支持
