关键在于解明文、辨帧型、定消息:Charles需开启透明代理、SSL代理和WebSocket代理三开关;Wireshark须启用WebSocket协议解析并配置TLS解密;Opcode与MASK决定内容可读性,分片帧需聚合还原。

直接看 WebSocket 传输的数据包,关键不是“能不能抓到”,而是“能不能解出明文、分清帧类型、定位到具体哪条消息”。浏览器 DevTools 只能看握手和简单文本帧,真正要查二进制帧、掩码处理、分片、关闭原因、WSS 加密内容,必须用 Charles 或 Wireshark,且配置不到位就全是乱码或空包。
Charles里看不到WebSocket条目?检查这三个开关
很多人启动 Charles 后刷新页面,Network 列表里只有 HTTP 请求,完全不见 wss:// 条目——这通常不是没连上,而是代理链断在了第一步。
- Proxy → Proxy Settings → 勾选
Enable transparent HTTP proxying(透明代理必须开,否则 WebSocket 升级请求不经过 Charles) - Proxy → SSL Proxying Settings → 确保
Enable SSL Proxying已勾选,并在 Locations 里添加了目标域名(如*.api.example.com或通配符*:*) - Proxy → WebSocket → 必须勾选
Enable WebSocket Proxy(这个开关独立存在,不依赖 SSL 设置,但没它就无法聚合后续帧)
漏掉任意一个,Charles 就只当它是普通 HTTPS 流量处理,不会识别 Upgrade 头,更不会把后续帧归到同一个 WebSocket 节点下。
Wireshark里抓到了TCP流,但显示“WebSocket”协议层为空?
Wireshark 默认可能未启用 WebSocket 解析,或者流量是加密的 WSS,导致它无法识别帧结构。
WebSocket 8.18.2 是该协议规范的一个重要迭代版本,主要优化了连接稳定性与数据传输效率。它通过全双工通信机制,允许客户端与服务器在单一长连接上实时交换数据,大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力,适用于即时通讯、在线游戏及金融行情推送等低延迟场景,为开发者提供更可靠的实时网络交互基础。
- 进入
Analyze → Enabled Protocols,确认WebSocket和HTTP都已勾选(WebSocket 解析依赖 HTTP 协议解析握手阶段) - 如果抓的是
wss://,必须先配置 TLS 解密:设置环境变量SSLKEYLOGFILE并在浏览器中启用,或导入服务器私钥(仅限测试环境);否则 Wireshark 只能看到加密的 TCP payload,协议层显示为TCP而非WebSocket - 过滤时别只用
tcp.port == 443,优先用http and http.upgrade或websocket显示过滤器快速定位升级请求
没有解密 + 未启用协议解析 = 所有帧都退化成原始 TCP 包,你得手动追踪流、拼接、解掩码——这不是调试,是逆向工程。
看到Frames但内容是十六进制或“”?重点看Opcode和MASK
WebSocket 帧是否可读,取决于两个底层字段:操作码(Opcode)和掩码标志(MASK)。浏览器发出的帧一定带掩码,而服务端响应通常不带;Charles 自动解掩码,Wireshark 需手动开启 “Decode as → WebSocket” 并确认解析上下文正确。
-
Opcode = 0x1:文本帧,应显示为 UTF-8 字符串;若显示乱码,检查是否被压缩(permessage-deflate),Charles 会标出Compressed标签,点击可自动解压 -
Opcode = 0x2:二进制帧,Charles 默认以 hex dump 展示;右键可选择 “Save Selected Frames As…” 导出为文件,再用对应工具(如jq、protoc)解析内部结构 -
MASK = 1(客户端帧):Charles 已自动处理;Wireshark 若未正确解掩码,payload 会全错,此时需确认是否在 “Decode as” 中将该 TCP 流设为 WebSocket -
Opcode = 0x8(Close)、0x9(Ping)、0xA(Pong):这些控制帧不携带业务数据,但Close帧里的状态码(如1006表示异常关闭)和原因字符串,是排查连接中断的核心线索
真正容易被忽略的,是分片帧(FIN = 0)——一条大消息可能被拆成多个 Opcode = 0x0 的连续帧,只有最后一帧 FIN = 1。Charles 会自动聚合,Wireshark 需手动“Follow WebSocket Stream”才能还原完整 payload。

















