Webman WebSocket服务需按五类方案部署运维：一、常驻进程需启用pcntl等扩展并配置systemd自启；二、Nginx反代须设Upgrade头支持WS协议；三、高并发需Redis Pub/Sub实现多实例广播；四、通过日志与Prometheus暴露连接/消息指标；五、结合ping保活与Redis定时清理僵尸连接。
如果您已完成Webman框架下的WebSocket服务开发，但在生产环境部署或运行过程中出现连接中断、消息丢失、进程异常退出等问题，则可能是由于部署配置不当或运维策略缺失所致。以下是针对Webman WebSocket服务的多种部署方式与对应运维技巧：
一、使用start.php常驻进程部署
该方式适用于中小规模、单机部署场景，依赖Webman内置的Workerman事件循环机制，以PHP CLI模式长期运行服务进程。
1、确保PHP环境已启用pcntl、posix和sysvmsg扩展。
2、在项目根目录执行命令启动服务：php start.php start -d（-d参数表示守护进程模式）。
3、验证进程是否正常运行：ps aux | grep webman，确认存在多个worker进程及master进程。
4、设置systemd服务文件（如/etc/systemd/system/webman-ws.service），定义Restart=always与RestartSec=5，保障进程崩溃后自动拉起。
二、Nginx反向代理WebSocket连接
Nginx作为前置网关可提供SSL终止、负载均衡与连接复用能力，但需显式开启WebSocket升级支持，否则握手将失败。
1、在Nginx配置中添加proxy_http_version 1.1与proxy_set_header Upgrade $http_upgrade指令。
2、配置proxy_set_header Connection "upgrade"，确保Connection头不被过滤。
3、为WebSocket路径（如/ws）单独设置location块，并指向后端Webman监听地址（如http://127.0.0.1:8787）。
4、启用SSL时，客户端必须使用wss://协议，且Nginx需配置有效证书，否则浏览器将拒绝建立连接。
三、多实例+Redis分布式广播部署
当单机连接数超10万或需跨服务器广播消息时，必须解除单点状态依赖，通过Redis Pub/Sub实现节点间消息同步。
1、在config/app.php中启用redis配置，并确保redis.pubsub驱动可用。
WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。
2、修改WebSocket消息分发逻辑，在onMessage中不直接调用$session->send()，而是执行Redis::publish('ws:channel', $payload)。
3、在app/process/RedisSubscriberProcess.php中创建自定义进程，订阅ws:channel并遍历所有在线Session执行广播。
4、各Webman实例共享同一Redis库，确保redis.max_connections配置值大于总Worker数×2。
四、日志与连接状态实时监控
Webman未内置连接级监控视图，需结合标准输出重定向与自定义统计逻辑实现可观测性。
1、在onConnect方法中记录客户端IP、User-Agent及连接时间戳至storage/logs/ws-connect.log。
2、在onClose方法中写入断开原因（如timeout、client_close、error）及持续时长。
3、使用webman framework提供的Webman\Server::getWorkerCount()与Webman\Server::getConnectionCount()接口，暴露HTTP健康检查端点（如/status）。
4、接入Prometheus，通过text\_format响应体暴露webman_ws_connections_total、webman_ws_messages_received_total等指标。
五、连接保活与异常连接清理
客户端网络不稳定或设备休眠易导致僵尸连接堆积，消耗内存与文件描述符，需主动干预。
1、在config/server.php中设置'websocket.ping_interval' => 30（单位：秒），触发服务端周期性ping。
2、重写onPing回调，在其中更新Session最后活跃时间戳到Redis哈希表ws:sessions:{fd}。
3、启动独立定时进程（app/process/PingCheckerProcess.php），每10秒扫描Redis中last_active超过90秒的Session，调用Webman\Server::close($fd)强制关闭。
4、在Linux系统中调整内核参数：echo 'net.core.somaxconn = 65535' >> /etc/sysctl.conf并执行sysctl -p，防止连接队列溢出。
