CFspider Workers API 文档
CFspider Workers 提供 VLESS 代理服务和 HTTP API 接口。
部署方式
方式 1：Wrangler CLI
bash
# 安装 wrangler
npm install -g wrangler
# 登录 Cloudflare
wrangler login
# 部署 Workers
npx wrangler deploy workers.js --name cfspider方式 2：Cloudflare Dashboard
- 登录 Cloudflare Dashboard
- 进入 Workers & Pages
- 点击 Create Worker
- 粘贴 workers.js 代码
- 点击 Deploy
环境变量
| 变量名 | 必填 | 说明 |
|---|---|---|
UUID |
否 | 自定义 VLESS UUID，不设置则使用默认值 |
TWO_PROXY |
否 | 第二层代理配置，格式：host:port:user:pass |
设置环境变量
bash
# 设置 UUID
echo "your-uuid-here" | npx wrangler secret put UUID --name cfspider
# 设置双层代理
echo "host:port:user:pass" | npx wrangler secret put TWO_PROXY --name cfspiderGET /api/fetch
通过 Workers 代理获取目标 URL 的内容。
请求
HTTP
GET /api/fetch?url=https://example.com HTTP/1.1
Host: your-workers.dev参数
| 参数 | 类型 | 说明 |
|---|---|---|
url |
string | 目标 URL（需要 URL 编码） |
响应
返回目标 URL 的原始内容。
示例
bash
curl "https://your-workers.dev/api/fetch?url=https://httpbin.org/ip"GET /api/json
通过 Workers 代理获取 JSON 数据。
请求
HTTP
GET /api/json?url=https://httpbin.org/ip HTTP/1.1
Host: your-workers.dev响应
JSON
{
"origin": "104.28.xxx.xxx"
}GET /api/config
获取 Workers 配置信息。
请求
HTTP
GET /api/config HTTP/1.1
Host: your-workers.dev响应
JSON
{
"uuid": "c373c80c-58e4-4e64-8db5-40096905ec58",
"host": "your-workers.dev",
"port": 443,
"path": "/c373c80c-58e4-4e64-8db5-40096905ec58",
"is_custom_uuid": false,
"two_proxy_enabled": true,
"two_proxy_host": "us.example.com",
"two_proxy_port": "3010"
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
uuid |
string | VLESS UUID |
host |
string | Workers 域名 |
port |
number | 端口号（通常为 443） |
is_custom_uuid |
boolean | 是否使用自定义 UUID |
two_proxy_enabled |
boolean | 是否启用双层代理 |
two_proxy_host |
string | 第二层代理地址 |
two_proxy_port |
string | 第二层代理端口 |
GET /api/pool
获取当前 IP 池信息。
请求
HTTP
GET /api/pool HTTP/1.1
Host: your-workers.dev响应
JSON
{
"ip": "104.28.xxx.xxx",
"colo": "NRT",
"country": "JP",
"city": "Tokyo"
}GET /api/status
获取 Workers 运行状态。
请求
HTTP
GET /api/status HTTP/1.1
Host: your-workers.dev响应
JSON
{
"status": "online",
"version": "1.8.4",
"colo": "NRT",
"country": "JP"
}VLESS 连接
Workers 支持标准 VLESS 协议，可用于 v2ray 客户端。
连接参数
| 参数 | 值 |
|---|---|
| 地址 | your-workers.dev |
| 端口 | 443 |
| UUID | 从 /api/config 获取 |
| 传输协议 | WebSocket |
| 安全协议 | TLS |
| Path | /{uuid} |
| 加密方式 | none |
VLESS 链接格式
可直接导入 v2ray 客户端的链接格式。
标准格式
text
vless://{uuid}@{host}:443?security=tls&type=ws&host={host}&sni={host}&path=/{uuid}&encryption=none#{name}示例
text
vless://c373c80c-58e4-4e64-8db5-40096905ec58@your-workers.dev:443?security=tls&type=ws&host=your-workers.dev&sni=your-workers.dev&path=%2Fc373c80c-58e4-4e64-8db5-40096905ec58&encryption=none#CFspider双层代理
Workers 支持通过第二层代理访问目标网站。
流量路径
客户端
→
CF Workers
→
第二层代理
→
目标网站
VLESS 链接格式（带双层代理）
text
vless://{uuid}@{host}:443?...&path=/{uuid}?two_proxy={proxy_config}...其中 proxy_config 格式为：host:port:user:pass（URL 编码）
UUID 配置
可以通过环境变量自定义 UUID，提高安全性。
设置自定义 UUID
bash
# 生成随机 UUID
uuidgen
# 设置到 Workers
echo "your-new-uuid" | npx wrangler secret put UUID --name cfspider设置自定义 UUID 后，Workers 首页会显示警告，提醒用户需要手动填写 UUID。
双层代理配置
在 Workers 中配置第二层代理。
配置格式
text
# 完整格式（带认证）
host:port:username:password
# 简单格式（无认证）
host:port设置方式
方式 1：Wrangler CLI
bash
echo "us.example.com:3010:username:password" | npx wrangler secret put TWO_PROXY --name cfspider方式 2：Cloudflare Dashboard
- 进入 Workers & Pages
- 选择你的 Worker
- 点击 Settings → Variables
- 添加环境变量
TWO_PROXY - 设置值为
host:port:user:pass - 勾选 Encrypt
验证配置
配置成功后，访问 Workers 首页会显示双层代理状态为"已启用"。
也可以通过 /api/config 接口检查 two_proxy_enabled 字段。