SuperAPI AI 工具集

byo-proxy

通用与其它

查看项目

更新于 10-16 01:11

技能介绍

用途:让用户使用自己的代理账号(目前为 IPRoyal),为不同技能绑定国家/会话/固定 IP,实现按需路由。它本身不运行代理服务器、不拦截流量,只是配置中心加 URL 生成器;其他技能只有显式导入 exports.py 才会受影响。

主要能力:支持两类代理。iproyal 网关(geo.iproyal.com:12321)可轮换,也可用 session 加 sticky 实现最长 7 天的粘性会话;iproyal-isp 为按 IP 计费的专用静态 IP,端点形如 host:port,永不变化。凭据存于 /data/workspace/.env(IPROYAL_USERNAME、IPROYAL_PASSWORD),绑定与 ISP 代理清单存于 /data/workspace/.byo-proxy.json,均只通过脚本编辑。

使用方式:常用命令包括 python3 $SKILL/scripts/onboard.py web-crawler --provider iproyal --country jp 一次性注册并绑定测试;setup_provider.py 注册网关凭据;bind_skill.py 设置或取消绑定,可加 --session 与 --sticky 360;add_isp_proxy.py 注册/列出/删除专用 IP;list_providers.py 查看状态;test_proxy.py 验证出口 IP。其他技能可调用 get_proxy_url 或 get_proxy_for_skill,未配置时抛 ProxyNotConfiguredError,其消息即完整引导。

适用场景:需要住宅 IP、付费账号、超出 sc-vpn 18 国范围的国家粒度,或专用固定 IP 时。限制:仅支持 IPRoyal;sticky_minutes 需 1..10080 且必须配合 session;禁止导出全局 HTTP_PROXY,只能按请求传 proxies;未配置不会静默回退直连。更多提供商需自行扩展 PROVIDERS 与 URL 构建器。