WebSocket 客户端与服务端
配置 ws/wss 客户端、本地 ws 服务端、消息类型、临时认证与重连。
浏览全部手册
本页目录
适用 2026-10-22 的 0.1.0 测试构建,Electron / Tauri 共用操作入口。下载页已提供包含本功能的七个新包;请核对 buildId、SHA-256 与平台验收范围。
本机完成一次消息往返
- 在“添加端点”创建 WebSocket 服务端,保留
127.0.0.1:9000/,保存后打开监听。端口被占用时更换端口,并同步客户端地址。 - 新增 WebSocket 客户端,填
ws://127.0.0.1:9000/,保存并打开。服务端展开后应能看到该连接。 - 客户端选择 Text,发送
Hello;服务端核对 TXT 消息,再选择该客户端回复。服务端也能广播或单独断开客户端,单个客户端离开不关闭监听。 - 切换 HEX 并发送
48 69,接收端应显示 BIN 类型。Text / JSON 默认文本消息,HEX 默认二进制,也可明确覆盖类型。一条发送对应完整消息,不追加 CRLF,也不套用 TCP 流式分帧。
客户端支持 ws:// 与 wss://;本地服务端只提供 ws,没有 TLS 证书配置。需要 wss 服务入口时由已有反向代理终止 TLS。客户端使用原生信任校验,不提供跳过证书错误的开关。
路径、子协议与临时请求头
服务端只接受配置的路径。配置子协议时客户端必须匹配;子协议按逗号分隔、保持唯一,最多 16 项,每项 128 字节。
Authorization、Cookie 等握手请求头只保留在当前进程内存,自动重连可复用;退出后重新填写,删除端点或成功导入工作区会清除。请求头不进入配置、SQLite 或导出文件,最多 32 项、单值 4096 字节、名称和值合计 16 KiB;禁止重复、换行及 Host、Connection、Upgrade、Sec-WebSocket-* 等保留头。
URL 不接受用户名密码或片段。URL 本身会保存和导出,不要把保密令牌放进查询参数。携带请求头或非空查询参数时,远端关闭原因被隐藏以免回显敏感内容,关闭码仍可查看。
心跳、重连与资源范围
Ping/Pong 默认关闭,默认间隔 30 秒、等待 10 秒,可配置范围均为 1~60 秒;控制帧不进入业务消息历史。客户端可开启自动重连,主动关闭、删除、导入或退出会停止重试。
单消息最多 1 MiB,服务端最多 64 个已连接或握手中的客户端,握手绝对期限 15 秒,每目标待发送字节最多 4 MiB。发送逐目标报告结果,部分失效不阻止尝试健康目标。Electron 写入最长等待 10 秒;Tauri 从入队到写入合计最多 2 秒,每目标队列最多 32 项。超限或超时会报错或关闭相应连接,不能据此承诺任意负载无损。
保存范围与迁移见工作区导入与导出。需要 topic/queue 语义时,继续阅读 STOMP,不要把普通 WebSocket 服务端当作消息 broker。
仍有疑问?按反馈清单整理复现信息 →