本页目录

一、白名单是隧道代理IP的第一道门
隧道代理IP不用在本地维护 IP 列表:买好套餐、配一次固定网关,云端自动换出口 IP 。也正因为入口是固定的, “ 谁有权连这个网关 ” 必须提前登记 —— 白名单就是这道登记。官方故障排查教程写得很直接:多设备连接失败,大多集中在白名单、长连接、会话模式三类设置错误上,其中白名单漏填排第一位。
单订单最多5个白名单 IP : 按业务服务器公网 IP 逐个录入,适合多服务器分布式接入;后台页面也支持 “ 快速添加当前 IP” 一键识别本机公网地址。
重复IP同样占名额: 同一个出口 IP 添加两次不会变成两个授权,别靠重复填凑数量,这是最常见的无效操作。
免费、支持批量导入: 白名单本身不收费,分布式集群可一次性把多台服务器公网 IP 批量导入,统一管理。
生效时间: 保存后一般即时生效,官方双授权教程按 “10 秒内生效 ” 给出,接口侧也有秒级返回。改完先测一次连通再上生产,别直接跑任务。
填公网出口IP,不是内网 IP : 192.168、 10 段这类内网地址网关看不到,填了照样连不通。云主机在 NAT 后面时,以 curl 查到的公网地址为准。
一条容易混淆的边界:白名单是 “ 授权机器数量 ” ,不是并发上限。同一条隧道代理IP可以多路复用,并发量看的是所购带宽档位,不看白名单填了几个。
二、隧道代理IP介绍:三种鉴权模式先定一个
隧道代理IP后台的鉴权方式有三档可选,安全等级和适用场景差别很大,先定模式再配客户端,别等接入完再回头改 —— 改模式会影响所有已配置的接入端。
|
模式 |
客户端要带什么 |
适用场景 |
安全要点 |
|
IP白名单免密 |
只填网关地址+端口 |
公网IP固定的云服务器、机房集群 |
请求不带凭据,密码泄露风险最低 |
|
账号密码 |
配置里带隧道代理IP账号密码 |
动态出口IP、移动办公、容器化环境 |
凭据随请求传输,需妥善保管 |
|
白名单+账密双授权 |
白名单与账密同时满足 |
生产环境、多人协作、敏感业务 |
两层校验,安全等级最高 |
双授权的逻辑是:请求来源 IP 必须在后台白名单内,同时请求携带正确的账号密码,两层校验全部通过才能连通。
它解决的实际问题是: 生产服务器 IP 固定可以进白名单,但账密一旦泄露,外部 IP 拿去也用不了,等于给凭据加了一道来源锁。官方也把 “ 本地调试与线上服务器共用一条隧道代理IP ” 列为双授权的典型用法。
必须知道的坑: 开启双授权后,所有连接都要同时满足两个条件,不能一部分机器免密、一部分走账密。真有这种需求,只能新建第二条隧道代理IP分开配。
常规隧道代理IP是二选一: 要么白名单免账密,要么仅账密鉴权。双授权是更高一档的组合,不是默认状态。
选哪个模式不用为性能纠结:校验逻辑在网关层处理,三种模式的延迟差异极小,按安全需求选就行。
三、5个名额怎么分
固定 IP 的云主机一台占一个名额, 5 个其实很快用完。三种分法对应三种业务形态:
按机器分(最常规)
每台业务服务器一个名额,5 台以内刚好够用;集群超过 5 台,就要靠账密兜底或拆隧道解决,而不是把名额塞满临时机器。
按业务线分(推荐)
不同目标站点、不同业务各建一条独立隧道代理IP,白名单分开授权。 好处是 IP 污点不交叉污染,一条业务出问题不牵连其他,排查时也一眼能定位。
官方最佳实践里同样建议: 不同业务站点分开创建独立隧道代理IP,避免 IP 互相污染;分布式集群用批量导入统一管白名单。
按环境分
生产环境走白名单或双授权,开发测试与临时调试走账密,不占白名单名额。 账密模式无需添加白名单,适合出口 IP 会变的弹性环境。
名额不够时的正确解法不是压缩安全配置,而是横向加隧道代理IP。批量通道有赠时长:3–5 条通道额外赠 15% 使用时长, 6 条及以上额外赠 25% 使用时长并配专属技术对接,年度框架可谈全品类折扣。加通道既扩了授权容量,也顺手做了业务隔离。
四、安全配置六步走
把顺序走对,可以省掉后面 80% 的排查时间:
第一步,建隧道代理IP时就把鉴权方式选好。 别等接入后再改,改模式会影响所有已配置的客户端。
第二步,查机器公网出口 IP 再录入。 不是内网 IP;分布式集群一台都不能漏,支持批量导入。
第三步,凭证单独保管。 网关地址、端口、账号、密码复制后存进密钥管理,别硬写进代码仓库、截图或共享日志。
第四步,双授权场景下账密必带。 只加白名单不带账密,结果是 407;漏带一个条件就连通不了。
第五步,开启污点 IP 自动清洗。 自动过滤黑名单与高延迟节点,减少业务侧的无效报错。
第六步,按业务拆独立隧道代理IP。 不同站点、不同业务线互相隔离,出问题不影响全局。
还有一条收尾动作:新隧道代理IP先小流量测试,确认连通、IP 轮换稳定之后再跑正式任务。官方配置教程把这条列为最佳实践,原因很实在 —— 隧道代理IP类问题在正式任务里暴露,往往已经烧掉一段时间,还分不清是配置错还是脚本错。
五、凭证管理细则
账密可随时在后台自助重置,但重置后所有接入端必须同步更新。 这是多人协作时最常见的断流原因:后台改了密码,服务进程还存着旧值,表现就是 “ 密码看着对却一直 407” 。
不要把带真实密码的代理 URL 放进工单、截图或代码仓库。 排查时贴日志,先做脱敏处理,账号与密码部分打码。
多人共用一份配置时,先约定改密流程。 谁改、什么时候改、怎么通知,写成一句话规则就能避免大半次夜间故障。
企业矩阵可开后台子账号分权。 运营、采集分开管控用量,财务独立对账,不必共享一套主账密。
项目暂停、非工作时段开套餐冻结。 隧道代理IP按周期计时,冻结能停掉这段消耗,闲置期不白烧。
六、报错与安全自查对照表
|
报错/现象 |
根因 |
处理 |
|
407 鉴权失败 |
账密错误;或双授权模式下没带账密 |
后台核对账密,配置里补齐凭据 |
|
403 拒绝访问 |
账密正确,但当前设备公网 IP 不在白名单 |
查本机公网 IP,加进白名单等生效 |
|
持续 407 |
白名单没加;或账密复制时带了空格 |
从后台重新复制账密,公网 IP 补进白名单 |
|
连接超时 |
安全组/防火墙拦截、地址端口填错、并发超上限 |
放行出站端口,核对网关地址与并发配额 |
|
能连通但 IP 不换 |
开了会话锁 IP;或长连接复用同一出口 |
短效模式选 “ 每次请求换 IP” ,请求头加 Connection: close |
|
白天稳、晚间大量超时 |
晚高峰网络波动、并发压得太满 |
下调并发,城市定向优先选热门省市节点 |
排查成本上有个好消息:单纯的鉴权失败、TCP 连接失败不消耗套餐流量,成功转发到出口 IP 之后产生的请求才计费。所以放心先做连通测试,不用担心白烧额度。
七、接入验证片段
先 curl 单独测通,再接生产脚本。脚本一上来就报错,很难分清是配置问题还是代码问题。
# 1) 先查本机公网出口IP —— 这个才是要填白名单的地址
curl -s https://ipinfo.io/ip
# 2) 白名单免密模式:不带账密,能返回出口IP即授权通过
curl -x http://隧道地址:端口 https://ipinfo.io/ip
# 3) 账密 / 双授权模式:必须带账密
curl -x http://账号:密码@隧道地址:端口 https://ipinfo.io/ip
# 4) SOCKS5 场景用 socks5h,域名解析也走代理侧,避免本地DNS泄露
curl -x socks5h://账号:密码@隧道地址:端口 https://ipinfo.io/ip
import requests
# 白名单免密:只填网关地址+端口
proxies_white = {
"http": "http://隧道地址:端口",
"https": "http://隧道地址:端口",
}
# 账密 / 双授权:必须带账号密码
proxies_auth = {
"http": "http://账号:密码@隧道地址:端口",
"https": "http://账号:密码@隧道地址:端口",
}
s = requests.Session()
s.headers.update({"Connection": "close"}) # 短效隧道必须关长连接
r = s.get("https://ipinfo.io/ip", proxies=proxies_auth, timeout=(8, 15))
print(r.status_code, r.text)
第 4 步的 socks5h 值得单独说一句:用 socks5 时域名在本机解析,出口 IP 和解析结果可能来自两地;换成 socks5h 把解析交给代理侧,验证结果才真实反映隧道代理IP出口。短效隧道代理IP则务必加 Connection: close ,否则长连接复用会让 IP 看起来 “ 一直不换 ” 。
八、采购前安全自查表
□ 已确定用白名单、账密还是双授权,三选一而不是含糊着先跑起来
□ 每台业务机器填的是公网出口 IP ,没有 192.168 、 10 段这类内网地址
□ 5 个名额够用;不够已规划走账密兜底或横向加隧道代理IP
□ 账密存在密钥管理里,没有进代码仓库、截图和工单
□ 不同业务线已拆独立隧道代理IP,白名单分开授权
□ 双授权场景下所有接入端都带了账密
□ 污点 IP 自动清洗已开启
□ 并发预留 20% 余量,没有跑满所购带宽档的上限
□ 密码重置后有同步机制通知所有接入端
□ 新隧道代理IP先做过小流量连通与轮换测试