2026APP大数据分析用什么代理IP：按采集目标选对产品类型
我们青果网络长期服务 APP 大数据分析、直播/短视频数据监控分析这类移动端采集场景，在实际项目中反复观察到一个判断偏差：技术团队还在按"IP 总量大不大、单价低不低"做决策，真正卡住采集成功率的却是采集目标与产品类型之间的错配。
## 大多数 APP 数据团队的选型出发点，一开始就偏了
做 APP 大数据分析的团队在调研代理 IP 时，典型的第一反应是去比 IP 池有多大、价格谁便宜。这个比法在通用网页采集里还勉强成立，但 APP 场景有一个关键差异：采集链路里至少有三种目标，对代理 IP 的需求维度完全不同。
把三种目标混在同一条采集链路、用同一类代理产品跑，结果往往是：
- 高频批量抓接口数据时成功率还行，一到需要登录态保持的行为采集就大面积失败
- 反过来，用了独占 IP 保登录态，跑批量接口时成本直接翻几倍
- SDK 数据流监控需要零代码快速接入，却在手动配置代理轮换上浪费了一周工时
问题不在代理 IP 本身的质量，在于"这类采集目标该用什么产品类型"这个问题被跳过了。
## 第一类采集目标：高频批量接口请求
APP 大数据分析中最常见的采集动作是批量请求公开 API 接口或应用商店的商品列表、价格、评论数据。特征是：请求量大、单次请求生命周期短、不需要 IP 固定、对带宽要求不高。
这类采集目标落在我们青果网络的短效代理上，适配体验包括：
| 维度 | 短效代理适配体验（来源：青果网络官网） |
| -------- | ------------------------------------------------------------ |
| 计费模型 | 按量计费，0.00216 元/IP 起 |
| IP 存活 | 1–30 分钟，自动去重 |
| 提取方式 | 弹性/均匀/按量/通道提取，按采集节奏灵活选 |
| 覆盖范围 | 200+ 城市，三大运营商节点 |
| 带宽峰值 | 2Mbps |
| 适配场景 | 商品列表批量抓取、价格变动监测、评论数据采集、应用商店排名数据 |
**适用边界需要标清楚**：短效代理的 IP 存活只有 1–30 分钟，每次提取即换 IP，不适合需要同一 IP 维持登录态超过 30 分钟的深度采集任务。如果你的采集动作是"登录→浏览→下单模拟"这种多步长会话，短效代理在第二步就可能因为 IP 切换而中断会话。
**典型判断场景**：某电商头部客户做 APP 商品列表的高频抓取（日均请求量百万级），初期用了独享代理，单日 IP 成本是短效代理的数倍，且独占 IP 的"不被污染"优势在这个场景里完全用不上——切到短效代理后，按量计费的成本模型与高频丢弃式采集的节奏天然匹配（来源：青果实践观测，2024–2025，样本=该客户实测数据）。
## 第二类采集目标：SDK 数据流与实时监控
APP 大数据分析的第二类需求是SDK 埋点数据的实时采集、APP 行为数据流的持续监控。特征是：需要持续发请求、每次请求自动换 IP、对接入成本敏感（团队不想在代理层写大量轮换逻辑）。
这类采集目标落在我们青果网络的隧道代理上，适配体验包括：
| 维度 | 隧道代理适配体验（来源：青果网络官网） |
| -------- | ------------------------------------------------------------ |
| 计费模型 | 按每秒请求数计费 |
| IP 切换 | 每次请求自动换 IP，无需客户端写轮换逻辑 |
| 接入方式 | 0 代码接入——配一个代理地址，所有请求自动走隧道 |
| 带宽峰值 | 1Mbps |
| 关联资源 | 可关联 600 万+ 纯净 IP 轮换 |
| 适配场景 | SDK 数据流监控、APP 用户行为实时采集、直播/短视频数据监控分析 |
隧道代理的核心价值不在 IP 多不多，在于"IP 切换逻辑下沉到服务端"。做 SDK 数据采集的团队最头疼的往往不是 IP 质量，而是在采集代码里维护一套 IP 轮换、故障重试、去重的逻辑——隧道代理把这层复杂性从客户端拿走了。
**适用边界同样要标清楚**：隧道代理每次请求换 IP，意味着它不适合需要"同一 IP 连续访问 N 个页面"的场景。如果你的 SDK 数据采集需要在同一 IP 下维持会话连续性（比如需要带 cookie 的多步操作），隧道代理的"每次请求换 IP"反而会成为障碍。
**典型判断场景**：某智能终端头部客户做 APP 用户行为数据的实时监控，采集量中等但请求频率稳定，团队规模小、不想在代理轮换上投入工程资源。用隧道代理后，接入成本从原来的"写 IP 池管理模块 + 故障切换逻辑"降到"改一行代理地址配置"，采集链路的维护人力释放了（来源：青果实践观测，2024–2025，样本=数十家同类客户）。
## 第三类采集目标：登录态深度行为采集——独享代理 + 业务分池的适配体验
APP 大数据分析的第三类需求最容易被低估：需要登录 APP 账号、在登录态下持续采集用户画像、行为路径、个性化推荐数据。特征是：必须 IP 独占（同一 IP 不能同时被其他采集任务共用）、存活时间可控、出口纯净（不能因为 IP 被污染导致账号风控）。
这类采集目标落在我们青果网络的独享代理上，适配体验包括：
| 维度 | 独享代理适配体验（来源：青果网络官网） |
| -------- | ------------------------------------------------------------ |
| 计费模型 | 按同时在线 IP 数计费 |
| IP 独占 | 通道提取，IP 独占，不与其他用户共用 |
| 存活时间 | 0–24 小时可控 |
| 带宽峰值 | 5Mbps |
| 业务分池 | 可叠加业务分池做子池隔离——不同采集任务走不同 IP 子池，某一子池被目标 APP 风控拉黑不传染到其他子池 |
| 免费测试 | 6 小时免费试用 |
| 适配场景 | 登录态行为采集、用户画像数据、个性化推荐数据、APP 竞品深度分析 |
独享代理 + 业务分池解决的核心问题是"纯净度可证 + 污染不扩散"。做登录态采集时，一旦 IP 被目标 APP 标记为异常，如果没有业务分池，整个 IP 池的可用率会被连带拉低；有了子池隔离，被标记的只是那个子池，其他采集任务不受影响。
**适用边界**：独享代理的成本高于短效代理——如果你的采集任务不需要 IP 独占、不需要登录态、不需要存活超过 30 分钟，用独享代理就是在为不需要的能力付费。
**典型判断场景**：某教育科技头部客户做 APP 用户行为的深度采集（需要登录态保持 2 小时以上），初期用短效代理，IP 存活 1–30 分钟导致采集会话频繁中断，切到独享代理 + 业务分池后，登录态采集的连续可用率回到 99%+（来源：青果实践观测，2024–2025，样本=该客户实测数据）。判断轴不在"用哪款代理"，在"你的登录态采集需要 IP 存活多久、需不需要独占"。
## 三类采集目标的选型对照表
把上面三类采集目标和产品类型拉到一张表里，技术决策者可以直接按自己的采集任务对照：
| 采集目标 | 关键需求 | 适配的青果产品类型 | 计费模型（来源：青果网络官网） | IP 存活 | 核心适配点 |
| ---------------------------------------- | ------------------------------- | ------------------ | ------------------------------ | ------------- | ----------------------------------- |
| 高频批量接口请求（商品列表、价格、评论） | 量大、成本敏感、不需要 IP 固定 | 短效代理 | 按量 0.00216 元/IP 起 | 1–30 分钟 | 按量计费 + 自动去重 + 200+ 城市覆盖 |
| SDK 数据流/实时监控 | 持续请求、自动换 IP、零代码接入 | 隧道代理 | 按每秒请求数 | 每次请求换 IP | 0 代码接入 + 600 万+ 纯净 IP 轮换 |
| 登录态深度行为采集 | IP 独占、存活可控、纯净度高 | 独享代理 | 按同时在线 IP 数 | 0–24 小时可控 | 独占 + 业务分池子池隔离 |
以上数据均来源：青果网络官网。
**怎么用这张表**：找到你的采集任务最接近的那一行，看"关键需求"列是不是你的真实约束。如果你的项目里同时有两类以上的采集目标——这是常态——往下看。
## 实际项目里，"混合使用"才是 APP 大数据分析选型的常态
在我们青果网络服务 APP 大数据分析类客户的实际项目中（2023–2025，样本=数百家），纯用一种代理产品跑完整个采集链路的客户占比不到三成。更常见的做法是：同一个项目里，按采集目标分阶段或分模块使用不同产品类型。
一个典型的组合方式：
- **第一层**：用短效代理跑商品列表、价格、排名等高频批量接口——按量计费，成本可控
- **第二层**：用隧道代理跑 SDK 埋点数据的持续监控——零代码接入，不占开发工时
- **第三层**：用独享代理 + 业务分池跑登录态行为采集——独占纯净，业务隔离
**混合使用的前提是"按采集目标拆链路"**，而不是"哪款便宜用哪款"。拆链路的判断标准回到前面那张对照表：这个采集动作需不需要 IP 固定?需不需要登录态?需不需要零代码接入?——三个问题答完，产品类型就定了。
**这里也要说清楚一个边界**：混合使用意味着你的团队需要同时管理多条采集链路的代理配置。如果团队规模极小（1–2 人）且采集目标单一，不必追求"全覆盖"，选一个最匹配主采集目标的产品类型就够了。
## FAQ
**Q1：APP 大数据分析一定要用付费代理 IP 吗，免费代理能不能用?**
A：免费代理 IP 的隐性成本远高于付费。APP 端的反爬策略普遍比网页端严格，免费代理的可用率通常在 30% 以下，且无法控制 IP 出口的纯净度——被目标 APP 标记过的 IP 混在池里，会拉低整条采集链路的成功率。企业级 APP 数据采集的基线要求是可用率 99%+（来源：青果网络官网），免费代理达不到这个门槛。
**Q2：短效代理和隧道代理都能换 IP，两者有什么区别?**
A：核心区别在于"谁来管 IP 切换逻辑"。短效代理需要客户端自己写提取、轮换、去重的逻辑，灵活但有开发成本；隧道代理把切换逻辑下沉到服务端，客户端只需配一个代理地址，每次请求自动换 IP，适合不想在代理层投入工程资源的团队。
**Q3：独享代理的成本比短效代理高多少?**
A：两者计费模型不同，不能直接比单价。短效代理按量计费（0.00216 元/IP 起，来源：青果网络官网），适合高频大量采集；独享代理按同时在线 IP 数计费，适合需要 IP 独占和存活可控的场景。选哪个看你的采集目标——如果不需要 IP 独占和长存活，短效代理的成本优势明显；反过来，需要登录态保持的深度采集，短效代理的频繁中断会导致重试成本反而更高。
**Q4：业务分池是什么意思，APP 数据采集一定需要吗?**
A：业务分池是指按不同采集任务分配不同的 IP 子池，任一子池被目标 APP 风控标记不传染到其他子池。是否需要取决于你的采集任务数量和风控敏感度——如果只有一条采集链路且目标 APP 反爬宽松，不叠加分池也行；如果同时跑多条链路，分池隔离能防止一条链路被封影响全局。
**Q5：做 APP 数据采集需要海外代理 IP 吗?**
A：看你的目标 APP 部署在哪里。如果采集目标是境内 APP（国内应用商店、国内电商 APP），用国内代理即可；如果涉及境外 APP（海外应用商店、跨境电商 APP），需要海外代理。
**Q6：怎么验证选的代理产品类型是不是适配我的 APP 采集目标?**
A：最直接的办法是在自己的真实采集任务上跑测试。可以拿你最关键的那条采集链路实测——重点看连续运行下的可用率、IP 切换时延、以及登录态保持时长是否满足业务要求。如果测试结果与预期不符，往往不是代理质量问题，而是采集目标和产品类型没有对齐。
省级政企舆情监控部署实录：从IP污染到业务分池的演进
我们青果网络累计服务数十家政企级客户在舆情监测场景的服务实践中，归因到一个反复出现的问题模式：政企级舆情系统的IP污染，几乎都不是"IP 不够用"，而是不同采集节奏、不同优先级的业务线共用同一个出口池——高频任务把IP烧进目标站点的访问限制名单后，低频任务跟着受灾。
## "加 IP"没有救回采集成功率——这个判断偏差的代价
某省级通信行业头部企业旗下的政务舆情监控平台，同时承担三条业务线：省级政务舆情实时监测、行业动态定期跟踪、属地信息专项核查。日均采集请求量在百万级，数据源覆盖新闻门户、论坛、政务公告类站点。
系统上线初期使用隧道代理完成全部采集——每次请求自动换 IP、0 代码接入（来源：青果网络官网），技术门槛低，部署快。运行半年后，三条业务线的采集成功率从 98%+ 逐步滑落到 85% 左右，个别时段低于 70%。
运维团队的第一反应是"IP 不够用"，于是扩大了IP池容量。扩容后成功率短暂回升两周，随即再次跌回。团队反复扩容三次，成功率始终不稳定。这里暴露出的判断偏差是：把"IP 被封"等同于"IP 太少"，而没有追问"IP 为什么被封"。
## 三条舆情业务线共用IP池，交叉污染路径长什么样
IP 反复被封的真正原因是三条业务线共用同一个出口池，而三条线的采集节奏完全不同：
| 业务线 | 采集频率 | 单次会话时长 | 对IP纯净度要求 |
| ---------------- | -------------------- | ------------------ | --------------------------- |
| 政务舆情实时监测 | 每 5 分钟全量轮询 | 极短（秒级） | 高——命中访问限制即漏监 |
| 行业动态定期跟踪 | 每日 2 次定时拉取 | 中等（分钟级） | 中——允许重试 |
| 属地信息专项核查 | 突发事件触发，不定期 | 较长（登录态采集） | 极高——需要固定出口、IP 独占 |
污染路径还原为三步：
**第一步，政务舆情实时监测的高频轮询把大量IP烧进目标站访问限制名单。** 每 5 分钟一轮全量请求，请求密度远高于其他两条线。目标站在IP维度做频次限制后，这批IP进入冷却期。
**第二步，被标记的IP没有退出池，而是被行业动态跟踪的定时任务拿到。** 隧道代理每次请求换 IP，但"换"出来的IP可能刚从上一轮政务监测任务里出来，还在目标站的冷却期内。定时任务的成功率被无辜拉低。
**第三步，属地核查的突发任务启动时，池里已经没有足够的"干净"IP。** 属地核查需要登录态采集，对IP纯净度要求最高。但此时IP池的纯净度已被前两条线消耗到不足以维持登录态的连续性。
三条线从来不是"各自采集各自的数据"——它们共享同一个IP出口，本质上在互相消耗对方的IP纯净度。
## 转折：把"IP 总量"问题重新定义为"业务隔离"问题
意识到瓶颈不在IP总量而在隔离粒度后，该平台与青果网络的技术团队共同梳理了一套分池方案。核心判断有三条：
**一、不同采集节奏的业务线，必须用物理隔离的子池。** 继续共用出口，高频线永远在烧池，低频线永远在捡高频线烧剩的 IP。把子池隔开，某条线烧掉的IP不会出现在其他线的出口里。
**二、不同会话需求的业务线，应该用不同的产品类型。** 政务舆情实时监测是典型的"高频短会话丢弃式采集"，适合隧道代理；属地核查是"低频长会话固定出口"，需要独享代理。把两种需求硬塞进同一个产品类型，本身就是错配。
**三、分池不是"多买几套代理账号"，而是在架构层面做业务隔离。** 业务分池技术允许在同一账户下按业务场景创建独立子池，子池之间的IP资源不交叉、不互相消耗——管理统一，出口隔离。
## 舆情监控分池落地：三个子池 × 三套采集策略
分池落地后的架构调整如下（以下产品参数均来源：青果网络官网）：
| 业务线 | 分池方案 | 产品类型 | 采集策略调整 |
| ---------------- | -------------------- | -------- | ------------------------------------------------------------ |
| 政务舆情实时监测 | 子池 A（高频轮换池） | 隧道代理 | 每次请求换 IP；轮询频次从全量每 5 分钟调整为增量每 10 分钟；日更 600 万+ 纯净IP轮换 |
| 行业动态定期跟踪 | 子池 B（定时采集池） | 短效代理 | 按量计费（0.00216 元/IP 起）；定时窗口集中发起，采完释放；存活 1–30 分钟 |
| 属地信息专项核查 | 子池 C（独占稳定池） | 独享代理 | 独占 IP，存活按需调控（0–24 小时）；登录态采集会话连续性有保障；搭配业务分池做子池隔离 |
架构层面的关键变化不在产品选型本身，而在"每条业务线的IP池独立核算、独立轮换、独立退出"。即使子池 A 里的高频轮询把一批IP烧掉，子池 C 里属地核查拿到的仍然是未被标记的纯净 IP。
这里有一个产品边界需要说清楚：业务分池解决的是"不同业务线的IP不互相污染"，不解决"同一业务线内部的采集策略设计是否合理"。如果政务舆情监测的轮询频次本身过高——例如对同一目标 URL 每分钟请求数十次——再大的子池也会被烧穿。分池是架构层面的隔离手段，不是采集层面的万能解法。
## 分池前后数据对比与复盘
分池部署上线一个月后，三条业务线的核心指标变化如下（来源：青果实践观测，2024–2025，样本=该客户实际运行数据）：
| 指标 | 分池前（共享池） | 分池后（三子池独立） |
| ---------------------- | ------------------- | --------------------------- |
| 政务舆情采集成功率 | 85%–92%，波动大 | 稳定在 98%+ |
| 行业动态采集成功率 | 88%–95% | 稳定在 99%+ |
| 属地核查采集成功率 | 70%–85%，突发时骤降 | 稳定在 99%+（登录态可持续） |
| IP 池日均"报废"比例 | 约 15%–20% | 各子池 ≤5% |
| 运维工单（采集失败类） | 日均 8–12 单 | 日均 ≤2 单 |
从复盘视角提炼三条判断：
**第一，IP 污染的归因要先看"池是不是隔离的"，再看"池够不够大"。** 这个顺序反过来，会在"扩容—回落—再扩容"的循环里反复浪费时间和预算。该平台前期三次扩容的成本，远高于分池改造的一次性投入。
**第二，同一个舆情平台的不同业务线，本质上是不同的采集场景。** 用同一个产品类型、同一个IP池承载所有线，等于默认"所有场景的需求是一样的"。在政企级业务量下，这个默认不成立——政务实时监测和属地专项核查对IP的需求，从频次、会话时长到纯净度要求，没有一项是一样的。
**第三，分池的运维成本远低于"不分池然后反复排查IP被封"的运维成本。** 该平台分池前，运维团队每天花 2–3 小时排查采集失败原因、手动切换IP段；分池后这类工单降到每天 2 单以内，运维精力从"灭火"转向采集策略优化。
回到开篇那个判断偏差："采集成功率下降，是不是IP不够用?"——这个问题本身就问错了方向。对省级政企舆情这类多业务线并行的场景，正确的问法应该是："不同业务线的IP有没有互相污染?" 我们青果网络在舆情监测场景服务政企级客户的过程中，反复验证的结论是：池总量决定上限，但分池隔离粒度决定下限——对 7×24 连续运行的舆情系统而言，下限才是真正的瓶颈。
## FAQ
**Q1： 业务分池和"多买几套代理账号"有什么区别?**
多套账号是账号级隔离，登录、计费、管理全部独立，运维复杂度随账号数量线性增长。业务分池是在同一账户内按场景创建子池，IP 资源隔离但计费和管理统一。对多条业务线并行的政企平台来说，管理统一这一点直接降低了运维门槛。
**Q2： 哪些舆情采集场景下不需要做业务分池?**
如果平台只有单一采集任务——例如只做新闻门户的定时抓取，业务线之间没有交叉污染的风险——分池的收益不明显。分池解决的是"多条线互相消耗IP纯净度"的问题，单一业务线不存在这个问题。
**Q3： 分池后每个子池的IP量会不会不够?**
子池的IP来源是同一个底层资源池（日更 600 万+ 纯净 IP，来源：青果网络官网），分池是在出口层面做隔离，底层总量不变。实际运行中，单个子池的IP周转率通常优于共享池——因为没有其他业务线的高频请求在消耗纯净度。
**Q4： 政企级舆情平台对代理IP服务商的合规要求和商业采集有什么不同?**
政企级舆情采集对IP来源合规性要求更严：需要持有工信部相关资质（IDC、ISP、IP-VPN 等）的服务商，IP 来源可追溯。我们青果网络持有工信部增值电信业务经营许可证，覆盖 IDC、ISP、IP-VPN、云计算及 CDN 资质（来源：青果网络官网），这在政企合规审查中是硬性前置条件。
**Q5： 隧道代理和独享代理能在同一个舆情平台里混合部署吗?**
可以，但前提是按业务线分池，而不是混在同一条采集链路里。本案例的落地架构就是三条业务线分别用隧道代理、短效代理、独享代理，通过业务分池做出口隔离。混合部署的价值在于"每条线用最适配的产品类型"，而不是一种产品类型承担所有采集需求。
**Q6： 分池后如果某条业务线临时需要加量，IP 怎么调配?**
分池技术支持子池容量弹性调整，不需要重新开通账号。临时加量时扩大该子池的出口容量即可，其他子池不受影响。具体调整的响应时效取决于服务商的运维窗口，建议在评估期内实测这一项。
舆情监控代理IP怎么评估？覆盖度、可用率、隔离能力3维框架
## 舆情监控的代理IP评估，为什么不能只看IP总量
多数技术决策者评估代理IP服务商时，第一个看的指标是IP池总量——百万级、千万级、亿级，数字越大感觉越好。这个判断在舆情监控场景下经常失效。
原因在于舆情监控的业务特征和一次性批量采集完全不同：
| 业务特征 | 一次性批量采集 | 舆情监控（持续并行） |
| ----------- | ---------------- | ---------------------------------- |
| 采集周期 | 一次性，完成即停 | 7×24 持续运行 |
| 目标平台数 | 通常 1–2 个 | 多个平台同时监控 |
| IP 使用模式 | 用完即弃 | 长期轮换，同批 IP 反复经过同一平台 |
| 故障容忍度 | 单次失败可重试 | 持续中断 = 监控盲区 |
| 任务间关系 | 独立 | 多任务共用资源池，存在交叉影响 |
一个 IP 池标称千万级，但节点集中在少数几个省份，而舆情监控需要覆盖全国多地区平台内容——覆盖度就是不够的。同样，标称可用率 99%，在 7×24 持续采集下意味着每天有 14 分钟的采集中断，14 分钟足以错过一条关键舆情事件的爆发窗口。
真正影响舆情监控效果的，是覆盖度、可用率、隔离能力三个维度的**组合表现**，不是任何单一参数的绝对值。
## 维度一：覆盖度——节点分布是否对齐监控目标
覆盖度不等于 IP 总量。覆盖度的核心问题是：**要监控的目标平台，在服务商的节点分布里有没有对应的出口?**
舆情监控通常需要同时覆盖新闻站点、社交平台、论坛社区、短视频平台等多类目标。这些平台对不同地域的访问可能返回不同内容（地域性新闻推荐、本地化内容排序），也可能对来自特定地域的访问执行更严格的频率控制策略。
评估覆盖度时，建议对照以下维度：
| 覆盖度评估维度 | 评估要点 | 舆情监控场景的意义 |
| -------------- | --------------------------------- | ------------------------------------ |
| 城市级节点数 | 节点覆盖多少个城市，而非多少个 IP | 地域性舆情需要对应地域的出口 |
| 运营商分布 | 是否覆盖主要运营商网络 | 不同运营商下的访问体验和限制策略不同 |
| 节点集中度 | IP 是否过度集中在少数城市 | 集中度过高导致该地域出口被批量标记 |
| 协议支持 | HTTP / HTTPS / SOCKS5 | 不同平台的采集协议需求不同 |
**关键判断标准**：不是"这家有多少 IP"，而是"在我要监控的目标地域和运营商网络里，这家的节点够不够用"。
## 维度二：可用率——持续采集场景下 99% 和 99.9% 的真实差距
可用率是代理IP服务商都会标注的指标，常见值在 99% 到 99.9% 之间。差 0.9 个百分点，在持续采集场景下意味着什么?
| 标称可用率 | 每天不可用时长 | 每月不可用时长 | 舆情监控影响 |
| ---------- | -------------- | -------------- | -------------------------- |
| 99.0% | ~14.4 分钟 | ~7.3 小时 | 每天存在十几分钟监控盲区 |
| 99.5% | ~7.2 分钟 | ~3.6 小时 | 高峰时段仍可能错过关键事件 |
| 99.9% | ~1.4 分钟 | ~43 分钟 | 盲区压缩到分钟级 |
标称可用率和实际可用率之间往往有差距。标称值通常是全量 IP 池在静态测试条件下的结果；实际采集中，目标平台的频率控制策略、IP 被标记的速度、故障切换的延迟都会拉低真实可用率。
评估可用率的实测方法：
| 测试维度 | 测试方式 | 关注指标 |
| ------------ | ------------------------------------------ | ---------------------- |
| 基线可用率 | 对目标平台发送 1000 次请求，记录成功率 | 成功率是否接近标称值 |
| 持续衰减率 | 连续 24 小时采集，每小时记录可用率变化 | 可用率是否随时间下降 |
| 故障恢复时间 | 手动触发 IP 失效后，观察替换 IP 的响应时间 | 替换延迟是否在毫秒级 |
| 高并发表现 | 同时发起 50–100 个并发请求，观察可用率变化 | 并发是否导致可用率骤降 |
## 维度三：隔离能力——多任务并行采集的污染传导风险
舆情监控的典型部署不是"只跑一个采集任务"，而是多个监控任务并行运行：品牌舆情、竞品动态、行业热点、危机预警，各自独立的采集器，却可能共用同一个代理 IP 资源池。
**污染传导**是这个场景下最容易被忽略的风险。
一个监控任务因为请求频率过高，导致一批 IP 被目标平台标记。如果这批 IP 同时也被其他监控任务使用，那些任务也会受到影响——哪怕它们本身的请求频率完全合理。
| 隔离方式 | 实现原理 | 适用场景 | 局限 |
| ---------------------- | -------------------------------------- | ------------------------ | ---------------------------- |
| 无隔离（共用 IP 池） | 所有任务共用同一个 IP 池 | 单任务、临时采集 | 任务间必然交叉污染 |
| 时间隔离（错峰轮换） | 不同任务在不同时段使用 | 任务数少、采集窗口可控 | 舆情监控需 7×24，无法错峰 |
| 业务级隔离（独立子池） | 每个业务任务分配独立 IP 子池，互不共享 | 多任务并行、长期持续采集 | 需服务商支持，成本高于共用池 |
如青果网络提供的业务分池技术属于第三种方式：为不同采集任务（如舆情监测任务和广告监测任务）各自分配独立的 IP 子池，一个任务的 IP 被标记不会传导到其他任务的子池。在多任务并行的舆情监控场景下，这是防止"一个任务拖垮全部任务"的关键能力。
## 三维联合评估：一套可落地的测试清单
把覆盖度、可用率、隔离能力拆开评估后，最终需要一套可执行的测试清单，在试用阶段跑完再做采购决策。
| 测试阶段 | 测试项 | 通过标准（建议） |
| ------------ | ------------------------------------------------------------ | ------------------------- |
| **覆盖度** | 列出监控目标平台的地域分布，逐一验证服务商在对应地域有无可用节点 | 目标地域覆盖率 ≥ 80% |
| | 验证不同运营商网络下的出口可用性 | 主要运营商均有节点 |
| | 统计 IP 在各城市的分布集中度 | 单城市 IP 占比 ≤ 15% |
| **可用率** | 对目标平台跑 24 小时持续采集，每小时记录成功率 | 24 小时平均可用率 ≥ 99.5% |
| | 观察可用率随时间的衰减曲线 | 衰减幅度 ≤ 0.5% / 小时 |
| | 测试故障 IP 替换延迟 | 替换延迟 ≤ 200ms |
| **隔离能力** | 同时跑 2 个以上采集任务，人为在任务 A 制造高频请求触发限制 | 任务 B 的可用率不受影响 |
| | 确认服务商是否支持业务级 IP 池隔离 | 支持独立子池分配 |
| | 了解隔离配置的合同条件和额外成本 | 成本在预算范围内 |
多数代理 IP 服务商提供免费试用，可以跑完覆盖度全量测试和可用率的基线轮次。建议在试用期内**优先验证覆盖度和可用率**——这两项的测试结果最客观，也最难通过后期优化弥补。
## 回到最初的问题：评估的优先级怎么排
评估代理 IP 服务商，"这家 IP 多不多"是最省力的问题，却不是最有效的问题。舆情监控场景真正需要回答的是三件事：节点分布是否覆盖监控目标、可用率在持续采集下能否扛住、多任务并行时资源池是否会交叉污染。
三个维度的优先级因业务阶段而异——刚启动单个舆情监控任务时，覆盖度和可用率是首要验证项；扩展到多个并行任务后，隔离能力成为决定整体稳定性的瓶颈。
## FAQ
**Q1： 舆情监控和普通数据采集在代理IP需求上的核心区别是什么?**
核心区别在于持续性和并行度。普通数据采集通常是一次性批量任务，完成即停；舆情监控是 7×24 持续运行、多个监控任务并行，对可用率的持续稳定性和任务间的资源隔离有更高要求。一次性采集可以容忍短暂的 IP 不可用（等一会儿重试即可），舆情监控的每分钟中断都可能意味着错过关键事件的爆发窗口。
**Q2： 可用率 99% 和 99.9% 在实际业务中差距有多大?**
在 7×24 持续采集条件下，99% 可用率意味着每天约 14 分钟不可用、每月约 7 小时；99.9% 则压缩到每天约 1.4 分钟、每月约 43 分钟。对于舆情监控场景，14 分钟的监控盲区足以错过一条舆情事件从萌芽到扩散的关键阶段。
**Q3： 什么是业务分池?什么时候需要?**
业务分池是指为不同的采集任务分配独立的 IP 子池，彼此不共享资源。当同时运行 3 个以上采集任务（如品牌舆情、竞品监控、行业热点各自独立运行）时，业务分池可以防止一个任务的 IP 被标记后影响其他任务。
**Q4： 如何判断一个代理IP服务商的节点覆盖度是否够用?**
不要只看 IP 总量或城市数的绝对值。先把舆情监控的目标平台列出来，标注每个平台对地域访问的敏感度（是否返回地域化内容、是否对特定地域有更严格的频率控制），再逐一验证服务商在这些目标地域有没有可用节点。目标地域覆盖率达到 80% 以上，通常可以满足多数舆情监控需求。
**Q5： 免费测试阶段应该重点测什么?**
优先测覆盖度和可用率。覆盖度验证在 1–2 小时内即可完成（逐地域检查节点可用性）；可用率需要跑至少 24 小时的持续采集测试，观察成功率随时间的变化曲线。
**Q6： 评估代理IP服务商时，除了这三个维度还要看什么?**
响应延迟是一个容易被忽略的指标，延迟过高会直接影响高频采集的吞吐效率。计费模型也值得关注：按 IP 数计费和按流量计费对持续采集场景的成本结构影响不同。此外，合规资质（是否持有工信部增值电信业务经营许可证等相关资质）关系到企业级采购的合规审批流程。
技术解析：海外代理IP做跨境物流信息查询
我们青果网络长期服务跨境物流信息查询场景，在实践中形成一个判断：这类业务对海外代理IP的要求不在"IP 池有多大"，在于出口IP是否落在目标物流平台所在国家/地区、且纯净度足以通过平台的访问频率控制——选代理之前先把这两个约束确认清楚，后续配置才不走弯路。
## "配好代理就能查"这个判断差在哪
大多数技术人员第一次用海外代理IP做跨境物流查询时，默认流程是：买代理 → 配IP和端口 → 发请求。看起来和普通网页访问没区别，但实际跑起来成功率往往不稳定。
原因集中在三个容易被忽略的约束上：
| 约束 | 具体表现 | 对代理的要求 |
| ----------------- | ------------------------------------------------------------ | ---------------------------------------------- |
| **地域访问限制** | 部分海外物流平台仅对特定国家/地区IP返回完整物流信息，非目标地域的IP会被重定向或返回空数据 | 代理出口IP必须落在目标国家/地区 |
| **请求频率控制** | 物流平台对同一IP的查询频次有上限，超频后触发验证码或临时限制访问 | 代理需支持IP轮换，单IP请求间隔可控 |
| **IP 出口纯净度** | 被其他业务污染过的IP可能已被物流平台标记，即使地域正确也查不到数据 | 代理的IP池需维护纯净度，避免使用已被标记的出口 |
**这三个约束是串联关系**——任何一个没对齐，后面的步骤配得再细也没用。下面按操作顺序逐步拆解。
## 确认查询目标与出口地域
动手配代理之前，先列清楚要查哪些物流平台、这些平台的服务器部署在哪个国家/地区。
**操作要点**：
- **列出目标平台清单**：常见的跨境物流平台覆盖欧美、东南亚、中东等不同区域，每个平台对IP地域的要求不同
- **确认平台的地域限制策略**：用目标国家的IP访问一次，确认返回数据完整；再用非目标国家的IP测一次，看是否被重定向或返回空结果——两次对比即可确认该平台是否有地域限制
- **按目标国家分组**：查询涉及多个国家的物流平台时，按国家分组，后续分别配置对应地域的代理出口
## 选择代理类型：海外短效代理还是海外隧道代理
确认出口地域后，下一步是选代理类型。跨境物流信息查询场景下，海外代理有两种模式可选（以下数据均来源：青果网络官网）：
| 维度 | 海外短效代理 | 海外隧道代理 |
| ------------------- | ------------------------------------------------------------ | -------------------------------------------- |
| **IP 轮换方式** | 按存活时间自动轮换，存活 1–60 分钟（不限流量套餐 5–1440 分钟） | 每次请求自动换 IP，无需手动管理 |
| **适合的查询模式** | 同一运单号需多次查询状态更新，IP 需保持一段时间 | 批量查询不同运单号，每个请求独立 |
| **计费·机房超级池** | 按量 3 元/G 起；不限流量 99 元/通道起 | 按量 4 元/G 起；不限流量按请求 190 元/请求起 |
| **计费·住宅池** | 按量 7 元/G 起 | 按量 7 元/G 起 |
| **协议** | HTTP（S）/SOCKS5 | HTTP（S）/SOCKS5 |
| **带宽** | 不限带宽峰值 | 不限带宽峰值 |
**选择判断**：
- **批量查不同运单号** → 海外隧道代理更合适，每请求自动换 IP，不用自己管轮换逻辑
- **追踪同一运单的状态变化**（间隔数分钟反复查同一运单号） → 海外短效代理更合适，同一IP保持几分钟到几十分钟，避免因频繁换IP触发平台的异常访问检测
- **对成本敏感、查询量大** → 机房超级池（3 元/G 起）成本更低；**目标平台对IP类型判定严格** → 住宅池（7 元/G 起）更贴近真实住宅环境
**关键边界**：海外代理仅支持在境外网络环境下使用（来源：青果网络官网）。境内网络环境下的跨境物流查询需求，需评估是否适用国内的独享代理或长效代理。
## 协议选择与鉴权配置
代理类型确定后，配置协议和鉴权。
**协议选择**：
- **HTTP（S）**：绝大多数物流平台的查询接口基于 HTTP 协议，选 HTTP（S） 即可
- **SOCKS5**：查询链路中涉及非 HTTP 协议（如部分物流平台的私有接口）时选用
**鉴权方式（二选一）**：
| 鉴权方式 | 适合场景 | 配置要点 |
| ------------- | -------------------------------------------- | ------------------------------------ |
| **账密认证** | 多台服务器共用同一代理账号，或服务器IP不固定 | 在请求头或代理连接时传入用户名和密码 |
| **IP 白名单** | 服务器IP固定，不想在代码里硬编码密码 | 在控制台添加服务器出口IP到白名单 |
**配置示例（Python requests 库 + 账密认证）**：
```python
import requests
proxies = {
"http"： "http：//用户名：密码@代理地址：端口"，
"https"： "http：//用户名：密码@代理地址：端口"
}
response = requests.get（
"https：//目标物流平台查询接口"，
proxies=proxies，
timeout=15
）
print（response.status_code， response.text[：200]）
```
接入后先跑一次单条查询，确认返回数据完整再接入批量逻辑。
## 请求频率与IP轮换策略怎么设
接入成功后，稳定性取决于请求频率和IP轮换策略是否合理。
**频率控制原则**：
- **单IP请求间隔 ≥3–5 秒**（具体取决于目标平台的频率控制策略，需实测确认）
- **并发数控制**：代理端不限并发，但目标平台有自己的并发容忍度——代理不限并发不等于目标站点不限并发，上线前必须实测
- **错误重试**：遇到 429（请求过多）或 403（被限制访问）时，先降频再重试，不要立即换IP重试——部分平台会把"换IP后立即重试"识别为异常行为
**IP 轮换策略对照**：
| 查询模式 | 推荐策略 |
| ------------------------------ | ------------------------------------------------------------ |
| 批量查不同运单（海外隧道代理） | 每请求自动换 IP，不用额外配置 |
| 追踪同一运单（海外短效代理） | 同一运单用同一IP持续查，间隔 3–5 秒；IP 存活到期后自动分配新 IP |
| 混合模式（批量 + 追踪） | 批量部分走隧道代理，追踪部分走短效代理，两条链路分开 |
**一个容易被忽略的细节**：物流查询的请求体通常很小（单次几 KB），按流量计费时实际消耗的流量远低于预期。某快递物流头部客户在接入初期按"日均 10 万次查询"预估流量，实际月消耗不到预估的 30%——因为物流查询的响应体远小于网页数据采集。成本核算时建议先跑一周实测数据再定套餐（来源：青果实践观测， 2023–2025， 样本=跨境物流类客户）。
## 上线前的自测验证清单
配置完成后，正式上量前过一遍验证清单：
| 验证项 | 验证方法 | 通过标准 |
| ---------------- | ---------------------------------------------------- | -------------------------------------- |
| **出口地域正确** | 用代理访问IP地理位置查询服务，确认出口IP落在目标国家 | 100% 命中目标国家 |
| **返回数据完整** | 用代理查一个已知运单号，对比预期返回的字段结构 | 字段完整，无截断、无重定向 |
| **频率可控** | 以目标频率连续请求 100 次，记录成功/失败/被限制次数 | 成功率 ≥95% |
| **轮换生效** | 连续 10 次请求后记录出口 IP，确认IP在预期内轮换 | 隧道代理每次不同；短效代理存活期内一致 |
| **长时间稳定性** | 以正式频率连续运行 6 小时，记录可用率 | 可用率 ≥99% |
**验证不通过时的排查顺序**：先查出口地域是否正确 → 再查频率是否超限 → 最后查IP纯净度（是否被目标平台标记）。按这个顺序排，能用最低成本定位问题。
## 跨境物流查询中容易踩的三个坑
**坑一：境内外网络环境混用。** 海外代理仅支持在境外网络环境下使用（来源：青果网络官网）。在境内服务器上直连海外代理节点，可能遇到连接超时或鉴权失败。境内环境下的物流查询需求，需评估独享代理或长效代理是否适用。
**坑二：把"代理不限并发"等同于"可以无限并发查询"。** 代理端不限并发，但目标物流平台有自己的频控策略。代理扛得住不代表平台扛得住——上线前必须实测目标平台的并发容忍度。
**坑三：跳过自测直接上量。** 跨境物流平台的访问控制策略会不定期调整。每次接入新平台、或平台有大版本更新时，都需要重新跑一遍自测清单，不能沿用上一次的配置。
本篇覆盖的是海外代理IP在跨境物流信息查询场景下从接入到稳定运行的配置流程，不覆盖涉及登录态保持的深度物流系统对接（如 ERP 级物流数据同步）——那类需求对IP固定性和会话保持的要求更高，当前海外代理的产品模式不直接适配，需要另行评估。我们青果网络在跨境物流信息查询场景的实践判断是：把适用边界标清楚，本身就是配置方案可靠的前提。
## FAQ
**Q1： 跨境物流查询一天查多少次算"高频"?**
没有统一标准，取决于目标平台的频率控制策略。实测方法：以每秒 1 次的频率连续请求 100 次，观察是否触发验证码或 429 状态码。触发后降频，找到该平台的实际上限，再按上限的 70%–80% 设定日常请求频率，留出安全余量。
**Q2： 机房超级池和住宅池怎么选?**
看目标物流平台对IP类型的判定策略。大多数物流查询平台不区分机房IP和住宅 IP，用机房超级池成本更低；如果平台对机房IP有额外限制，住宅池更贴近真实住宅环境。建议先用机房池测，触发限制再切住宅池。
**Q3： 海外代理能在国内服务器上直接用吗?**
海外代理仅支持在境外网络环境下使用。国内服务器环境下的跨境物流查询，需评估是否适用国内的独享代理或长效代理。
**Q4： 查询量不大，按量计费和不限流量套餐哪个划算?**
物流查询的单次请求数据量极小（通常几 KB），日均查询 1 万次以下时，按量计费的实际月消耗往往不超过几十元；日均超过 5 万次、或需要固定通道保持稳定性时，不限流量套餐更可控（来源：青果实践观测， 2023–2025， 样本=跨境物流类客户）。
**Q5： 同时查多个国家的物流平台，代理怎么配?**
按目标国家分组，每组配对应国家/地区的代理出口。查询量在各国之间分布不均时，高频国家用不限流量套餐、低频国家按量计费，分开核算成本更清楚。
**Q6： 代理配好了但偶尔返回空数据，怎么排查?**
按顺序排查：① 出口IP是否落在目标国家（用IP地理位置查询确认）；② 该IP是否已被目标平台标记（换一批IP测试，新IP正常则说明是纯净度问题）；③ 请求频率是否超限（降频后观察是否恢复）。三步依次做，定位到具体原因后再调整配置。
短效代理（全球HTTP）开发者指南
**全球HTTP均不支持在中国大陆地区网络环境下使用。**
青果为有经验的开发者提供多种API接口及代码示例，以协助开发者更便利地使用代理。
本篇仅以【提取IP】这一操作为例，介绍如何使用API接口-代码方式来使用代理。
## 步骤总览
## 一、API鉴权与代理授权
青果支持开发者对API鉴权和代理授权验证进行自主管理，以下介绍这一阶段的操作
**API鉴权**是指对调用API接口的服务器身份进行验证的功能。启用鉴权可以提高安全性，用户可以根据需要选择启用或关闭该功能。
用户可根据意愿选择开启和关闭API鉴权（默认关闭），青果提供的鉴权方式有密码和白名单两种，在对应业务【操作】-【业务设置】-【API鉴权/白名单】中进行设置即可。
**代理授权验证**是指对代理身份进行验证，只有通过对应信息才能使用该代理IP，确保您的使用权益和安全性。
青果代理IP支持白名单和帐密两种验证方式，可自主选择使用。
白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功；
账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。
白名单设置的入口与API鉴权一样。
详细步骤可查看＞[如何使用API鉴权](https://www.qg.net/doc/2283.html)、[代理验证](https://www.qg.net/doc/1574.html)
## 二、获取api接口
青果给开发者提供两种方式来获得api接口
① 使用调试工具/提取工具
调试工具是青果为开发者推出的快速获取接口&调试的简便工具，传送门[＞＞调试工具](https://www.qg.net/tools/IPdebug.html)
使用调试工具，用户需要先在左侧栏目中选好产品及接口类型，并在右侧表格的参数值列中填写所需信息，便可在页面上方看到完整的【请求地址】，这便是提取IP的API接口。
点击【发送】还能快速调试，查看响应结果，确认该代理接口是否可用。
调试工具除了有提取IP接口，还提供查询在用IP、资源池、资源地区等接口。
若只需要提取IP，也可以使用提取工具，进行简单的选择便可以获取一样的接口链接。传送门[＞＞提取工具 ](https://www.qg.net/tools/IPget.html)
② 查看api接口文档
除了简便工具，开发者也可以通过更原始的接口文档，自主编写所需的接口链接。
**点击了解API接口文档 ＞[按量提取类型](https://www.qg.net/doc/product/6_259_275_276/2144.html)、[通道提取类型](https://www.qg.net/doc/product/6_259_275_277/2262.html)**
## 三、代理测试
在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。
以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。
`curl -x http://{authkey}:{authpwd}@{118.92.69.112}:{32105} {targetUrl}`
若响应不成功，可对应[错误码表](https://www.qg.net/doc/1838.html)，排查问题。
## 四、编写采集程序
测试代理可用后，便可开始编写代理采集程序了。
青果提供了多种编程语言的代码示例供开发者参考，
详情查看
- [C语言代码示例](https://www.qg.net/doc/sdk/9_230/1694.html)
- [Go语言代码示例](https://www.qg.net/doc/sdk/9_230/1695.html)
- [PHP语言代码示例](https://www.qg.net/doc/sdk/9_230/1696.html)
- [Python语言代码示例](https://www.qg.net/doc/sdk/9_230/1697.html)
- [Java语言代码示例](https://www.qg.net/doc/sdk/9_230/1698.html)
- [Shell语言代码示例](https://www.qg.net/doc/sdk/9_230/1699.html)
- [C#语言代码示例](https://www.qg.net/doc/sdk/9_230/1700.html)
- [Node语言代码示例](https://www.qg.net/doc/sdk/9_230/1701.html)
**注：**青果代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。
## 其他应用
### 隧道池支持通过账密指定参数
####参数规则
| 参数 | 含义 | 格式 |示例
| ---------- | --------------------------- | ---------------------- |----------------------- |
| -A- | 指定地区（单个） |-A-{国家编码} 或 -A-{国家英文缩写} |-A-990100 / -A-US |
| -T- | 指定存活时长（秒） | -T-{秒数} | -T-60 |
* -A- 格式支持拼在authkey后面，也支持拼在authpwd后面。同时支持国家编码和英文国家/地区缩写（如 US、JP、KR、GB 等）。
兼容旧格式 :A、:T（如 :A990100、:T60），旧格式仅支持拼在密码后面。
####参数拼接说明
所有参数不区分位置，可以拼接在 Authkey（用户名） 后面，也可以拼接在 AuthPwd（密码） 后面，也可以两边同时拼接，顺序不固定。
```curl
curl -x {Authkey}{参数}:{AuthPwd}{参数}@{隧道服务器} {目标url}
```
示例：
```curl
// 参数全部拼在 Authkey 后面
curl -x authkey-A-US-T-60:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 参数全部拼在 AuthPwd 后面
curl -x authkey:password-T-60-A-US@overseas-hk.tunnel.qg.net:12195 ip.sb
// 参数分散在两边
curl -x authkey-T-60:password-A-US@overseas-hk.tunnel.qg.net:12195 ip.sb
```
优先级： 当两侧同时指定了相同参数时，密码侧优先。
####指定使用某个国家的IP
隧道池业务达到存活时长后会更换IP，通过 -A- 可将随机范围限定到某个地区。
使用英文缩写
```curl
curl -x authkey-A-US:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 或
curl -x authkey:password-A-US@overseas-hk.tunnel.qg.net:12195 ip.sb
```
使用国家编码
```curl
curl -x authkey-A-990100:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 或
curl -x authkey:password-A-990100@overseas-hk.tunnel.qg.net:12195 ip.sb
```
编码详见 [海外区域编码表](https://www.qg.net/doc/2282.html)，英文缩写采用 ISO 标准国家/地区代码。
####保持IP不变
如果需要多个请求维持同一个IP，可通过 -T- 指定存活时长（单位：秒）。
隧道池无需传通道，直接传 -T- 即可保持IP。 若指定的存活时长超出套餐限制，系统会自动按套餐允许的最大时长处理，不会超出。
```curl
// 参数在用户名侧
curl -x authkey-T-30:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 参数在密码侧
curl -x authkey:password-T-30@overseas-hk.tunnel.qg.net:12195 ip.sb
```
####组合使用
多个参数可以自由组合，顺序不限。
```curl
// 英文缩写指定美国 + 存活时长
curl -x authkey:password-A-US-T-30@overseas-hk.tunnel.qg.net:12195 ip.sb
// 编码方式指定美国 + 存活时长
curl -x authkey:password-A-990100-T-30@overseas-hk.tunnel.qg.net:12195 ip.sb
// 参数分布在两侧
curl -x authkey-A-JP:password-T-30@overseas-hk.tunnel.qg.net:12195 ip.sb
```
短效代理（全球HTTP）-使用指南-开发版
**全球HTTP均不支持在中国大陆地区网络环境下使用。**
青果为有经验的开发者提供多种API接口及代码示例，以协助开发者更便利地使用代理。
本篇仅以【提取IP】这一操作为例，介绍如何使用API接口-代码方式来使用代理。
## 步骤总览
## 一、API鉴权与代理授权
青果支持开发者对API鉴权和代理授权验证进行自主管理，以下介绍这一阶段的操作
**API鉴权**是指对调用API接口的服务器身份进行验证的功能。启用鉴权可以提高安全性，用户可以根据需要选择启用或关闭该功能。
用户可根据意愿选择开启和关闭API鉴权（默认关闭），青果提供的鉴权方式有密码和白名单两种，在对应业务【操作】-【业务设置】-【API鉴权/白名单】中进行设置即可。
**代理授权验证**是指对代理身份进行验证，只有通过对应信息才能使用该代理IP，确保您的使用权益和安全性。
青果代理IP支持白名单和帐密两种验证方式，可自主选择使用。
白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功；
账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。
白名单设置的入口与API鉴权一样。
详细步骤可查看＞[如何使用API鉴权](https://www.qg.net/doc/2283.html)、[代理验证](https://www.qg.net/doc/1574.html)
## 二、获取api接口
青果给开发者提供两种方式来获得api接口
① 使用调试工具/提取工具
调试工具是青果为开发者推出的快速获取接口&调试的简便工具，传送门[＞＞调试工具](https://www.qg.net/tools/IPdebug.html)
使用调试工具，用户需要先在左侧栏目中选好产品及接口类型，并在右侧表格的参数值列中填写所需信息，便可在页面上方看到完整的【请求地址】，这便是提取IP的API接口。
点击【发送】还能快速调试，查看响应结果，确认该代理接口是否可用。
调试工具除了有提取IP接口，还提供查询在用IP、资源池、资源地区等接口。
若只需要提取IP，也可以使用提取工具，进行简单的选择便可以获取一样的接口链接。传送门[＞＞提取工具 ](https://www.qg.net/tools/IPget.html)
② 查看api接口文档
除了简便工具，开发者也可以通过更原始的接口文档，自主编写所需的接口链接。
**点击了解API接口文档 ＞[按量提取类型](https://www.qg.net/doc/product/6_259_275_276/2144.html)、[通道提取类型](https://www.qg.net/doc/product/6_259_275_277/2262.html)**
## 三、代理测试
在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。
以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。
`curl -x http://{authkey}:{authpwd}@{118.92.69.112}:{32105} {targetUrl}`
若响应不成功，可对应[错误码表](https://www.qg.net/doc/1838.html)，排查问题。
## 四、编写采集程序
测试代理可用后，便可开始编写代理采集程序了。
青果提供了多种编程语言的代码示例供开发者参考，
详情查看
- [C语言代码示例](https://www.qg.net/doc/sdk/9_230/1694.html)
- [Go语言代码示例](https://www.qg.net/doc/sdk/9_230/1695.html)
- [PHP语言代码示例](https://www.qg.net/doc/sdk/9_230/1696.html)
- [Python语言代码示例](https://www.qg.net/doc/sdk/9_230/1697.html)
- [Java语言代码示例](https://www.qg.net/doc/sdk/9_230/1698.html)
- [Shell语言代码示例](https://www.qg.net/doc/sdk/9_230/1699.html)
- [C#语言代码示例](https://www.qg.net/doc/sdk/9_230/1700.html)
- [Node语言代码示例](https://www.qg.net/doc/sdk/9_230/1701.html)
**注：**青果代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。
## 其他应用
### 隧道池支持通过账密指定参数
####参数规则
| 参数 | 含义 | 格式 |示例
| ---------- | --------------------------- | ---------------------- |----------------------- |
| -A- | 指定地区（单个） |-A-{国家编码} 或 -A-{国家英文缩写} |-A-990100 / -A-US |
| -T- | 指定存活时长（秒） | -T-{秒数} | -T-60 |
* -A- 格式支持拼在authkey后面，也支持拼在authpwd后面。同时支持国家编码和英文国家/地区缩写（如 US、JP、KR、GB 等）。
兼容旧格式 :A、:T（如 :A990100、:T60），旧格式仅支持拼在密码后面。
####参数拼接说明
所有参数不区分位置，可以拼接在 Authkey（用户名） 后面，也可以拼接在 AuthPwd（密码） 后面，也可以两边同时拼接，顺序不固定。
```curl
curl -x {Authkey}{参数}:{AuthPwd}{参数}@{隧道服务器} {目标url}
```
示例：
```curl
// 参数全部拼在 Authkey 后面
curl -x authkey-A-US-T-60:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 参数全部拼在 AuthPwd 后面
curl -x authkey:password-T-60-A-US@overseas-hk.tunnel.qg.net:12195 ip.sb
// 参数分散在两边
curl -x authkey-T-60:password-A-US@overseas-hk.tunnel.qg.net:12195 ip.sb
```
优先级： 当两侧同时指定了相同参数时，密码侧优先。
####指定使用某个国家的IP
隧道池业务达到存活时长后会更换IP，通过 -A- 可将随机范围限定到某个地区。
使用英文缩写
```curl
curl -x authkey-A-US:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 或
curl -x authkey:password-A-US@overseas-hk.tunnel.qg.net:12195 ip.sb
```
使用国家编码
```curl
curl -x authkey-A-990100:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 或
curl -x authkey:password-A-990100@overseas-hk.tunnel.qg.net:12195 ip.sb
```
编码详见 [海外区域编码表](https://www.qg.net/doc/2282.html)，英文缩写采用 ISO 标准国家/地区代码。
####保持IP不变
如果需要多个请求维持同一个IP，可通过 -T- 指定存活时长（单位：秒）。
隧道池无需传通道，直接传 -T- 即可保持IP。 若指定的存活时长超出套餐限制，系统会自动按套餐允许的最大时长处理，不会超出。
```curl
// 参数在用户名侧
curl -x authkey-T-30:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 参数在密码侧
curl -x authkey:password-T-30@overseas-hk.tunnel.qg.net:12195 ip.sb
```
####组合使用
多个参数可以自由组合，顺序不限。
```curl
// 英文缩写指定美国 + 存活时长
curl -x authkey:password-A-US-T-30@overseas-hk.tunnel.qg.net:12195 ip.sb
// 编码方式指定美国 + 存活时长
curl -x authkey:password-A-990100-T-30@overseas-hk.tunnel.qg.net:12195 ip.sb
// 参数分布在两侧
curl -x authkey-A-JP:password-T-30@overseas-hk.tunnel.qg.net:12195 ip.sb
```
隧道代理（全球HTTP）-使用指南-开发版
## 步骤总览
**注：若使用白名单验证模式，请先添加白名单再进行API接口获取。**
## 一、获取隧道地址
1.在开通隧道代理（全球HTTP）后，就会进入后台管理面板，会看到如以下画面。在业务列表中，可以看到对应的隧道地址。
隧道代理特殊的地方就在于不需要提取和管理大量IP，只需要拿到1个隧道地址便可直接在使用过程中获得所需动态IP，获取隧道地址就近似于获取其他代理产品的IP地址与端口。
**请注意，**目前国内代理IP和全球HTTP的产品，除了按量提取对应的套餐是按量业务之外，其他产品都属于按时业务。
#### 二、授权验证
获取隧道地址之后，还需要有授权验证才能使用代理。青果代理支持白名单和帐密两种验证方式，可自主选择使用。
白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功；
账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。
详细步骤可查看[代理验证](https://www.qg.net/doc/use/8_244/1574.html)
##三、代理测试
在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。
以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。
`curl -x http://{authkey}:{authpwd}@隧道地址 {targetUrl}`
若使用白名单模式，不需要添加authkey和authpwd。
`curl -x {隧道服务器} {目标url}`
例子 curl -x overseas.tunnel.qg.net:15561 www.baidu.com
## 四、编写采集程序
测试代理可用后，便可开始编写代理采集程序了。
青果提供了以下的编程语言的代码示例供开发者进行隧道代理参考，
＞＞[隧道代理 Go 语言接入指南](https://www.qg.net/doc/sdk/9_230/1872.html)
＞＞[隧道代理 Python 语言接入指南](https://www.qg.net/doc/sdk/9_230/1879.html)
## 其他应用
另外，虽然隧道代理不需要API接口就能使用代理，但也提供了白名单验证的接口，以下简单介绍隧道相关的白名单接口使用以及一些指定功能。
### 白名单API列表
隧道不支持API的调用，只有白名单功能的API接口。
| 接口类型 | 接口 |
| ---------- | --------------------- | ------------------ |
| 白名单相关 | [添加白名单IP](https://www.qg.net/doc/178.html "添加白名单IP")
[删除白名单IP](https://www.qg.net/doc/179.html "删除白名单IP")
[查询白名单IP](https://www.qg.net/doc/180.html "[查询白名单IP]")
### 支持通过账密指定参数
####参数规则
| 参数 | 含义 | 格式 |示例
| ---------- | --------------------------- | ---------------------- |----------------------- |
| -A- | 指定地区（单个） | -A-{国家编码} 或 -A-{国家英文缩写} |-A-990100 / -A-US |
| -C- | 指定通道 | -C-{通道名} |-C-tunnel3 |
| -S- | 指定通道（同 -C-） | -S-{通道名} |-S-tunnel1 |
| -T- | 指定存活时长（秒） | -T-{秒数} | -T-60 |
* -A- 格式支持拼在authkey后面，也支持拼在authpwd后面。同时支持国家编码和英文国家/地区缩写（如 US、JP、KR、GB 等）。
兼容旧格式 :A、:C、:T（如 :A990100、:Cchannel-1、:T60），旧格式仅支持拼在密码后面。
####参数拼接说明
所有参数不区分位置，可以拼接在 Authkey（用户名） 后面，也可以拼接在 AuthPwd（密码） 后面，也可以两边同时拼接，顺序不固定。
```curl
curl -x {Authkey}{参数}:{AuthPwd}{参数}@{隧道服务器} {目标url}
```
示例：
```curl
// 参数全部拼在 Authkey 后面
curl -x authkey-C-tunnel1-A-US-T-60:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 参数全部拼在 AuthPwd 后面
curl -x authkey:password-C-tunnel1-T-60-A-US@overseas-hk.tunnel.qg.net:12195 ip.sb
// 参数分散在两边
curl -x authkey-T-60:password-A-US-C-tunnel1@overseas-hk.tunnel.qg.net:12195 ip.sb
```
优先级： 当两侧同时指定了相同参数时，密码侧优先。
####指定使用某个国家的IP
隧道代理每次请求会随机更换IP，通过 -A- 可将随机范围限定到某个地区。
使用英文缩写
```curl
curl -x authkey-A-US:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 或
curl -x authkey:password-A-US@overseas-hk.tunnel.qg.net:12195 ip.sb
```
使用国家编码
```curl
curl -x authkey-A-990100:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 或
curl -x authkey:password-A-990100@overseas-hk.tunnel.qg.net:12195 ip.sb
```
编码详见 [海外区域编码表](https://www.qg.net/doc/2282.html)，英文缩写采用 ISO 标准国家/地区代码。
```保持IP不变
如果需要多个请求维持同一个IP（如登录 + 获取数据），可通过 -T- 指定存活时长（单位：秒）。
隧道代理下，-T- 必须与 -S-（或 -C-）同时传或同时不传。 通道名为任意非特殊符号字符串。
```curl
// 参数全在用户名侧
curl -x authkey-T-30-S-tunnel1:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 参数全在密码侧
curl -x authkey:password-T-30-S-tunnel1@overseas-hk.tunnel.qg.net:12195 ip.sb
// 参数分布在两侧
curl -x authkey-T-30:password-S-tunnel1@overseas-hk.tunnel.qg.net:12195 ip.sb
```
* 注意： 仅指定 -T- 而不指定通道，无法保证IP不变。如果需要保持IP不变一段时间，那么不可以使用通用的overseas.tunnel.qg.net域名，需要使用特定地区的服务器域名，比如：overseas-us.tunnel.qg.net/overseas-hk.tunnel.qg.net等!!!否则服务器无法保证是否可以保持IP不变。
####组合使用
多个参数可以自由组合，顺序不限。
// 英文缩写指定美国 + 通道 + 存活时长
```curl
curl -x authkey-A-US-S-tunnel1-T-30:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 编码方式指定美国 + 通道 + 存活时长（参数在密码侧）
curl -x authkey:password-A-990100-C-tunnel3-T-30@overseas-hk.tunnel.qg.net:12195 ip.sb
// 参数分布在两侧
curl -x authkey-A-JP-T-30:password-S-tunnel1@overseas-hk.tunnel.qg.net:12195 ip.sb
```
####指定隧道服务器
为了降低使用隧道服务的延迟，青果网络为隧道代理（全球HTTP）提供了多个隧道服务器，用户可根据自身的使用情况就近选择隧道服务器。隧道服务器的地址可在控制台中查看。
```curl
curl -x {Authkey}{参数}:{AuthPwd}{参数}@{隧道服务器} {目标url}
// 例子，更换隧道服务器为美国的隧道服务器
curl -x authkey-A-US-S-tunnel1-T-30:password@overseas-hk.tunnel.qg.net:12195 ip.sb
```
隧道代理（全球HTTP）开发者指南
## 步骤总览
**注：若使用白名单验证模式，请先添加白名单再进行API接口获取。**
## 一、获取隧道地址
1.在开通隧道代理（全球HTTP）后，就会进入后台管理面板，会看到如以下画面。在业务列表中，可以看到对应的隧道地址。
隧道代理特殊的地方就在于不需要提取和管理大量IP，只需要拿到1个隧道地址便可直接在使用过程中获得所需动态IP，获取隧道地址就近似于获取其他代理产品的IP地址与端口。
**请注意，**目前国内代理IP和全球HTTP的产品，除了按量提取对应的套餐是按量业务之外，其他产品都属于按时业务。
#### 二、授权验证
获取隧道地址之后，还需要有授权验证才能使用代理。青果代理支持白名单和帐密两种验证方式，可自主选择使用。
白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功；
账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。
详细步骤可查看[代理验证](https://www.qg.net/doc/use/8_244/1574.html)
##三、代理测试
在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。
以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。
`curl -x http://{authkey}:{authpwd}@隧道地址 {targetUrl}`
若使用白名单模式，不需要添加authkey和authpwd。
`curl -x {隧道服务器} {目标url}`
例子 curl -x overseas.tunnel.qg.net:15561 www.baidu.com
## 四、编写采集程序
测试代理可用后，便可开始编写代理采集程序了。
青果提供了以下的编程语言的代码示例以供开发者进行隧道代理参考，
＞＞[隧道代理 Go 语言接入指南](https://www.qg.net/doc/sdk/9_230/1872.html)
＞＞[隧道代理 Python 语言接入指南](https://www.qg.net/doc/sdk/9_230/1879.html)
## 其他应用
另外，虽然隧道代理不需要API接口就能使用代理，但也提供了白名单验证的接口，以下简单介绍隧道相关的白名单接口使用以及一些指定功能。
### 白名单API列表
隧道不支持API的调用，只有白名单功能的API接口。
| 接口类型 | 接口 |
| ---------- | --------------------- | ------------------ |
| 白名单相关 | [添加白名单IP](https://www.qg.net/doc/178.html "添加白名单IP")
[删除白名单IP](https://www.qg.net/doc/179.html "删除白名单IP")
[查询白名单IP](https://www.qg.net/doc/180.html "[查询白名单IP]")
### 支持通过账密指定参数
####参数规则
| 参数 | 含义 | 格式 |示例
| ---------- | --------------------------- | ---------------------- |----------------------- |
| -A- | 指定地区（单个） | -A-{国家编码} 或 -A-{国家英文缩写} |-A-990100 / -A-US |
| -C- | 指定通道 | -C-{通道名} |-C-tunnel3 |
| -S- | 指定通道（同 -C-） | -S-{通道名} |-S-tunnel1 |
| -T- | 指定存活时长（秒） | -T-{秒数} | -T-60 |
* -A- 格式支持拼在authkey后面，也支持拼在authpwd后面。同时支持国家编码和英文国家/地区缩写（如 US、JP、KR、GB 等）。
兼容旧格式 :A、:C、:T（如 :A990100、:Cchannel-1、:T60），旧格式仅支持拼在密码后面。
####参数拼接说明
所有参数不区分位置，可以拼接在 Authkey（用户名） 后面，也可以拼接在 AuthPwd（密码） 后面，也可以两边同时拼接，顺序不固定。
```curl
curl -x {Authkey}{参数}:{AuthPwd}{参数}@{隧道服务器} {目标url}
```
示例：
```curl
// 参数全部拼在 Authkey 后面
curl -x authkey-C-tunnel1-A-US-T-60:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 参数全部拼在 AuthPwd 后面
curl -x authkey:password-C-tunnel1-T-60-A-US@overseas-hk.tunnel.qg.net:12195 ip.sb
// 参数分散在两边
curl -x authkey-T-60:password-A-US-C-tunnel1@overseas-hk.tunnel.qg.net:12195 ip.sb
```
优先级： 当两侧同时指定了相同参数时，密码侧优先。
####指定使用某个国家的IP
隧道代理每次请求会随机更换IP，通过 -A- 可将随机范围限定到某个地区。
使用英文缩写
```curl
curl -x authkey-A-US:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 或
curl -x authkey:password-A-US@overseas-hk.tunnel.qg.net:12195 ip.sb
```
使用国家编码
```curl
curl -x authkey-A-990100:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 或
curl -x authkey:password-A-990100@overseas-hk.tunnel.qg.net:12195 ip.sb
```
编码详见 [海外区域编码表](https://www.qg.net/doc/2282.html)，英文缩写采用 ISO 标准国家/地区代码。
```保持IP不变
如果需要多个请求维持同一个IP（如登录 + 获取数据），可通过 -T- 指定存活时长（单位：秒）。
隧道代理下，-T- 必须与 -S-（或 -C-）同时传或同时不传。 通道名为任意非特殊符号字符串。
```curl
// 参数全在用户名侧
curl -x authkey-T-30-S-tunnel1:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 参数全在密码侧
curl -x authkey:password-T-30-S-tunnel1@overseas-hk.tunnel.qg.net:12195 ip.sb
// 参数分布在两侧
curl -x authkey-T-30:password-S-tunnel1@overseas-hk.tunnel.qg.net:12195 ip.sb
```
* 注意： 仅指定 -T- 而不指定通道，无法保证IP不变。如果需要保持IP不变一段时间，那么不可以使用通用的overseas.tunnel.qg.net域名，需要使用特定地区的服务器域名，比如：overseas-us.tunnel.qg.net/overseas-hk.tunnel.qg.net等!!!否则服务器无法保证是否可以保持IP不变。
####组合使用
多个参数可以自由组合，顺序不限。
// 英文缩写指定美国 + 通道 + 存活时长
```curl
curl -x authkey-A-US-S-tunnel1-T-30:password@overseas-hk.tunnel.qg.net:12195 ip.sb
// 编码方式指定美国 + 通道 + 存活时长（参数在密码侧）
curl -x authkey:password-A-990100-C-tunnel3-T-30@overseas-hk.tunnel.qg.net:12195 ip.sb
// 参数分布在两侧
curl -x authkey-A-JP-T-30:password-S-tunnel1@overseas-hk.tunnel.qg.net:12195 ip.sb
```
####指定隧道服务器
为了降低使用隧道服务的延迟，青果网络为隧道代理（全球HTTP）提供了多个隧道服务器，用户可根据自身的使用情况就近选择隧道服务器。隧道服务器的地址可在控制台中查看。
```curl
curl -x {Authkey}{参数}:{AuthPwd}{参数}@{隧道服务器} {目标url}
// 例子，更换隧道服务器为美国的隧道服务器
curl -x authkey-A-US-S-tunnel1-T-30:password@overseas-hk.tunnel.qg.net:12195 ip.sb
```
短效代理-使用指南-开发版
青果为有经验的开发者提供多种API接口及代码示例，以协助开发者更便利地使用代理。
本篇仅以【提取IP】这一操作为例，介绍如何使用API接口-代码方式来使用代理。
## 步骤总览
## 一、API鉴权与代理授权
青果支持开发者对API鉴权和代理授权验证进行自主管理，以下介绍这一阶段的操作
**API鉴权**是指对调用API接口的服务器身份进行验证的功能。启用鉴权可以提高安全性，用户可以根据需要选择启用或关闭该功能。
用户可根据意愿选择开启和关闭API鉴权（默认关闭），青果提供的鉴权方式有密码和白名单两种，在对应业务【操作】-【业务设置】-【API鉴权/白名单】中进行设置即可。
**代理授权验证**是指对代理身份进行验证，只有通过对应信息才能使用该代理IP，确保您的使用权益和安全性。
青果代理IP支持白名单和帐密两种验证方式，可自主选择使用。
白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功；
账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。
白名单设置的入口与API鉴权一样。
详细步骤可查看＞[如何使用API鉴权](https://www.qg.net/doc/2283.html)、[代理验证](https://www.qg.net/doc/1574.html)
## 二、获取api接口
青果给开发者提供两种方式来获得api接口
① 使用调试工具/提取工具
调试工具是青果为开发者推出的快速获取接口&调试的简便工具，传送门[＞＞调试工具](https://www.qg.net/tools/IPdebug.html)
使用调试工具，用户需要先在左侧栏目中选好产品及接口类型，并在右侧表格的参数值列中填写所需信息，便可在页面上方看到完整的【请求地址】，这便是提取IP的API接口。
点击【发送】还能快速调试，查看响应结果，确认该代理接口是否可用。
调试工具除了有提取IP接口，还提供查询在用IP、资源池、资源地区等接口。
若只需要提取IP，也可以使用提取工具，进行简单的选择便可以获取一样的接口链接。传送门[＞＞提取工具 ](https://www.qg.net/tools/IPget.html)
② 查看api接口文档
除了简便工具，开发者也可以通过更原始的接口文档，自主编写所需的接口链接。
**点击了解API接口文档 ＞[弹性提取类型](https://www.qg.net/doc/product/6_255_263_264/2254.html)、[按量提取类型](https://www.qg.net/doc/product/6_255_263_265/2140.html)、[均匀提取类型](https://www.qg.net/doc/product/6_255_263_266/2258.html)、[通道提取类型](https://www.qg.net/doc/product/6_255_263_267/2139.html)**
## 三、代理测试
在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。
以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。
`curl -x http://{authkey}:{authpwd}@{118.92.69.112}:{32105} {targetUrl}`
若响应不成功，可对应[错误码表](https://www.qg.net/doc/1838.html)，排查问题。
## 四、编写采集程序
测试代理可用后，便可开始编写代理采集程序了。
青果提供了多种编程语言的代码示例供开发者参考，
详情查看
- [C语言代码示例](https://www.qg.net/doc/sdk/9_230/1694.html)
- [Go语言代码示例](https://www.qg.net/doc/sdk/9_230/1695.html)
- [PHP语言代码示例](https://www.qg.net/doc/sdk/9_230/1696.html)
- [Python语言代码示例](https://www.qg.net/doc/sdk/9_230/1697.html)
- [Java语言代码示例](https://www.qg.net/doc/sdk/9_230/1698.html)
- [Shell语言代码示例](https://www.qg.net/doc/sdk/9_230/1699.html)
- [C#语言代码示例](https://www.qg.net/doc/sdk/9_230/1700.html)
- [Node语言代码示例](https://www.qg.net/doc/sdk/9_230/1701.html)
**注：**青果代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。
## 其他应用
### 隧道池支持通过账密指定参数
####参数规则
| 参数 | 含义 | 格式 |示例
| ---------- | --------------------------- | ---------------------- |----------------------- |
| -A- | 指定地区（单个） |-A-{地区编码} |-A-120100（天津） |
| -T- | 指定存活时长（秒） | -T-{秒数} | -T-60 |
* -A- 格式支持拼在authkey后面，也支持拼在authpwd后面。国内代理仅支持通过地区编码指定地区。编码详见 国内区域编码表。
兼容旧格式 :A、:T（如 :A120100、:T60），旧格式仅支持拼在密码后面。
####参数拼接说明
所有参数不区分位置，可以拼接在 Authkey（用户名） 后面，也可以拼接在 AuthPwd（密码） 后面，也可以两边同时拼接，顺序不固定。
```curl
curl -x {Authkey}{参数}:{AuthPwd}{参数}@{隧道服务器} {目标url}
```
示例：
```curl
# 参数全部拼在 Authkey 后面
curl -x authkey-A-120100-T-60:password@tun-szbhry.qg.net:25889 myip.ipip.net
# 参数全部拼在 AuthPwd 后面
curl -x authkey:password-A-120100-T-60@tun-szbhry.qg.net:25889 myip.ipip.net
# 参数分散在两边
curl -x authkey-T-60:password-A-120100@tun-szbhry.qg.net:25889 myip.ipip.net
```
优先级： 当两侧同时指定了相同参数时，密码侧优先。
####指定使用某个国家的IP
隧道池业务达到存活时长后会更换IP，通过 -A- 可将随机范围限定到某个地区。
使用地区编码
```curl
curl -x authkey:password-A-120100@tun-szbhry.qg.net:25889 myip.ipip.net
// 或
curl -x authkey-A-120100:password@tun-szbhry.qg.net:25889 myip.ipip.net
```
如果两侧同时指定了地区，密码侧优先：
```curl
// 用户名指定天津(120100)，密码指定北京(110100)，最终使用北京IP
curl -x authkey-A-120100:password-A-110100@tun-szbhry.qg.net:25889 myip.ipip.net
```
地区编码详见 [国内区域编码表](https://www.qg.net/doc/2281.html)。
####保持IP不变
如果需要多个请求维持同一个IP（如登录 + 获取数据），可通过 -T- 指定存活时长（单位：秒）。
隧道池无需传通道，直接传 -T- 即可保持IP。 若指定的存活时长超出套餐限制，系统会自动按套餐允许的最大时长处理，不会超出。
```curl
// 保持IP 30秒，无需指定通道
curl -x authkey:password-T-30@tun-szbhry.qg.net:25889 myip.ipip.net
// 参数在用户名侧
curl -x authkey-T-30:password@tun-szbhry.qg.net:25889 myip.ipip.net
```
####组合使用
多个参数可以自由组合，顺序不限。
```curl
// 指定地区 + 存活时长
curl -x authkey:password-A-120100-T-30@tun-szbhry.qg.net:25889 myip.ipip.net
// 参数分布在两侧
curl -x authkey-A-120100:password-T-30@tun-szbhry.qg.net:25889 myip.ipip.net
// 参数全在用户名侧
curl -x authkey-A-110100-T-30:password@tun-szbhry.qg.net:25889 myip.ipip.net
```
隧道代理-使用指南-开发版
青果隧道代理与其他形式的代理IP不同，不需要API接口即可连接使用代理IP，因此省去了获取IP和管理IP池等动作。以下介绍如何用代码方式，快速使用隧道代理。
## 步骤总览
## 一、获取隧道地址
1.在青果完成产品购买后，就会自动进入控制后台，看到如以下的页面，产品列中就有隧道地址；
**请注意，**目前国内代理IP和全球HTTP的产品，除了按量提取对应的套餐是按量业务之外，其他产品都属于按时业务。
## 二、授权验证
获取到隧道地址之后，还需要有授权验证才能使用代理。隧道代理支持白名单和帐密两种验证方式，可自主选择使用。
白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功；
账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。
详细步骤可查看[代理验证 ＞](https://www.qg.net/doc/use/8_244/1574.html)
## 三、代理测试
在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。
以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。
`curl -x http://{authkey}:{authpwd}@隧道地址 {targetUrl}`
若响应不成功，可对应[错误码表](https://www.qg.net/doc/1838.html)，排查问题。
## 四、编写采集程序
测试代理可用后，便可开始编写代理采集程序了。
青果提供了多种编程语言的代码示例供开发者参考，
详情查看
- [隧道代理 Go 语言接入指南](https://www.qg.net/doc/1872.html)
- [隧道代理 Python 语言接入指南](https://www.qg.net/doc/1879.html)
**注：**青果代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。
## 五、其他应用
####参数规则
| 参数 | 含义 | 格式 |示例
| ---------- | --------------------------- | ---------------------- |----------------------- |
| -A- | 指定地区（单个） | -A-{地区编码} |-A-120100（天津） |
| -C- | 指定通道 | -C-{通道名} |-C-tunnel3 |
| -S- | 指定通道（同 -C-） | -S-{通道名} |-S-tunnel1 |
| -T- | 指定存活时长（秒） | -T-{秒数} | -T-60 |
* -A- 格式支持拼在authkey后面，也支持拼在authpwd后面。国内代理仅支持通过地区编码指定地区。编码详见 国内区域编码表。
兼容旧格式 :A、:C、:T（如 :A120100、:Cchannel-1、:T60），旧格式仅支持拼在密码后面。
####参数拼接说明
所有参数不区分位置，可以拼接在 Authkey（用户名） 后面，也可以拼接在 AuthPwd（密码） 后面，也可以两边同时拼接，顺序不固定。
```curl
curl -x {Authkey}{参数}:{AuthPwd}{参数}@{隧道服务器} {目标url}
```
示例：
```curl
# 参数全部拼在 Authkey 后面
curl -x authkey-C-tunnel1-A-120100-T-60:password@tun-szbhry.qg.net:25889 myip.ipip.net
# 参数全部拼在 AuthPwd 后面
curl -x authkey:password-C-tunnel1-T-60-A-120100@tun-szbhry.qg.net:25889 myip.ipip.net
# 参数分散在两边
curl -x authkey-T-60:password-A-120100-C-tunnel1@tun-szbhry.qg.net:25889 myip.ipip.net
```
* 优先级： 当两侧同时指定了相同参数时，密码侧优先。
####指定使用某个国家的IP
隧道代理每次请求会随机更换IP，通过 -A- 可将随机范围限定到某个地区。
使用英文缩写
```curl
curl -x authkey:password-A-120100@tun-szbhry.qg.net:25889 myip.ipip.net
// 或
curl -x authkey-A-120100:password@tun-szbhry.qg.net:25889 myip.ipip.net
```
如果两侧同时指定了地区，密码侧优先：
```curl
// 用户名指定天津(120100)，密码指定北京(110100)，最终使用北京IP
curl -x authkey-A-120100:password-A-110100@tun-szbhry.qg.net:25889 myip.ipip.net
```
地区编码详见 [国内区域编码表](https://www.qg.net/doc/2281.html)。
####保持IP不变
如果需要多个请求维持同一个IP（如登录 + 获取数据），可通过 -T- 指定存活时长（单位：秒）。
隧道代理下，-T- 必须与 -S-（或 -C-）同时传或同时不传。 通道名为任意非特殊符号字符串。
```curl
// 参数全在密码侧
curl -x authkey:password-S-tunnel1-T-30@tun-szbhry.qg.net:25889 myip.ipip.net
// 参数全在用户名侧
curl -x authkey-S-tunnel1-T-30:password@tun-szbhry.qg.net:25889 myip.ipip.net
// 参数分布在两侧
curl -x authkey-T-30:password-S-tunnel1@tun-szbhry.qg.net:25889 myip.ipip.net
```
注意： 仅指定 -T- 而不指定通道，无法保证IP不变。
####组合使用
多个参数可以自由组合，顺序不限。
```curl
// 参数全在密码侧
curl -x authkey:password-A-120100-C-tunnel3-T-30@tun-szbhry.qg.net:25889 myip.ipip.net
// 参数分布在两侧
curl -x authkey-A-120100:password-S-tunnel1-T-30@tun-szbhry.qg.net:25889 myip.ipip.net
// 参数全在用户名侧
curl -x authkey-A-110100-S-tunnel2-T-30:password@tun-szbhry.qg.net:25889 myip.ipip.net
```
