本页目录
巨量IP动态代理包量套餐采用 IP 白名单鉴权机制，只有添加到订单白名单内的外网 IP ，才允许调用 API 提取 IP 额度，用于保护账户额度安全，防止额度被盗用。包量套餐 单个订单最多可添加5个外网白名单 IP ，适合多服务器分布式采集。如果服务器数量超过5台，需要新增包量订单分开管理。下面完整讲解白名单查询、后台配置、 API 管理、验证与排障全流程。
一、前置准备：查询设备外网IP
|
注意： 需要填写外网公网IP，不是本机内网 IP （ 192.168 开头） |
本地电脑： 打开IP查询网站，直接查看本机出口公网 IP 。后台白名单页面也支持一键识别当前机器外网 IP ，快速添加。
云服务器： 登录服务器控制台，查看服务器公网IP。服务器重启、网络切换后，外网 IP 有可能发生变更，需要重新更新白名单。
记录所有采集机器的公网IP，后续统一录入后台。
二、后台可视化手动添加白名单（推荐新手）
登录巨量IP官网后台，进入【产品管理】 → 【动态代理（包量）】，找到已购买的包量订单，点击【生成提取链接】进入 API 配置页面。
在配置页面找到【修改白名单】按钮，打开白名单弹窗。
添加IP： 可以点击【快速添加当前IP】一键录入本机公网 IP ；多台服务器手动输入多个公网 IP ，一行填写一个 IP 地址。
核对数量上限： 单订单上限5个白名单 IP ，超出无法保存。
点击确认修改，等待1~3分钟生效。
生效完成，复制API链接，浏览器或者脚本调用测试，确认可以正常提取 IP 。
三、API接口管理白名单（适合自动化运维）
企业集群场景，可以直接调用接口，代码动态增删白名单IP，无需登录后台手动操作。
|
参数项 |
说明 |
|
接口地址 |
v2.api.juliangip.com/company/dynamic/setwhiteip |
|
请求方式 |
GET / POST |
|
入参 |
trade_no：包量订单号 ips：多个 IP 用英文逗号分隔 sign：账号签名信息 |
|
功能 |
支持读取白名单列表、批量新增、删除、清空白名单 |
|
适用场景： 服务器弹性伸缩，机器IP动态变化，程序自动维护白名单清单。 |
四、白名单使用规则详解
数量限制：单个包量订单最多绑定5个外网 IP ，5台机器可共用一份包量额度；集群服务器大于 5 台，建议采购多个包量订单分开配置白名单。
权限逻辑： 白名单内所有机器共享该订单总额度，多机并发调用API，统一扣减包量 IP 额度。
免费功能： 白名单配置、修改、删除全部免费，不额外收取服务费。
网络变动： 云服务器重启、宽带重拨，外网IP会变化，旧 IP 失效，需要及时删除旧 IP 并添加新外网 IP ，否则调用 API 报 407 。
安全建议： 不再使用的服务器IP，及时从白名单内删除，降低账户额度被盗用风险。
五、白名单生效验证步骤
白名单添加完成后，务必做连通测试，避免业务上线报错。
使用当前机器浏览器，直接打开后台生成的API提取链接。
正常情况： 页面直接返回IP代理列表，成功扣减 IP 额度。
异常情况： 返回407鉴权失败 → 白名单未生效或者 IP 填写错误。
|
提示： 白名单保存后存在1~3分钟缓存延迟，保存后不要立刻大批量并发调用，等待生效后再测试。 |
六、常见报错排查
|
报错现象 |
原因 |
解决方法 |
|
407 Proxy Authentication Required |
当前机器外网IP不在订单白名单； IP 填写错误；白名单还未生效；服务器外网 IP 变更 |
进入白名单页面核对IP，删除失效 IP ，重新添加，等待生效重试 |
|
保存提示白名单数量超限 |
单订单已添加满5个外网 IP |
删除闲置旧IP，或者新增包量订单 |
|
API偶尔成功、偶尔 407 |
服务器出口IP发生轮换 |
检查云服务商网络策略，固定服务器公网IP |
|
白名单IP正确但仍无法调用 |
服务器防火墙、安全组拦截 |
检查服务器防火墙、安全组是否放行对外出站请求 |
FAQ 常见问题
Q1：包量套餐白名单和包时套餐白名单规则一样吗？
A：规则一致，单订单上限 5 个外网 IP ，鉴权逻辑相同。
Q2：白名单添加的是代理 IP 还是服务器本机外网 IP ？
A：填写 业务服务器/本地电脑的外网出口 IP ，不是提取出来的住宅代理IP。
Q3：更换办公网络后，本地电脑需要重新添加白名单吗？
A：需要，换网络后本机外网 IP 改变，旧白名单 IP 失效，需要重新添加当前外网 IP 。
Q4：多个包量订单，白名单相互独立吗？
A：相互独立。 A 订单的白名单 IP ，不能直接访问 B 订单 API ，需要分别在各自订单配置白名单。