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

Get Started

只需要一个 token 和一个目标 URL，就能从 Worker 发起代理请求。

1. 获取 token

由服务管理员创建 token。每个 token 可以单独停用，建议按设备或用途分配。

token-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

2. 发起第一个请求

目标 URL 必须进行 URL 编码。下面请求会返回出口 IP：

https://use.vpntoken.icu/?token=YOUR_TOKEN&url=https%3A%2F%2Fapi.ipify.org%3Fformat%3Djson

在 Worker 中可以直接使用 fetch：

const response = await fetch(
  'https://use.vpntoken.icu/?token=' + env.PROXY_TOKEN +
  '&url=' + encodeURIComponent('https://api.ipify.org?format=json'),
);
console.log(await response.text());

3. 常用参数

&node=节点名称        # 指定节点，中文需 URL 编码
&strategy=auto       # manual / auto / fallback / round-robin
&timeout=30000       # 毫秒
&referer=...         # 目标 Referer
&useragent=...       # 目标 User-Agent
不知道选哪个节点时使用 strategy=auto，服务会按延迟选择可用节点。

常见问题

Token 应该放在哪里？

可以放在 token 查询参数，或 x-proxy-token 请求头。能使用请求头时优先使用请求头，避免 token 出现在 URL 日志中。

为什么同一个请求有时节点不同？

strategy=auto 会在多个可用节点之间按延迟选择。需要固定出口时传入 node=节点名，或使用 strategy=manual。

支持 UDP 吗？

支持 VLESS TCP 上的 XUDP / UDP-over-TCP，入口是 POST /udp。它不是原生 UDP socket，Hysteria2、TUIC、WireGuard 这类传输层 UDP 协议不在当前范围内。

目标网站证书会校验吗？

会。访问 HTTPS 目标时执行证书链校验；节点自身的证书配置不会改变目标证书校验。

下一步