本地配置 HTTP API
仅限桌面端:在你自己的工具中校验和预览 Xray 配置。
启用
打开 Xray → 本地 API,开启启用本地 API。它只监听 127.0.0.1,默认端口为 18587。使用复制令牌将访问令牌提供给可信的工具;重置令牌会吊销旧令牌。
请求
每个请求都需要 Authorization: Bearer <token>。
| 请求 | 结果 |
|---|---|
GET /api/v1/info | API、应用和内核版本,以及平台 |
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。