ThinkPHP 5.1.41 本身不内置 WebSocket 服务，所谓“安装后不连接”，实际是未正确集成或配置 WebSocket 服务端（如 Workerman、Swoole）导致的。问题核心不在 ThinkPHP 框架本身，而在服务监听、网络通路、代理透传和协议握手四个环节。
服务监听地址必须绑定 0.0.0.0
常见错误是服务端只监听 127.0.0.1 或 localhost，导致外部浏览器无法访问：
- 检查 Workerman 或自定义 socket 的监听配置，例如：
websocket://127.0.0.1:2222→ 必须改为websocket://0.0.0.0:2222 - 确认 PHP 进程运行在能被公网/局域网访问的网卡上，可用
netstat -tuln | grep :2222验证是否监听在*:2222 - 若使用宝塔面板，还需在「安全」中放行对应端口（如 2222），并检查系统防火墙（iptables/firewalld）是否拦截
Nginx 反向代理必须透传升级头
如果通过域名 + Nginx 访问 wss://your.com/ws，Nginx 默认会丢弃 WebSocket 握手关键头，导致 400 或静默断连：
- location 块中必须包含三行（缺一不可）：
proxy_http_version 1.1;<br> proxy_set_header Upgrade $http_upgrade;<br> proxy_set_header Connection "upgrade"; - 禁用缓存：
proxy_cache off;（WebSocket 握手响应不可缓存） - 确保后端 proxy_pass 指向的是真实 WebSocket 服务地址（如
http://127.0.0.1:2222），且该服务已启用 HTTP 兼容握手（非裸 TCP）
客户端 URL 协议与服务端严格匹配
浏览器策略强制要求：HTTPS 页面只能连接 wss://，HTTP 页面只能连接 ws://：
- 页面地址是
https://your.com→ 客户端必须用wss://your.com/ws，且后端需配置有效 TLS 证书（推荐 Let's Encrypt） - 页面地址是
http://localhost→ 可用ws://your-server-ip:2222，但不能混用 HTTPS 页面连 ws:// - URL 路径要和服务端路由一致，例如服务端处理
/ws，客户端就不能写成/websocket
服务端必须完成标准 RFC 6455 握手
ThinkPHP 仅作路由或逻辑组织，不处理底层 WebSocket 协议。若你用原生 socket 实现服务端，必须手动解析 Sec-WebSocket-Key 并返回 101 响应：
立即学习“PHP免费学习笔记（深入）”；
- 收到客户端请求后，提取
Sec-WebSocket-Key头 - 拼接固定 GUID
"258EAFA5-E914-47DA-95CA-C5AB0DC85B11"后 SHA-1 + Base64 编码，生成Sec-WebSocket-Accept - 返回完整响应：
HTTP/1.1 101 Switching Protocols<br> Upgrade: websocket<br> Connection: Upgrade<br> Sec-WebSocket-Accept: xxx==
