apache反向代理需精准启用对应协议模块：http/https用mod_proxy_http.so，ajp用mod_proxy_ajp.so，websocket用mod_proxy_wstunnel.so；通过balancer://统一抽象路由，校准host、x-forwarded-*等头及超时参数，避免协议语义干预。
Apache 集群本身不解析后端协议，它只负责按规则转发请求；所谓“协议解析兼容”问题，本质是 Apache 作为反向代理时，对不同协议后端（HTTP、AJP、WebSocket 等）的封装、头信息传递和连接行为是否匹配后端预期。解决关键在于模块启用精准、balancer 抽象统一、头与超时配置对齐。
确保对应协议模块全部显式加载
缺一不可——仅启 mod_proxy.so 不足以代理任何具体协议：
-
HTTP/HTTPS 后端（如 Node.js、Go API、Spring Boot）：必须启用
mod_proxy_http.so -
AJP 后端（如 Tomcat）：必须启用
mod_proxy_ajp.so；AJP 是二进制协议，比 HTTP 更轻量，但需 Tomcat 的 AJP Connector（默认端口 8009）配合 -
WebSocket 后端（如 Socket.IO、Spring WebSocket）：Apache ≥2.4.5 时需
mod_proxy_wstunnel.so，且 ProxyPass 必须用ws://或wss://协议前缀 - 验证方式：
apachectl -M | grep proxy应列出所有已启用的 proxy_* 模块，状态为shared
用 balancer:// 封装不同协议，实现路由抽象一致
不要混写不同协议成员在同一
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
-
balancer://http-api：只含http://成员，用于 /api/ 路径 -
balancer://tomcat-jsp：只含ajp://成员，用于 /jsp/ 或 /admin/ 路径 - 路由由
ProxyPass控制，例如：ProxyPass /api/ balancer://http-api/api/ retry=5ProxyPass /jsp/ balancer://tomcat-jsp/ retry=10 - 这样客户端始终访问同一域名和路径，完全无感后端协议差异
校准关键头信息与连接参数
不同后端对 Host、X-Forwarded-*、Connection 头及超时敏感度不同，需针对性配置：
-
ProxyPreserveHost On：让后端收到原始 Host 头，避免 Spring Boot 重定向出错或 CORS 判定失败 - AJP 后端通常依赖
RemoteAddr和SSL_*头做鉴权，需配合ProxyAddHeaders Off+ 手动RequestHeader set注入真实 IP 和协议 - WebSocket 必须透传升级头：
ProxySet keepalive=On+ 显式允许：RequestHeader set Connection "upgrade"、RequestHeader set Upgrade "websocket" - 为不同协议组设置合理超时：
ProxySet timeout=30（HTTP）、ProxySet retry=60（AJP 故障恢复周期更长）
避免 Apache 层介入协议语义处理
Apache 不应尝试“理解”后端业务协议（比如解析 JSON、校验 JWT、改写 Cookie Path），这类逻辑应交由后端或专用网关（如 Kong、Traefik）处理：
- 禁用
mod_cache对动态接口缓存（除非明确知道响应无用户态） - 不使用
ProxyHTMLURLMap或mod_substitute修改后端返回的 HTML/JS 内容——这会破坏签名、破坏 WebSocket 连接、引发 MIME 类型错乱 - 若需统一鉴权或限流，建议前置一层轻量 API 网关，而非在 Apache 中拼凑逻辑
