本页目录
很多开发者接入时容易混淆API 提取式短效 HTTP 代理和HTTP 隧道代理，两种模式获取 IP 的逻辑完全不一样，提取数量规则不能混为一谈。本文完整梳理巨量 IP HTTP 代理提取上限、接口限制、IP 生命周期、最佳调用方案。
一、先分清两种 HTTP 代理模式（核心区分）
1、按量短效 HTTP 代理（API 主动提取 IP 模式）
通过 API 接口调用获取一批 IP:端口，本地自建 IP 池管理。支持批量提取多条 IP。
2、长短效 HTTP 隧道代理
只提供固定网关地址，程序直连网关，云端自动轮换出口 IP。无法提取真实出口 IP 列表，不存在单次提取多少条 IP 一说。
二、单次提取数量上限规则
基础参数
API 请求参数 num 代表单次提取 IP 数量
• 取值范围：1～50
• 官方建议生产环境单次最大设置：50 条
推荐业务配置
1. 单线程、小规模脚本：num=1～5
2. 数十线程中型采集：num=10～20
3. 分布式集群大规模采集：num=20～50
重要补充
想要获取大于 50 条 IP，不能单次调高 num 参数，需要循环多次调用 API 接口分批拉取。
三、API 调用频率限制（极易踩坑）
单订单 API 请求频率管控标准：
✅单订单每秒请求不超过 5 次
❌高频循环不间断调用，会返回 429 限流，接口拒绝返回 IP
优化方案：
本地搭建 IP 缓存池（Redis / 内存队列），批量拉取 IP 存入缓存，消费缓存内 IP，降低 API 请求频次。
四、IP 生命周期与复用规则
1. API 提取得到的短效 HTTP IP 拥有固定存活时长（30 秒 / 1 分钟 / 3 分钟 / 5 分钟可选）；
2. IP 到期自动失效，不支持重复回收、重复使用；
3. 提前提取大量 IP 囤积，未及时使用会过期，额度正常消耗；
五、地域筛选配套规则
API 支持指定省份 / 城市定向提取：
• 单次请求仅支持填写一个省市；
• 开启地域定向不会改变单次提取上限（依旧最大 50 条）；
• 目标区域 IP 库存不足时，接口会尽可能返回该区域可用 IP，不足则返回结果数量小于 num 设定值。
六、分布式多服务器调取规范
1. 所有发起 API 请求的服务器外网 IP，全部添加至后台白名单；
2. 多台机器共用同一个 API 链接，总调用频率依旧遵循每秒≤5 次限制；
3. 大规模集群：建议拆分多个订单、多条独立 API 链接分散压力。
七、隧道代理补充说明（避免概念混淆）
巨量 IP 长效 / 短效 HTTP 隧道：
1. 没有提取 IP 的 API，不能导出真实出口 IP；
2. 不存在 “单次提取多少 IP”；
3. 由网关自动在云端轮换出口，并发上限由隧道套餐规格决定；
4. 适合不想维护本地 IP 池、7×24 持续采集项目。
八、高频接入踩坑清单
❌坑 1：试图将 num 设置超过 50，接口直接报错
❌坑 2：无限循环高频调用 API，触发 429 限流
❌坑 3：一次性提取几百条 IP 囤积，大量 IP 超时失效，浪费额度
❌坑 4：混淆隧道代理与 API 提取代理，尝试通过隧道接口获取出口 IP 清单
❌坑 5：多服务器分布式调用，部分机器未添加白名单，请求被拦截
❌坑 6：开启城市定向，误以为无论库存多少，一定会返回设定 num 数量 IP
九、全文总结
巨量 IP 按量短效 HTTP 代理 API 单次最大提取 50 条 IP，num 参数区间 1–50；超出数量需要循环分批请求，同时严格控制 API 调用频率，单订单每秒请求不高于 5 次。
开发选型建议：自研本地 IP 池、大批量普查场景选用 API 提取短效 HTTP；不想维护 IP 池、长期持续采集业务优先 HTTP 隧道代理。上线前按照业务线程规模设置合理单次提取数量，搭配缓存机制，减少接口压力、降低 IP 额度损耗。
FAQ常见问题
Q1：单次提取数量设置 50，接口一定会返回 50 个 IP 吗？
A：不一定。如果选定区域当前可用库存不足，返回数量会少于设定值，程序需要做好判空与重试逻辑。
Q2：提取出来的 IP 可以多次反复发起请求吗？
A：IP 在存活时长内可以持续使用，到期失效；短效 IP 过期后无法继续使用，需要重新调用 API 拉取新 IP。
Q3：能不能提高 API 每秒请求次数上限？
A：常规套餐遵循统一频控；企业大额采购场景，可以联系运维评估业务规模协商适配方案。
Q4：静态独享 HTTP IP 也是用这套 API 提取规则吗？
A：静态 IP 为固定资源，后台支持批量导出清单，调用接口逻辑与短效动态 IP 提取接口相互独立，规则不一致。