🚀 对外 API 使用方式
推荐使用 Forward API(走 Clash 集群,IP 自动轮换),代理池 API 为旧接口。
🎯 Forward API(走 Clash 集群)
GET /api/forward?token=API_TOKEN
→ 返回 {proxy_url, node_used, controller_url},拿到地址自己用,每次自动换节点
POST /api/forward?token=API_TOKEN
Body: {"url":"https://httpbin.org/ip","timeout":15}
→ ProxyHub 代你请求,返回 {status_code, body, node_used}
GET /api/forward/health?token=API_TOKEN
→ 检查 Clash 集群状态和可用节点数
用法示例:先 GET 取代理地址 http://172.18.0.1:41001,再用 curl --proxy http://172.18.0.1:41001 https://目标URL 访问。适合浏览器、Selenium、requests 等任何支持 HTTP 代理的工具。
📦 Proxy Pool API(旧代理池)
GET /api/proxy/next?token=API_TOKEN®ion=JP&consumer=my-service
POST /api/proxy/report?token=API_TOKEN
Body: {"proxy_url":"http://...","success":true}
GET /api/proxy/stats?token=API_TOKEN
参数说明:region=JP/US/IN/BR/ID(可选),network=external/internal/all(默认external),consumer=调用方名称(可选)