logan
dec66db5aa
- 六协议调试：HTTP/GraphQL/WebSocket/SSE/Socket.IO/MQTT
- 集合树/多标签/多环境变量/历史记录，localStorage 持久化
- 导入：OpenAPI 2/3/3.1、Postman、Apifox、Apipost、cURL、HAR、
Insomnia、Hoppscotch、Markdown（自动识别，21 个单测覆盖）
- 导出：OpenAPI 3.0 JSON/YAML、Postman v2.1、Markdown 文档、
全量备份；单请求生成 cURL/fetch/Python/Go 代码
- Gin 服务：HTTP 代理、NDJSON 流式代理（SSE 透传）、
WebSocket 隧道（浏览器自定义握手 Header）
- 内置产品官网 /home 与用户文档站 /docs（SSR，随二进制交付）
- lucide 图标体系 + 品牌标识（Logo/favicon），明暗双主题
- 环境变量：彩色徽标切换器、管理弹窗、{{ 自动补全
46 lines
2.1 KiB
Markdown
46 lines
2.1 KiB
Markdown
## 请求报 CORS 错误？
|
||
|
||
Web 端请求默认经本地 Gin 代理（gin-proxy）发出，不会遇到 CORS。若仍报错：
|
||
|
||
- 确认 Gin 在运行：`curl http://127.0.0.1:8787/health`。
|
||
- 用 `./run.sh web` / `gui` 场景启动（Vite 已配置 `/v1` 反代）。
|
||
- 桌面端优先走 Tauri 原生网络栈，同样不受 CORS 限制。
|
||
|
||
## 浏览器 WebSocket 不能加自定义 Header？
|
||
|
||
规范限制。在 WS「握手配置」里填写 Header 后，OpsxAPI 自动改走本地 Gin 隧道（见《WebSocket》章节），Header 由 Gin 在握手时代为携带。不填 Header 则直连。
|
||
|
||
## 外部 wss:// 地址连不上（DNS 失败）？
|
||
|
||
本机网络环境可能限制部分域名解析。可先用 `curl -v wss://…` 或换用公共 echo 服务验证；自建服务请确认防火墙与证书。
|
||
|
||
## MQTT 一定要 wss:// 吗？
|
||
|
||
浏览器只能通过 WebSocket 连 MQTT。常见 Broker 的 WS 端口：EMQX `8084/mqtt`（TLS）、`8083/mqtt`（明文，仅 http 页面）。`mqtt://` TCP 直连仅在桌面原生环境可行。
|
||
|
||
## 数据存在哪里？换电脑怎么办？
|
||
|
||
集合 / 环境 / 历史保存在浏览器 localStorage。迁移：**导出 → 全量备份** 生成 JSON，在新设备 **导入** 即可。
|
||
|
||
## 误删了接口 / 想回到初始状态？
|
||
|
||
设置（顶栏 ⋯）→ 重置工作区，恢复内置示例集合。日常请养成导出备份的习惯。
|
||
|
||
## SSE 事件流看着卡住了？
|
||
|
||
- 事件频率低（如告警流）属正常，等待即可。
|
||
- 部分网关会缓冲 SSE，工具会在直连失败时自动切换 Gin 流式代理；若仍无事件，检查中间层（Nginx 需关闭 `proxy_buffering`）。
|
||
|
||
## 发送按钮点击后没反应？
|
||
|
||
查看响应区是否有红色错误提示（如代理不可达）。`</>` 代码 生成 cURL 在终端执行可快速分辨是工具问题还是网络 / 接口问题。
|
||
|
||
## 支持文件上传吗？
|
||
|
||
form-data 当前支持文本字段；文件上传请用 `</>` 代码 生成的 cURL / 脚本执行。
|
||
|
||
## 更多问题？
|
||
|
||
- 服务端能力与边界：见《服务端 API 参考》
|
||
- 各协议用法：见左侧「请求调试」分组
|