Tunnix 正在开发中,尚未发布。首个版本发布后,下载将在此提供。

本地配置 HTTP API

仅限桌面端:在你自己的工具中校验和预览 Xray 配置。

启用

打开 Xray → 本地 API,开启启用本地 API。它只监听 127.0.0.1,默认端口为 18587。使用复制令牌将访问令牌提供给可信的工具;重置令牌会吊销旧令牌。

请求

每个请求都需要 Authorization: Bearer <token>。

请求结果
GET /api/v1/infoAPI、应用和内核版本,以及平台
POST /api/v1/config/validate校验一份配置
POST /api/v1/config/compile预览 Tunnix 将生成的运行时配置

POST 请求体为 JSON,包含 kind(outbound、routing、advanced-routing 或 raw)和 text(以字符串形式提供的原始 JSON)。

curl -s http://127.0.0.1:18587/api/v1/info \
  -H "Authorization: Bearer $TUNNIX_TOKEN"

限制

该 API 不会导入、保存或选择服务器,也无法启动或停止 VPN。HTTP 200 加上 status: failed 表示请求已执行,但配置未通过校验。

切勿将令牌放入 URL、命令行历史记录或 AI 提示词中。任何持有令牌的人都可以在这台电脑上使用该 API。