跳转到内容

白名单配置

短效代理通过白名单 IP 鉴权:只有加入白名单的机器,才能真正使用代理服务器转发流量。

这是最容易误解的一点,先说清楚:

  • 提取 IP 列表(调用 API 拿到 host:port)—— 不校验白名单。不管有没有加白名单,接口都会正常返回 IP 列表
  • 使用代理发请求(把 host:port 配置给你的程序)—— 校验白名单。发起请求的机器出口 IP 不在白名单里,代理会拒绝转发

所以典型的故障现象是:API 调得通、IP 列表也拿到了,但一用这些代理就连不上。这几乎都是白名单没加,或者机器的出口 IP 变了。

  1. 登录用户中心,进入左侧菜单【白名单】
  2. 页面顶部提示区会直接显示你当前的 IP 地址——如果就是用这台机器跑业务,直接填它即可
  3. 点击【添加白名单】,填入要放行的公网 IP

要填的是发起代理请求那台机器的公网出口 IP,不是代理服务器的 IP,也不是内网地址。

以下类型的地址不能添加:

  • 本地地址,如 127.0.0.1
  • 保留地址,如 0.0.0.0
  • 局域网地址,如 192.168.0.110.0.0.1

如果你不确定服务器的出口 IP,在那台机器上执行一次带出口探测的请求即可,或直接看白名单页面显示的当前 IP(前提是你正从这台机器访问用户中心)。

名额由两部分相加:

可用名额 = 5(基础名额,账号固定) + 3 × 未过期的短效代理订单数
  • 基础名额 5 个:注册即有,与是否购买无关
  • 每个未过期的短效代理订单额外 +3 个

需要特别注意「未过期」这个前提:订单一旦到期,它带来的那 3 个额外名额会立即被收回。如果你把名额用满了,订单过期后会出现「已添加的白名单条数超过当前名额」的情况,续费后名额即恢复。

举例:1 个有效订单 → 5 + 3 = 8 个;3 个有效订单 → 5 + 9 = 14 个;订单全部过期 → 只剩 5 个。

如果你的机器使用动态公网 IP(家庭宽带、部分云厂商的弹性公网),IP 变化后原来的白名单就失效了,需要重新添加。名额有限时,可以先删掉已失效的旧记录再添加新的。

对固定业务,建议使用固定公网 IP 的服务器,避免频繁维护白名单。