Apache反向代理WebSocket（如Socket.IO）必须启用mod_proxy_wstunnel模块，仅proxy和proxy_http会导致1006异常关闭；需启用三模块、ProxyPass用ws://或wss://前缀、透传Upgrade/Connection头并设ProxyTimeout≥300。
apache 反向代理 websocket（比如 socket.io）必须用 mod_proxy_wstunnel，仅靠 proxy 和 proxy_http 会断连，常见报错是连接关闭（1006 abnormal closure）。关键在协议识别、头部透传和模块启用三者缺一不可。
必须启用的模块
确保以下模块已加载（Ubuntu/Debian 执行）：
sudo a2enmod proxy proxy_http proxy_wstunnel rewrite- Windows 或源码安装需检查
httpd.conf中这三行未被注释：LoadModule proxy_module modules/mod_proxy.soLoadModule proxy_http_module modules/mod_proxy_http.soLoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so - 重启 Apache 后运行
httpd -M | grep proxy，确认输出含proxy_module、proxy_http_module、proxy_wstunnel_module且状态为(shared)
VirtualHost 中的正确 ProxyPass 配置
Socket.IO 默认使用 /socket.io/ 路径，并支持 WebSocket 升级。配置要满足两点：路径匹配 + 协议前缀明确为 ws:// 或 wss://：
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 不要写成
ProxyPass /socket.io/ http://localhost:3000/socket.io/—— 这走 HTTP 代理，无法处理 Upgrade 请求 - 应写成：
ProxyPass /socket.io/ ws://localhost:3000/socket.io/ProxyPassReverse /socket.io/ ws://localhost:3000/socket.io/ - 若前端访问的是
wss://example.com，后端是https://+ WebSocket 支持，则用wss://前缀，并确保已启用mod_ssl和 SSLProxy* 指令
防止连接中断的关键补充项
Socket.IO 客户端可能 fallback 到轮询（polling），但 WebSocket 升级失败时仍会报 1006。以下配置可提升稳定性：
- 添加
RewriteEngine On和升级头透传规则（尤其当客户端带Upgrade: websocket）：RewriteCond %{HTTP:Upgrade} =websocket [NC]RewriteRule /(.*) ws://localhost:3000/$1 [P,L] - 禁用响应缓冲（避免 Apache 缓存 Upgrade 响应）：
SetEnv nokeepalive 1SetEnv downgrade-1.0 1SetEnv force-response-1.0 1 - 设置超时更宽松（默认 60 秒不够）：
ProxyTimeout 300
验证与调试建议
启用详细日志快速定位问题：
- 在 VirtualHost 内加：
LogLevel info proxy:trace5 - 查看 error.log，重点搜
upgrade、websocket、101 Switching Protocols - 浏览器开发者工具 Network 标签中，WebSocket 连接状态应为
101 Switching Protocols，而非200或直接失败 - Socket.IO 客户端初始化时显式指定 transport：
io({transports: ['websocket']})可跳过 polling 阶段，便于测试纯 WebSocket 路径
