Apache代理Socket.IO需启用mod_proxy_wstunnel模块，配置ProxyPassMatch与RewriteRule透传WebSocket升级请求，并协同后端设置transports、客户端指定path，否则将降级轮询或报400/502错误。
apache 要正确代理 socket.io 连接，不能只用普通 http 代理配置，因为 socket.io 默认会尝试多种传输方式（如 polling 和 websocket），而 websocket 协议升级需要显式支持。若不配置妥当，会出现连接中断、频繁重连、400/502 错误或降级为长轮询等问题。
启用必要模块
确保以下模块已加载（在 httpd.conf 或 /etc/apache2/mods-enabled/ 下检查）：
mod_proxymod_proxy_http-
mod_proxy_wstunnel（关键：用于 WebSocket 升级代理） -
mod_headers（可选，但推荐用于设置跨域或请求头）
Linux（Debian/Ubuntu）常用启用命令：a2enmod proxy proxy_http proxy_wstunnel headers
Windows 则需取消 httpd.conf 中对应 LoadModule 行的注释。
配置 VirtualHost 支持 WebSocket 升级
Socket.IO 客户端发起连接时，首次可能是 HTTP POST/GET（polling），后续会发起 Upgrade: websocket 请求。Apache 必须透传该请求并建立隧道：
注意：ProxyPass 不支持直接匹配 ws://，必须用 ProxyPassMatch 或条件路由捕获 upgrade 请求。
示例配置（监听 80 端口，后端 Socket.IO 服务运行在 http://localhost:3000）：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
<VirtualHost *:80>
ServerName your-domain.com
<pre class='brush:php;toolbar:false;'># 允许代理头透传（重要）
ProxyPreserveHost On
ProxyRequests Off
# 处理 WebSocket 升级请求（关键）
ProxyPassMatch ^/socket\.io/(.*)$ http://localhost:3000/socket.io/$1
ProxyPassReverse /socket.io/ http://localhost:3000/socket.io/
# 显式支持 WebSocket Upgrade（Apache ≥ 2.4.10）
RewriteEngine On
RewriteCond %{HTTP:Upgrade} =websocket [NC]
RewriteCond %{HTTP:Connection} =upgrade [NC]
RewriteRule /(.*) "ws://localhost:3000/$1" [P,L]
# 普通 HTTP 请求兜底代理
ProxyPass / http://localhost:3000/
ProxyPassReverse / http://localhost:3000/
# 可选：添加 CORS 头（若前端跨域访问）
Header always set Access-Control-Allow-Origin "*"
Header always set Access-Control-Allow-Methods "GET, POST, OPTIONS"
Header always set Access-Control-Allow-Headers "Content-Type, Authorization"</VirtualHost>
后端与客户端适配要点
仅 Apache 配置还不够，前后端需协同：
-
服务端（如 Node.js + socket.io）：启动时明确指定
transports: ['websocket', 'polling']，并启用allowEIO3: true（兼容旧客户端）；若部署在子路径，需设path: '/socket.io' -
客户端初始化：建议显式指定路径和 transports，避免自动探测失败：
io('https://your-domain.com', { path: '/socket.io', transports: ['websocket', 'polling'] }) -
超时与长连接：Apache 默认空闲超时较短，可在
VirtualHost内添加：ProxyTimeout 60
并确保后端心跳间隔（pingInterval/pingTimeout）小于该值
验证与排错
成功配置后应满足：
- 浏览器开发者工具 Network 标签中，WebSocket 连接状态为
101 Switching Protocols - 连接 URL 类似
ws://your-domain.com/socket.io/?EIO=4&transport=websocket&...</code> - 无
net::ERR_CONNECTION_REFUSED或WebSocket is closed before the connection is established
常见问题排查方向：
– 检查 mod_proxy_wstunnel 是否启用（httpd -M | grep proxy）
– 查看 Apache error_log 是否有 proxy_wstunnel: error upgrading 类报错
– 确认后端服务监听 0.0.0.0:3000（非 127.0.0.1）且防火墙放行
– 若用 HTTPS，确保 SSL 终止在 Apache，并禁用后端强制 HTTPS 重定向
