WebSocket Online Tester
WebSocket 在线测试工具
填一个 ws:// 或 wss:// 地址即可连接调试:实时收发消息、定时自动发包、格式化 JSON、 预览二进制帧,日志可筛选、搜索与导出。浏览器直连目标服务,消息不经过本站。
直连不经过本站
定时发包 / 自动重连
JSON 与二进制预览
日志筛选导出
当前页面是 HTTPS,浏览器会拦截不安全的
ws:// 连接。请用 wss:// 地址,或在 http://localhost 下打开本页调试本地服务。
服务器配置
尚未连接
填写地址后点击连接
点选填入地址
常用测试地址
第三方公共服务可用性以对方为准
发包设置
快捷模板
秒自动发送一次
发送侧为文本消息;二进制帧可接收并预览
调试消息
0发送条数
0接收条数
0 B收发流量
--连接时长
0日志条数
日志上限 1000 条,超出自动丢弃最早记录;刷新页面即清空,需要留档请先导出。
使用说明
连接服务
- 填写
ws://或wss://开头的完整地址,回车或点「连接」即可。本站为 HTTPS,浏览器会拦截ws://混合内容,本地调试请在http://localhost下打开本页。 - 需要协商
Sec-WebSocket-Protocol时填写子协议,多个用英文逗号分隔;浏览器原生 WebSocket 无法设置自定义请求头,鉴权请用 URL 参数或连接后的首条消息。 - 勾选「意外断开时自动重连」后,非主动断开会按 1、2、4… 秒退避重连(间隔上限 30 秒、最多 10 次);主动点「断开」不会触发重连。
- 连接成功后展示协商的子协议、连接耗时;关闭时给出 code 与原因,1006 通常表示网络中断或握手失败。
收发消息
- 消息框支持
Ctrl / ⌘ + Enter发送,Enter 换行;快捷模板可一键填入常用文本或 JSON。 - 勾选「每隔 N 秒」启用定时自动发包,间隔 1 到 3600 秒,断开连接会自动停止;「发送前校验 JSON」可在格式错误时阻止发送。
- 接收侧支持文本、Blob 与 ArrayBuffer;二进制帧展示字节数与十六进制预览,可打印字符会同时给出文本解码。接收类型可在连接前切换。
日志与导出
- 日志按发送、接收、系统、错误四类着色,带时间戳与字节数;可按类型筛选、按关键字搜索、暂停接收或清空。
- 「JSON 解码」会把合法 JSON 缩进格式化显示;单条消息右侧可一键复制。
- 导出 TXT 为便于阅读的时间线文本,导出 JSON 为结构化记录(时间、方向、内容、字节数),方便脚本二次分析。
隐私说明
WebSocket 连接由浏览器直接发起,消息不经过本站服务器,也不写入 localStorage。仅服务地址、最近连接记录与界面偏好保存在浏览器本地; 调试日志只存在当前页面内存,刷新即清空。使用公共 echo 服务时,发送内容会到达该第三方服务,请勿发送敏感数据。
常见问题
消息会经过本站服务器吗?
不会。连接由当前浏览器直接连到目标服务地址,消息不经过本站服务器。仅服务地址、间隔等偏好保存在浏览器 localStorage,日志仅存在当前页面内存。
为什么在 HTTPS 页面连不上 ws:// 地址?
浏览器会阻止 HTTPS 页面发起不安全的 ws:// 连接(混合内容)。本地调试可用 http://localhost 打开本页,或给服务配置 wss:// 证书;线上站点请使用 wss:// 地址。
公共 echo 服务连不上怎么办?
公共测试服务由第三方提供,可能因网络、限流或服务下线而不可用。建议在本地启动一个 WebSocket 服务,用 ws://localhost:8080 测试,或换成自己项目的地址。
可以发送二进制消息或自定义请求头吗?
浏览器原生 WebSocket 不支持自定义请求头,只能设置子协议。本工具支持接收并预览二进制消息,发送侧为文本,可在文本中填写 JSON 或 Base64 由服务端解析。
刷新页面后日志还在吗?
不在。日志只保存在当前页面内存,刷新即清空,避免消息内容被长期留存。需要留档请使用「导出 TXT」或「导出 JSON」,服务地址与偏好设置会自动保存。