服务端调试工具使用教程

无需自备服务器，浏览器打开即用。UDP / TCP / HTTP / MQTT / WebSocket 五种协议调试工具，实时收发报文并自由响应。

快速上手

各工具使用方式一致，掌握一次即可全部上手。

  1. 选择工具：点击顶部导航，或从首页进入任意协议的调试页面（UDP / TCP / HTTP / MQTT / WebSocket）。
  2. 获取地址：页面自动分配一个公网 IP + 端口，显示在「系统基本信息」面板。
  3. 连接调试：用脚本或硬件客户端连接该地址并发送数据，报文会实时展示在「会话信息」区域。
  4. 自由响应：在输入框填写内容点 Send 手动回复，或开启「自动响应 / 回声 / 循环响应」自动回复。
建议把浏览器设置为「永不休眠」，否则电脑休眠期间将无法接收和展示报文。
协议详解
📨

UDP 服务端

面向无连接的数据报协议，适合网关、智能硬件等设备的快速上报与调试。

打开工具
连接地址：udp://[公网IP]:[端口]
  1. 获取地址：打开 UDP服务端调试页，页面自动分配公网 IP 和端口，显示在「系统基本信息」面板。
  2. 客户端上报：使用脚本或硬件客户端，向 udp://IP:端口 发送数据报。
  3. 查看报文：收到的报文实时显示在「会话信息」区域，可随时切换 HEX / ASCII 格式查看。
  4. 手动回复：在底部输入框填写报文并点击 Send，将发送给最近一次向服务端上报过数据的客户端地址。
UDP 手动发送前，需要先有客户端向本服务端发送过数据，否则会提示没有可发送的地址。
🔗

TCP 服务端

面向连接的长连接通信，适合设备网关接入、指令下发等场景。

打开工具
连接地址：IP:端口（TCP 直连）
  1. 获取地址：打开 TCP服务端调试页，获取分配的 IP 和端口。
  2. 客户端连接：客户端通过 TCP 建立连接，页面会显示「客户端上线」系统消息。
  3. 收发报文：设备上报的数据实时显示；在底部输入报文点 Send，发送给最近活跃的客户端。
  4. 断开连接：点击「断开当前端口的所有连接」按钮，可断开当前端口下的全部 TCP 连接。
客户端断开连接时，页面会显示「客户端离线」事件，方便跟踪长连接状态。
🌐

HTTP 服务端

查看 HTTP 客户端请求的完整详情（方法、路径、请求头、请求体），并手动或自动响应。

打开工具
连接地址：http://[公网IP]:[端口]/任意路径
  1. 获取地址：打开 HTTP服务端调试页，获取分配的 IP 和端口。
  2. 发起请求：客户端向 http://IP:端口/任意路径 发起 HTTP 请求（GET/POST 等均可）。
  3. 查看详情：页面展示请求的方法、URI、协议、请求头和请求体。
  4. 手动响应：在输入框填写响应内容并点击 Send，服务端以 200 OK 状态返回该内容。
请求最长等待 5 分钟，超时自动返回 504；也可开启「自动响应 / 循环响应」按配置返回。
📡

MQTT 服务端

内置 MQTT Broker（默认无需用户名密码），用于调试 IoT 设备的接入与消息收发。

打开工具
连接地址：IP:端口（MQTT over TCP）
  1. 获取地址：打开 MQTT服务端调试页，获取分配的 IP 和端口。
  2. 客户端接入：MQTT 客户端直接连接（无鉴权），页面实时展示客户端上线、订阅、取消订阅、发布、离线事件。
  3. 发布消息：输入「主题」和「Payload」，点击「发布」按钮向该主题广播消息。
  4. 自动发布：开启「自动发布 / 循环发布」，按配置的主题与 Payload 自动或循环发布。
客户端发布的可读文本直接展示，二进制内容自动转换为 HEX 显示。
🔄

WebSocket 服务端

调试 WebSocket 客户端的连接与文本 / 二进制消息收发。

打开工具
连接地址：ws://[公网IP]:[端口]/
  1. 获取地址：打开 WS服务端调试页，获取分配的 IP 和端口。
  2. 客户端连接：WebSocket 客户端连接 ws://IP:端口/，页面显示「客户端上线」事件。
  3. 收发报文：客户端发来的文本 / 二进制消息实时显示；底部输入点 Send 发给最近活跃的客户端。
  4. 断开连接：点击「断开当前端口的所有连接」，可断开当前端口下的全部 WebSocket 连接。
粘贴图片也可以直接作为二进制消息发送给客户端。
通用功能

通用功能说明

各工具共有的配置项与页面能力。

HEX / ASCII 切换HEX 格式每两个字符为一个字节（如 68 66）；ASCII 直接输入文本。切换格式时，输入框内已有内容会自动转换。
自动响应开启后，服务端收到报文会自动回复输入框中配置的固定内容。
回声功能开启后，服务端会把客户端发送的报文原样回显给对方。
循环响应按 1-10 号输入框的内容顺序，依次轮流回复收到的报文。
互斥规则自动响应、回声、循环响应三者互斥，开启其中一个会自动关闭另外两个。
粘贴图片在输入框中直接粘贴剪贴板图片（不超过 1MB），即可作为消息发送。
端口生命周期端口仅绑定当前页面，关闭页面或切换工具立即释放；重新打开会分配新端口。
常见问题

常见问题及解决

遇到问题先来这里看看。

为什么测试一段时间后，不打印交互报文了？
请确保电脑和浏览器没有进入休眠状态。浏览器设置：设置 → 系统和性能 → 把当前网站添加到「从不让这些站点进入睡眠状态」。
页面关闭后，端口会立即释放吗？
会。端口仅绑定当前页面，关闭页面或切换到其他工具时立即释放，重新打开页面会分配新端口。
端口分配失败怎么办？
请刷新页面重试。若持续失败，可能是端口已被占用或当前工具资源不足。
为什么点 Send 提示「暂无客户端」？
需要先有客户端连接 / 上报过数据。UDP 场景必须先有客户端向服务端发送过数据报，才能获取到回传地址。
可以同时打开多个调试页面吗？
可以。每个页面独立分配端口、互不影响，适合同时调试多种协议。