Files
opsxapi/server/internal/docs/content/08-websocket.md
T
logan 2bb4ef7a95 桌面 GUI 外链修复 + 主题顺序调整(含结构扁平化进行中的工作区基线)
- 集成 tauri-plugin-opener:Cargo/lib.rs/capabilities/npm 四处接线,新增 src/openExternal.ts(桌面走 opener,浏览器回退 window.open,相对路径绝对化)
- 关于页 4 个链接、活动栏官网菜单、代理错误横幅 2 处健康检查链接全部改走 openExternal,桌面端可正常跳转
- 设置→外观 主题顺序调整为 深色/浅色/跟随系统
- release 二进制重编并验证(浏览器实测关于页链接可开文档页)
- 附带工作区中未提交的扁平化重构现状(另一会话进行中)
- homepage 落地页与文档终检通过(8787 / 与 /docs 双 200)
2026-10-16 03:03:36 +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 时直连目标,零额外开销。

注意:隧道要求本地 Gin 服务(:8787)在运行,即用 ./run.sh web / gui 启动的默认形态。

调试技巧

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