文档 · v0.1.0-beta · 更新于 2026-10-23

API 参考

所有接口使用 HTTPS，token 通过查询参数或请求头传递。

代理请求

GET https://use.vpntoken.icu/?token=YOUR_TOKEN&url=TARGET_URL

参数	必填	说明
`token`	是	访问 token，也可用 `x-proxy-token` 请求头
`url`	是	目标 URL，必须 URL 编码；省略协议时默认 `https://`
`node`	否	节点名，中文需 URL 编码
`strategy`	否	`manual` / `auto` / `fallback` / `round-robin`
`timeout`	否	超时毫秒数，1000–120000
`referer`	否	目标 Referer
`useragent` / `ua`	否	目标 User-Agent
`method`	否	目标请求方法
`body`	否	目标请求体
`headers`	否	JSON 对象，例如 `{"x-api-key":"..."}`
`redirect`	否	`follow` 或 `manual`
`max_redirects`	否	0–10，默认 5

未识别的查询参数会作为目标请求头；以 h_ 或 header_ 开头的参数可显式指定请求头。

POST https://use.vpntoken.icu/udp?token=YOUR_TOKEN
content-type: application/json

{"host":"8.8.8.8","port":53,"packets":["aGVsbG8="]}

{"ok":true,"packets":["..."],"note":"..."}

该接口在 VLESS TCP 上承载 UDP-over-TCP，要求节点支持 XUDP。它不是原生 UDP socket。

GET https://use.vpntoken.icu/health

无需 token，只返回服务状态和节点数量：

{"ok":true,"available":28,"total":99}

available 是当前可用节点数，total 是订阅中的全部节点数。