WebSocket 通过代理的长连接验收与排错指南
能稳定完成短 HTTP 请求的代理，仍可能无法承载 WebSocket。WebSocket 的运行方式不同：同一连接可能持续数小时，数据双向流动，中间设备可能设置空闲上限，而对无状态请求有用的出口轮换可能直接破坏会话连续性。
本指南适用于通过 HTTP、HTTPS、SOCKS5、住宅、轮换或静态代理运行安全 WebSocket。只能在已获授权的端点和流量范围内测试。
验证完整生命周期
一个有效 WebSocket 结果至少包括七个阶段：
- 解析代理网关；
- 连接代理并认证；
- 建立目标隧道或转发路径；
- 完成安全 WebSocket 的 TLS 校验；
- 完成 WebSocket 开启握手；
- 在要求的会话时长内交换有效消息；
- 正常关闭或按策略恢复连接。
不要把这些阶段压缩成一个成功字段。如果预期协议切换却只得到普通 HTTP 页面，即使状态码看似正常，也应判为失败。
先定义工作负载合同
采购前明确：
- 使用安全还是明文 WebSocket；
- 客户端预期 HTTP/1.1 Upgrade、HTTP/2 Extended CONNECT 或 HTTP/3；
- DNS 在本地还是代理端解析；
- 典型和最长会话时间；
- 消息速率以及最大帧或消息；
- 心跳由哪一端负责、间隔多长；
- 可接受的静默窗口；
- 重连预算和重新订阅方法；
- 出口地区及 IP 是否必须稳定；
- 对重复、丢失和乱序消息的容忍度。
没有这些条件，五秒回声测试很容易通过，却不能代表真实业务。
建立控制矩阵
同时测试已授权直连控制组和每条候选代理路径，覆盖所需地区与地址族。对轮换服务比较按请求轮换、多个粘性时长、静态或独享控制路线，以及低流量与真实流量消息模型。
保持目标、客户端版本、认证、请求头、子协议、压缩设置、心跳策略和测试时长一致。
八步验收流程
1. 验证 DNS 与代理可达性
记录网关和目标在哪里解析、地址族、查询时延、TCP 连接时间和代理认证。SOCKS5 必须区分本地解析与远程 DNS。日志不得写入用户名、密码、令牌或完整授权头。
2. 验证开启握手
记录协议、主机、路径、适用的 Origin、WebSocket 版本、子协议和扩展。确认结果是真正的协议升级或正确的 Extended CONNECT，而不是登录页、拦截页或普通成功页面。
安全 WebSocket 必须通过隧道按主机名验证目标证书，不能关闭证书检查来换取“成功”。
3. 测量双向消息完整性
使用匿名序列号和时间戳发送获授权测试消息，在应用层验证哈希或确定性内容标记。分别统计发送、确认、接收、重复、丢失、损坏和乱序。
同时覆盖小型控制消息、典型业务负载和最大业务消息。帧边界不总是等于应用消息边界，应在应用实际消费的层面校验。
4. 找到有效空闲超时
用逐步延长的静默窗口运行多组会话。能取得证据时，区分关闭来自客户端、代理网关、上游中间设备、出口网络还是目标。
不要用高频心跳掩盖未知上限。先测边界，再选择有余量且成本可控的心跳间隔。
5. 验证 ping、pong 和应用心跳
协议 ping/pong 可证明对端仍响应，应用心跳则可验证业务循环是否健康。如果两者都使用，应分别测试并记录往返延迟、漏答及断开规则。普通数据流量不能自动视为心跳。
6. 测试粘性过期与轮换
对轮换住宅代理，让连接跨过标称粘性时长，观察现有套接字是继续、正常关闭还是被重置；再新建连接验证轮换行为。
不要假设已建立的 WebSocket 内部会顺利更换 IP。连接中途替换路径通常会中断传输，并可能在重连后产生重复订阅。
7. 测试安全重连
分别在客户端、代理和目标层注入受控关闭，使用带抖动的有界指数退避。重连后验证认证、会话标识、订阅恢复、续传游标、重放窗口和去重。
打开新套接字并不等于恢复成功；业务必须从已知位置继续，且不能静默丢失或重复处理事件。
8. 验证正常关闭
发起 WebSocket 关闭握手，记录关闭码、原因类别、对端响应时间和底层连接关闭。正常结束、超时、策略拒绝、协议错误和传输突断必须分别统计。
应关注的指标
按代理产品、网关、请求地区、观察出口、地址族和会话策略报告：
- 握手成功率与有效会话成功率；
- 开启时间与首条有效消息时间；
- 1、5、15、30、60 分钟或业务时点的存活率；
- ping/pong 与应用心跳延迟分位数；
- 有效消息率、重复、缺口和乱序；
- 空闲超时分布；
- 重连成功率和订阅恢复耗时；
- 每个有效会话流量；
- 每个完整有效会话成本。
最后一项能避免按 GB 看似便宜、却因频繁重连和重放而更贵的方案胜出。
故障分类
握手返回普通网页： 检查代理认证、目标策略、重定向，以及 Upgrade 或 Extended CONNECT 是否保留。
连接总在相同静默时长断开： 先调查空闲超时，不要直接归因出口质量。
只有轮换路线失败： 使用粘性或静态控制组，并确认会话有效期覆盖业务时长。
Pong 正常但没有业务消息： 传输仍活跃，但订阅或应用循环可能失效。
重连产生重复事件： 保存续传游标和幂等键，不要盲目删除所有重复数据。
大消息失败： 分别排查帧大小、消息大小、压缩、中间设备限制、内存与解析。
上线清单
- [ ] 验证真实 WebSocket 握手，而不是只看 HTTP 状态。
- [ ] TLS 证书校验保持启用。
- [ ] 本地和远程 DNS 模式已标注。
- [ ] 双向消息按序列和内容标记校验。
- [ ] 已测量有效空闲超时。
- [ ] 心跳间隔有明确余量。
- [ ] 粘性时长覆盖业务会话。
- [ ] 重连有界退避并能安全恢复订阅。
- [ ] 已统计重复与丢失消息。
- [ ] 正常关闭与异常中断分开分类。
- [ ] 日志不含凭据和客户负载。
常见问题
轮换住宅代理适合 WebSocket 吗？
如果供应商支持隧道，且粘性时长超过连接需求，就可能适合。需要长期连续性时，静态或独享路线通常更容易控制。
CONNECT 成功是否证明支持 WebSocket？
不能。CONNECT 只建立隧道，之后仍需验证 TLS、开启握手、子协议、消息流、心跳与生命周期。
心跳应该多频繁？
依据实测空闲上限、目标规则、供应商政策与流量成本决定，不应套用固定神奇数字。
每次断开都应立即轮换吗？
不应。先分类原因；立即轮换可能抹掉证据、放大重连流量并破坏会话连续性。
合规与安全
只使用获授权的 WebSocket 端点、账户、市场和数据，遵守服务条款、访问控制、隐私要求、订阅上限与速率规则。减少网络标识符留存，绝不记录代理凭据、会话令牌、Cookie 或客户消息正文。
继续阅读SOCKS5 与 HTTP 代理选择指南、住宅代理会话粘性测试和代理重试风暴防护指南。
资料说明：互联网工程任务组 RFC 6455，2011 年 12 月；RFC 8441，2018 年 9 月；RFC 9220，2022 年 6 月。curl 项目《WebSocket with curl》，2026 年 9 月 11 日复核。
