Files
opsxapi/homepage/content/08-websocket.md
T
logan f6f61b35d8 文档去源码化:公开文档不再引导 git clone / run.sh(商业软件口径)
- 02-快速开始 整篇重写为最终用户视角:官网/微信群获取安装包 → 安装即用 →
  30 秒首请求 → 切换环境 → 试用与授权指引;删除环境要求表/克隆启动/命令表
- 01-介绍「开箱即用」改为安装即用口径;08-WebSocket 隧道说明改为随应用自动运行;
  19-FAQ CORS 排查项去掉 curl/run.sh;18-服务端部署建议改为私有化发行包交付
  (单二进制+静态资源,不依赖源码与构建工具链)
- 重建后 quickstart/落地页 git clone、run.sh、npm、cargo 残留均为 0;五页零断链
2026-10-16 12:19:30 +08:00

1.3 KiB
Raw Blame History

连接

  1. 填写 ws:// 或 wss:// 地址。
  2. 点击 连接;状态点变绿(已连接)后即可收发消息。
  3. 再次点击按钮即断开。

消息收发

  • 消息日志:接收(绿)/ 发送(蓝)/ 系统(灰)/ 错误(红)分色展示,顶部统计 ↑↓ 条数与连接时长。
  • 发送框:支持 JSON / 纯文本;⌘/Ctrl + Enter 快速发送;「格式化 JSON」一键美化。

子协议

「握手配置」标签中的子协议填逗号分隔列表,例如:

graphql-transport-ws, v1.json

自定义握手 Header(隧道模式)

浏览器原生 WebSocket 不能携带自定义 Header(如 Authorization、X-API-Key)。OpsxAPI 的处理方式:

  1. 「握手配置」中填写 Header 后,工具自动改走本地 Gin 隧道:
    • 浏览器 → Gin /v1/proxy/ws/attach(普通 WS)
    • Gin → 目标服务器(携带你填的全部 Header)
  2. 不填 Header 时直连目标,零额外开销。

说明:隧道由应用自带的本地服务提供 —— 桌面版随应用自动运行,无需任何手动配置。

调试技巧

  • 消息过多时点「清空」;日志上限 500 条,超出自动滚动淘汰。
  • 把常用报文保存在「说明」里,或为不同报文建多个 WS 请求节点。