跳转到主要内容
开发者指南

从一次请求,
开始代理接入。

理解凭证、来源与有效期,先验证一条连接,再接入你的业务。
是否可提取、支持哪些协议,以账户中已开通的服务为准。

01 / GET STARTED

先完成这四步

  1. 登录自己的客户账户

    查看商品、订单与接入配置。仅注册账户,并不代表已经购买套餐或获得可用代理。

  2. 确认服务已经开通

    核对规格、支持协议、可用额度与到期时间。订单状态和服务开通状态需要分别确认。

  3. 获取当前有效的接入信息

    按套餐要求配置来源,使用对应的提取凭证,保存返回的接入地址、端口及授权有效期。

  4. 验证一个小请求

    向你有权访问的测试目标建立代理连接,核对响应与使用记录,再逐步增加业务请求。

进入客户工作台
02 / CREDENTIALS

不同凭证,各有用途

登录账户用于管理服务;提取 Key 用于获取接入信息;代理凭证用于建立具体连接。请按用途配置,不要把登录密码当作代理密码。

账户与接入信息对照
信息用于什么保管方式
客户账户登录工作台、查看订单和记录使用独立密码,结束使用后退出
提取 Key校验程序的提取请求按密钥保管,不分享完整提取链接
代理接入凭证连接实际代理地址与端口使用当前有效信息,留意到期时间
来源地址检查请求的公网来源填写应用服务器的实际公网出口
不要把密钥写进公开链接、截图或日志。

排查问题时保留请求号和错误信息,移除完整 Key、密码及含有凭证的 URL。来源白名单也不能代替账户与凭证校验。

03 / CONNECTION

提取信息与代理连接,分两步完成

提取请求返回当前接入信息;代理连接负责实际传输业务数据。请从工作台获取与你的套餐匹配的提取配置,避免混用其他账户或过期结果。

连接前准备

  • 接入地址与端口
  • 当前支持的协议与鉴权方式
  • 代理用户名和密码(若使用账密鉴权)
  • 本次结果的授权到期时间

以下是 HTTP 代理的 cURL 结构示例,仅说明参数位置。将占位符替换为已开通服务提供的真实信息,目标使用你自己的测试地址。

HTTP PROXY · cURL结构示例
curl --proxy 'http://<代理地址>:<代理端口>' \
  --proxy-user '<代理用户名>:<代理密码>' \
  'https://<你的测试目标>/'

白名单模式与账密模式的参数可能不同。此示例不表示当前账户已开通某个协议;请按实际返回的配置使用。

04 / SOURCE ACCESS

多台服务器,也要核对实际来源

来源地址是发起提取或代理连接的服务器公网出口 IP。它通常不是内网地址,也不一定是你当前打开网站的电脑地址;经过 NAT 时,多台机器可能共用同一出口。

自动添加来源

若套餐开启自动添加来源,每台服务器可携带有效提取 Key 发起请求,由系统根据实际观察到的公网来源按规则处理。批量部署前核对来源名额、有效期与限制;不要依赖客户端随意填写的 IP 字段。

  • 由实际运行程序的服务器执行首次提取
  • 确认自动来源规则已启用,且名额足够
  • 在工作台核对来源记录,并清理不再使用的地址
  • 同一提取链接需要妥善保管,发现泄漏及时处理
查看来源管理
05 / LIFETIME

三个时间与地址概念,分开理解

概念需要了解
套餐服务期限你的商品权益在哪段时间有效,以订单和权益记录为准。
本次连接授权本次接入结果有独立到期时间;刷新页面、重试查询不会自动续期。
出口 IP 持续时间由实际资源状态决定,不能从套餐期限直接推断固定不变。

接入端口与出口 IP 不是同一信息。同一端口的出口可能随设备变化,重新提取也不保证得到不同的 IP。设备掉线、授权过期或资源变化后,应按返回状态与产品规则重新处理。

06 / USAGE

以套餐口径核对账单与用量

不同商品可能按流量、次数、时长或实例计费。购买前确认单位、额度与期限,使用后查询对应记录。流量是累计数据量;带宽是传输速率,两者不能直接互相代替。

遇到订单、提取或实例操作超时,先查询原操作状态。超时不代表执行失败,重复创建可能产生新的操作。

查看账户用量
07 / TROUBLESHOOTING

连接失败时,按顺序检查

  1. 服务与额度

    服务是否已开通,当前是否过期,额度是否足够?

  2. 凭证与来源

    Key 是否用于正确入口,代理凭证是否有效,来源是否与实际公网出口匹配?

  3. 协议与网络

    协议、地址、端口和目标是否正确,运行机器是否能访问对应网络?

  4. 请求与返回

    保留时间、请求号、错误码和脱敏后的配置;对未知状态先查询,再决定重试。

需要继续排查?

带上脱敏后的错误信息与请求时间,提交问题。

提交工单