登录 免费注册

隧道代理IP套餐5个IP白名单,安全配置说明完整详细

发布时间:2026年11月19日 · 全文约 3720 字 · 预计阅读 10 分钟

本页目录


    一、白名单是隧道代理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先做过小流量连通与轮换测试