OpsxAPI 文档 v1.0

快速开始

更新于 2026-09-17

环境要求

组件 版本 用途
Node.js ≥ 20 Web 前端(Vite)
Go ≥ 1.23 本地代理服务(Gin)
Rust + Cargo 可选 仅编译桌面端(Tauri)时需要

启动

git clone <你的仓库地址> opsxapi
cd opsxapi
make install     # 安装依赖(npm install,含桌面端)

./run.sh web     # 启动:Gin(:8787) + Web UI(:5173)

看到下面的输出即可打开浏览器:

[OK] 后端 UP  http://127.0.0.1:8787/health
[OK] Web UP  http://127.0.0.1:5173
命令 说明
./run.sh web 浏览器版(推荐)
./run.sh gui 桌面窗口(Tauri,共用同一 UI)
./run.sh all Web + 桌面一起开
./run.sh status / stop 查看状态 / 停止

30 秒发出第一个请求

  1. 打开 http://127.0.0.1:5173,左侧是内置的「示例集合」。
  2. 点击 HTTP · httpbin → 获取请求回显。
  3. 点击右上角 发送。
  4. 下方响应区显示 200、耗时与 JSON 高亮响应体 —— 完成!

桌面端(可选)

./run.sh gui

桌面端复用同一份界面与数据通道,HTTP 请求走 Tauri 原生网络栈,不依赖浏览器 CORS。

提示:首次打开会自动创建两个环境(正式 / 本地)和一个覆盖全部协议的示例集合,可随时在「设置」中重置。