XAMPP支持WebSockets：在Apache中配置ProxyPass实现WebSocket转发-php教程-PHP中文网

apache不原生支持websocket，必须启用mod_proxy_wstunnel模块并正确配置proxypass（ws://前缀、路径斜杠一致）、延长timeout/proxytimeout至3600秒，且后端需独立常驻服务，否则握手成功但后续帧丢失或连接秒断。

xampp支持websockets：在apache中配置proxypass实现websocket转发

Apache不原生支持WebSocket，必须启用mod_proxy_wstunnel

直接在XAMPP里改Listen端口或加虚拟主机，无法让new WebSocket("ws://localhost:8080")连上——Apache默认只处理HTTP，根本不解析Upgrade: websocket请求头。浏览器报Error during WebSocket handshake时，99%是模块没启，不是端口没开。

打开XAMPP\apache\conf\httpd.conf，确认这两行已取消注释：

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so

注意：mod_proxy_wstunnel依赖mod_proxy，顺序不能颠倒；改完必须重启Apache，且运行httpd -M | findstr wstunnel（Windows）验证是否加载成功。如果输出为空，配置无效。

ProxyPass路径和协议写错，握手成功但后续帧全丢

常见错误是把ws://写成http://，或者路径末尾斜杠不一致。比如后端监听ws://127.0.0.1:8081/ws/，前端连ws://localhost/ws/，那ProxyPass必须严格匹配：

✅ 正确：ProxyPass /ws/ ws://127.0.0.1:8081/ws/
❌ 错误：ProxyPass /ws/ http://127.0.0.1:8081/ws/（走HTTP代理，握手后帧被丢）
❌ 错误：ProxyPass /ws ws://127.0.0.1:8081/ws/（少末尾斜杠，子路径404）

同时必须配ProxyPassReverse /ws/ ws://127.0.0.1:8081/ws/，否则后端重定向返回的Location头仍是内部地址。

超时设置不调高，连接空闲60秒就断

WebSocket是长连接，而Apache默认Timeout和ProxyTimeout都是60秒。哪怕后端心跳正常，Apache也会主动关闭socket，表现就是“突然断开、无错误日志”。

CPA Update - Secure CLI Proxy API Maintenance

安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。

下载

在对应<virtualhost></virtualhost>块内加这两行：

Timeout 3600
ProxyTimeout 3600

两个值必须一致；不要全局修改，只在WebSocket专用站点中覆盖，避免影响其他HTTP接口的响应及时性。

前端URL必须跟ProxyPass前缀对齐，不能直连后端端口

很多人测试时直接用new WebSocket("ws://127.0.0.1:8081/ws/")绕过Apache，能通但上线就崩——因为生产环境域名、HTTPS、Cookie域等都依赖反向代理路径语义。

正确做法是：

Apache配ProxyPass /api/ws/ ws://127.0.0.1:8081/ws/
前端写new WebSocket("ws://localhost/api/ws/")（开发）或wss://yourdomain.com/api/ws/（上线）

最容易被忽略的是：后端服务进程（PHP/Node.js）必须独立启动并常驻，Apache只转发，不运行WebSocket逻辑。关掉终端，连接就断，这点和PHP脚本完全不同。