白名单配置
短效代理通过白名单 IP 鉴权:只有加入白名单的机器,才能真正使用代理服务器转发流量。
白名单在哪个环节生效
Section titled “白名单在哪个环节生效”这是最容易误解的一点,先说清楚:
- 提取 IP 列表(调用 API 拿到
host:port)—— 不校验白名单。不管有没有加白名单,接口都会正常返回 IP 列表 - 使用代理发请求(把
host:port配置给你的程序)—— 校验白名单。发起请求的机器出口 IP 不在白名单里,代理会拒绝转发
所以典型的故障现象是:API 调得通、IP 列表也拿到了,但一用这些代理就连不上。这几乎都是白名单没加,或者机器的出口 IP 变了。
- 登录用户中心,进入左侧菜单【白名单】
- 页面顶部提示区会直接显示你当前的 IP 地址——如果就是用这台机器跑业务,直接填它即可
- 点击【添加白名单】,填入要放行的公网 IP
填什么 IP
Section titled “填什么 IP”要填的是发起代理请求那台机器的公网出口 IP,不是代理服务器的 IP,也不是内网地址。
以下类型的地址不能添加:
- 本地地址,如
127.0.0.1 - 保留地址,如
0.0.0.0 - 局域网地址,如
192.168.0.1、10.0.0.1
如果你不确定服务器的出口 IP,在那台机器上执行一次带出口探测的请求即可,或直接看白名单页面显示的当前 IP(前提是你正从这台机器访问用户中心)。
白名单名额怎么算
Section titled “白名单名额怎么算”名额由两部分相加:
可用名额 = 5(基础名额,账号固定) + 3 × 未过期的短效代理订单数- 基础名额 5 个:注册即有,与是否购买无关
- 每个未过期的短效代理订单额外 +3 个
需要特别注意「未过期」这个前提:订单一旦到期,它带来的那 3 个额外名额会立即被收回。如果你把名额用满了,订单过期后会出现「已添加的白名单条数超过当前名额」的情况,续费后名额即恢复。
举例:1 个有效订单 → 5 + 3 = 8 个;3 个有效订单 → 5 + 9 = 14 个;订单全部过期 → 只剩 5 个。
出口 IP 会变怎么办
Section titled “出口 IP 会变怎么办”如果你的机器使用动态公网 IP(家庭宽带、部分云厂商的弹性公网),IP 变化后原来的白名单就失效了,需要重新添加。名额有限时,可以先删掉已失效的旧记录再添加新的。
对固定业务,建议使用固定公网 IP 的服务器,避免频繁维护白名单。
- 回到 快速开始指南 继续接入流程
- 查看 Token 管理与安全 了解
user_token的保管与重置