首页

WebSocket在线测试工具

免费在线WebSocket测试工具，支持 ws/wss 协议连接调试。实时收发消息，查看连接状态与消息日志，适用于API调试、实时通信开发、IoT设备测试等场景，纯浏览器端运行，无需安装客户端。

连接与消息调试
未连接
消息日志 时间戳 · 本地时区
尚未建立连接，输入地址后点击「连接」开始调试

功能特性

实时连接

支持 ws:// 与 wss:// 协议，一键建立WebSocket连接，实时显示连接状态变化。

消息收发

实时发送文本消息并接收服务端响应，支持回车快捷发送，消息内容防XSS转义。

状态指示

直观的状态指示器：灰色未连接、黄色连接中、绿色已连接，一眼掌握当前状态。

日志面板

分类显示发送、接收、系统、错误消息，带时间戳与方向图标，支持自动滚动与清空。

安全本地

纯浏览器端运行，WebSocket直连目标服务器，不经本站后端中转，消息不落盘存储。

Blob 支持

自动识别并处理Blob类型消息，通过FileReader读取二进制响应内容，兼容各类服务端。

使用说明

建立连接

  • 在地址输入框中填写WebSocket服务端地址，默认提供 wss://echo.websocket.org 测试回显服务。
  • 地址必须以 ws:// 或 wss://（加密）开头，否则会提示格式错误。
  • 点击「连接」按钮，状态指示器变为黄色「连接中」，成功后变为绿色「已连接」。
  • 连接建立后，「断开」按钮变为可用，「发送」按钮与消息输入框解锁。

收发消息

  • 在消息输入框中输入要发送的文本内容，点击「发送」按钮或直接按 Enter 键发送。
  • 发送的消息以蓝色 箭头标识，接收的消息以绿色 箭头标识。
  • 系统消息（连接、断开、关闭等）以灰色 图标标识，错误信息以红色 图标标识。
  • 日志面板自动滚动到最新消息，点击「清空日志」可清除所有记录。

断开连接

  • 点击「断开」按钮可手动关闭连接，系统日志会记录「连接已手动断开」。
  • 关闭页面或刷新浏览器时，会自动关闭WebSocket连接，避免资源泄漏。
  • 服务端主动关闭时，日志会显示关闭码（如1000正常关闭、1006异常断开）和原因。

典型使用场景

  • API调试：测试后端WebSocket接口的连接、认证、消息推送逻辑是否正常。
  • 实时通信开发：调试聊天室、通知推送、协同编辑等实时应用的协议交互。
  • IoT设备测试：验证物联网设备通过WebSocket上报数据与接收指令的链路。
  • 协议学习：直观观察WebSocket握手后的双向通信过程，理解全双工通信原理。
  • 服务联调：前后端分离架构下，快速验证WebSocket网关、负载均衡、心跳保活配置。

常见问题

WebSocket和HTTP有什么区别？
WebSocket是一种在单个TCP连接上进行全双工通信的协议，与HTTP的主要区别在于：通信模式——HTTP是请求-响应模式（客户端主动），WebSocket是双向实时通信（服务端可主动推送）；连接生命周期——HTTP每次请求可复用连接但响应后释放，WebSocket建立后持久保持；开销——HTTP每次请求携带完整头信息，WebSocket握手后数据帧头开销极小（2-10字节）。WebSocket握手阶段使用HTTP Upgrade机制，握手成功后切换为WebSocket协议。
ws://和wss://有什么区别？
ws:// 是明文WebSocket协议，数据以明文传输，相当于HTTP；wss:// 是加密WebSocket协议，基于TLS/SSL加密传输，相当于HTTPS。生产环境强烈建议使用 wss://，防止消息被窃听或篡改。注意：从HTTPS页面只能连接 wss:// 地址，浏览器会阻止混合内容（HTTPS页面连接ws://）。
连接失败可能是什么原因？
常见原因包括：地址错误——URL拼写错误或未以ws/wss开头；跨域限制——部分服务端校验Origin头，浏览器无法绕过；证书问题——wss连接时服务端SSL证书无效或自签名；混合内容——HTTPS页面连接ws://明文地址被浏览器拦截；网络问题——目标服务器未启动、端口未开放或被防火墙拦截；协议不匹配——服务端非WebSocket服务（如普通HTTP接口）。
本工具会保存我的消息数据吗？
不会。本工具是纯浏览器端应用，WebSocket连接由浏览器直接与目标服务端建立，不经过本站后端中转。所有消息仅在本地内存与日志面板中显示，刷新页面即清除，不会上传到任何服务器或持久化存储。请放心用于调试，但切勿在公共环境输入敏感业务数据。
WebSocket连接关闭码代表什么？
关闭码遵循RFC 6455规范：1000 正常关闭；1001 端点离开（如页面关闭）；1002 协议错误；1003 不支持的数据类型；1006 异常关闭（未发送关闭帧，通常是网络中断）；1007-1011 数据格式/策略/服务端内部错误；1015 TLS握手失败。4000-4999为应用自定义关闭码。
echo.websocket.org是什么服务？
echo.websocket.org 是一个公共的WebSocket回显测试服务，会将收到的任意消息原样返回给发送方。常用于WebSocket客户端开发与测试，可快速验证连接建立、消息收发链路是否正常。该服务由第三方提供，可能存在不稳定或下线情况，如无法连接建议更换为本地或自建测试服务。