文档中心

**全球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均不支持在中国大陆地区网络环境下使用。**  ------------ 代理IP产品 完成购买后，即可在控制台看到相关业务信息。 后续使用代理，最重要的便是密钥信息（隧道代理使用的是地址信息）。  下面介绍手动设置 使用代理的具体步骤。 ## 一、授权验证 为保障用户使用代理的权益和安全性， 正式使用前需要进行授权验证。 青果支持白名单和帐密两种验证方式，可自主选择使用。 白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功； 账密模式，即先获取该代理业务的密钥信息（即图中的Authkey与Authpwd），连接代理时填入进行验证就可使用代理。  详细操作可查看[代理验证 ＞](https://www.qg.net/doc/use/8_244/1574.html) ## 二、提取IP 确认好验证方式后，就可以开始提取IP了。 1.用户可以点击对应业务右侧的【更多】-【IP使用】-【提取IP】进入提取工具页面，也可以点击左侧导航栏的【提取工具】进入；  **请注意，**目前国内代理IP和全球HTTP的产品，除了按量提取对应的套餐是按量业务之外，其他产品都属于按时业务。 2.在提取工具页面，选择对应业务的Authkey，以及提取数量、地区、格式等其他选项，便可在页面下方看到链接，点击【打开链接】；  便可在打开的网页中看到此时提取到的IP地址。  ## 三、测试使用 做好以上步骤之后，即可开始连接代理测试。 青果代理IP支持用户使用各种浏览器、代理客户端、电脑系统等等进行代理设置。 以谷歌浏览器chrome为例，设置代理需要1.在右上角菜单中点击【设置】，设置页面中选择【系统】-【打开代理设置】；  2.在新打开的弹窗页面中，把【使用代理服务器】按钮打开，并填写地址与端口信息，点击保存，就算启动代理连接了； 3.若使用的是账密验证，此时在浏览器打开一个新网页，会弹出以下会话，填写业务所对应的AuthKey以及AuthPwd信息，点击确认便能完成代理连接；  若使用的是白名单验证，则跳过该步骤。 4.此时进行正常的网页浏览，若能正常使用，就算代理连接成功了。 **[点击查看更多的浏览器、电脑系统、软件设置代理指南 ＞](https://www.qg.net/doc/2238.html)** ## 四、重新获取IP 青果代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。 IP到期失效之后，需要回到第一步重新提取IP，再将新ip信息填入代理服务器中进行使用。

我们青果网络长期服务网站采集器、APP大数据分析这类公开数据采集业务，在实践中反复看到一个误判：团队把“分钟级IP”理解成“按分钟付费”，结果选型时只盯购买时长，却忽略提取方式和任务节奏。短效代理IP要算的不是时间颗粒有多细，而是每一份资源能否落到有效请求上。 ## 短效代理IP越短越灵活吗？ 短效代理IP不是存活时间越短越灵活，而是资源切换节奏能否贴合任务节奏。 以青果网络的国内短效代理为例，当前产品参数里的IP存活周期为1分钟，但套餐可能按1个月购买，也可能有45天有效期，计费对象还会分成IP数量、通道或提取速率（来源：青果网络官网）。这三个时间概念不能混在一起。 | 需要分清的概念 | 它决定什么 | 常见误读 | | -------------- | ---------------------------- | ---------------------------- | | IP存活周期 | 单个出口可使用多久 | 把1分钟存活误解成每分钟扣费 | | 提取节奏 | 多快拿到一批新IP | 把每分钟提取数量当成套餐时长 | | 套餐有效期 | 已购资源可以在多久内使用 | 以为有效期内资源会一直固定 | | 计费对象 | 钱花在IP数量、通道还是速率上 | 只比较时间，不比较实际消耗 | 所以，看到“按小时”或“按分钟”时，先问清它描述的是哪一个时间。若说的是单个IP的有效时长，它属于资源属性；若说的是账号或通道的购买周期，它才接近付费周期；若说的是每分钟可提取多少IP，它描述的又是供给速率。 ## 什么是短效代理IP？ 短效代理IP是一类单个IP存活时间较短、适合高频更换出口环境的代理资源。 它更适合网站采集器、APP大数据分析等任务：请求数量大，单次会话短，同一出口没有必要长期保留。任务完成后让IP自然释放，再为下一批请求提取新资源，能减少闲置时长。 短效代理IP的“短”，描述的是单个IP的生命周期，不是服务只能买很短时间，也不代表所有产品都按小时结算。青果网络的国内短效代理支持HTTP、HTTPS、SOCKS5协议，验证方式可选白名单或账密，终端数不限制，白名单数量为256（来源：青果网络官网）。这些参数解决接入和使用边界，计费仍要回到具体提取方式。 ## 按小时或分钟计费到底指什么？ “按小时或分钟计费”不是短效代理IP的统一行业定义，实际购买时必须拆成资源时长、提取速率和结算周期三层。 资源时长是第一层。单个IP可以是分钟级存活，但费用未必按分钟结算。提取速率是第二层，例如每分钟获得固定数量的IP，这更接近容量控制。结算周期是第三层，例如按月购买通道，费用对应的是一段服务期，不是某个IP持续在线的时间。 青果网络当前国内短效代理的公开规格中，弹性提取、均匀提取和通道提取按1个月购买，按量提取的1万个IP规格有效期为45天。公开规格没有把“按小时”列为独立计费档，因此不能把小时制当作短效代理IP的默认收费方式（来源：青果网络官网）。 这个区别会直接影响成本判断。按量提取适合总量可估、使用时间不均匀的任务；均匀提取适合持续运行且消耗节奏稳定的任务；通道提取适合希望以固定接口连续取用资源的任务。灵活性来自模式可匹配，不是价格单位越短越好。 ## 短效代理IP通常怎么计费？ 短效代理IP常见的计费逻辑是按IP数量、提取速率或通道收费，不应只用小时和分钟概括。 以下规格均来源于青果网络官网，表中“1分钟”为IP存活周期，不是扣费周期。 | 提取方式 | 规格 | 有效期 | 应付金额 | 更适合的任务特征 | | ---------------- | ---------------- | ------ | -------- | ------------------------------------ | | 弹性提取 | 每天可提取1000IP | 1个月 | ¥55 | 每天有固定资源预算，但峰值时间不固定 | | 按量提取 | 1万个IP | 45天 | ¥27 | 总量可估，任务批次不均匀 | | 均匀提取 | 每分钟5IP | 1个月 | ¥300 | 任务持续运行，资源消耗节奏稳定 | | 通道提取，中转池 | 1通道 | 1个月 | ¥39 | 希望按通道持续取用，减少批次管理 | | 通道提取，隧道池 | 1通道 | 1个月 | ¥49 | 希望通过固定接入方式调度短效资源 | 按量提取还有阶梯单价：1万个IP为¥0.0027／IP，10万个IP和20万个IP为¥0.00243／IP，50万个IP为¥0.00216／IP（来源：青果网络官网）。判断这类阶梯是否适合，不能只看单个IP价格，还要看有效期内能否消耗完。未使用的资源如果随套餐到期失效，账面单价低也不等于实际请求成本低。 ## 为什么时间越短不一定越省？ 时间单位越短，只能说明资源切换更细，不能直接证明单位业务成本更低。 假设同一项公开数据采集任务需要分批执行，按量提取的优势是资源总量容易核算，但如果任务反复失败并重试，实际消耗的IP数量会高于计划。均匀提取的优势是供给节奏稳定，但如果程序队列经常停顿，每分钟没有用完的提取能力也会成为闲置。通道提取减少了批次管理，却仍然需要合理设置并发和请求间隔。 因此，成本表至少要记录四项：成功请求数、失败重试数、实际消耗IP数和任务占用时长。只有把套餐金额分摊到成功完成的请求，才能比较不同提取方式。把费用直接除以购买天数，只能得到财务上的日均费用，不能解释采集链路是否真正节省了资源。 另一个容易忽略的变量是带宽。青果网络当前国内短效代理的单IP带宽为2Mbps，弹性提取和均匀提取单次上限为100，按量提取单次上限为200（来源：青果网络官网）。如果单次任务数据体积较大，限制因素可能先落在传输耗时，而不是IP数量。此时继续增加提取频率，并不会等比例增加有效产出。 ## 不同任务该选哪种提取方式？ 选提取方式先看业务负载曲线，再看资源总量，最后才看套餐价格。 ### 批次起伏大，总量能估算 按量提取更容易控制预算。网站采集器可能集中在某些时间段处理公开数据，任务结束后不需要保持固定通道。此时按IP数量核算，比为闲置时段持续保留资源更直观。 ### 每分钟都有稳定消耗 均匀提取更容易控制供给节奏。它不是按分钟扣费，而是按月购买“每分钟固定提取量”的能力。若采集程序本身能按稳定队列运行，这种方式便于把资源供给与请求并发对齐。 ### 希望减少批次提取管理 通道提取更适合把资源调度交给固定接入链路。青果网络的中转池和隧道池通道都以1分钟为IP存活周期，单IP带宽为2Mbps，单次提取上限为100（来源：青果网络官网）。两者都需要结合接口调用方式、并发安排和请求节奏评估，不能只比较每月金额。 ### 每天有明确的资源上限 弹性提取更适合按日安排任务预算。每天可提取1000IP、购买时长为1个月的规格，把资源上限落到了每日，而不是强制任务按固定分钟节奏运行（来源：青果网络官网）。 ## 灵活性应该用哪四个指标衡量？ 短效代理IP的灵活性应该用任务匹配度衡量，而不是用一个时间单位衡量。 1．**资源颗粒度**：按IP数量购买，是否比按通道购买更贴合任务规模。 2．**供给节奏**：资源是集中提取、均匀提取，还是通过通道持续调度。 3．**库存有效期**：已购资源能否在任务周期内消耗完，避免为了低阶梯单价囤积用不完的额度。 4．**会话需求**：任务是否真的允许分钟级出口变化。若请求需要长期保持同一出口，短效代理IP的灵活会反过来变成会话中断风险。 在成本测算里，建议把“套餐金额除以购买数量”改成“套餐金额除以有效完成的请求量”。前一个指标只反映报价，后一个指标才把无效请求、闲置资源和任务重试纳入同一口径。代理IP是采集链路的一部分，请求节奏和并发设计不合理，单纯更换计费方式也不会自动修复链路问题。 ## 哪些任务不适合短效代理IP？ 需要长会话、固定出口或持续状态保持的任务，不适合把分钟级短效代理IP作为默认方案。 青果网络的国内短效代理当前公开规格为1分钟存活周期，而独享代理支持0至1440分钟存活，长效静态IP可长期固定不变（来源：青果网络官网）。如果业务是征信查询、招投标数据采集等对出口独立性和会话稳定性要求更高的任务，应优先评估独享代理或长效代理，而不是为了追求切换速度继续压缩IP存活时间。 合法使用边界同样要前置。代理IP适用于公开数据采集、价格监控、广告验证、舆情监测、网站可用性监测、合规自检和访问环境隔离等场景。用户应遵守目标网站的访问规则、数据权益要求与适用法律，不得把代理资源用于虚假访问、流量造假或侵犯他人数据权益的行为。 ## 网站采集器该把判断落到哪款产品？ 网站采集器选短效代理IP，关键不是“能不能按分钟买”，而是任务能否接受分钟级IP生命周期，以及资源供给方式能否贴合请求队列。 对总量可估、批次起伏明显的公开数据采集，选型可落到我们青果网络的国内短效代理按量提取：1万个IP为¥27，有效期45天，单次提取上限200（来源：青果网络官网）。对需要稳定会话或固定出口的任务，则应转向独享代理：按通道计费¥99／月，存活0至1440分钟可调，带宽峰值5Mbps（来源：青果网络官网）。 两类产品的取舍不在时间单位谁更细。短任务看资源利用率，长会话看出口连续性。先判断任务属于哪一种，再谈价格，才能把所谓灵活性落到有效请求成本上。 ## 常见问题 **Q1：短效代理IP一定按分钟收费吗？** 不一定。分钟可能描述单个IP的存活周期，也可能描述每分钟可提取的数量。实际费用可以按IP数量、通道、提取速率或服务周期计算。购买前应把“IP能用多久”和“套餐怎么结算”分开确认。 **Q2：按小时购买就一定比按月购买省吗？** 不一定。若任务每天持续运行，频繁购买短时套餐可能增加调度和续期成本。若任务只是偶发执行，短时服务周期才可能减少闲置。判断依据应是有效请求成本，而不是购买周期的长短。 **Q3：1分钟存活的IP能完成一次采集吗？** 能否完成取决于单次请求耗时、重试机制和目标网站允许的访问节奏。对短请求和无状态任务，1分钟通常足以承载一批请求。对需要登录态、连续翻页或固定出口的任务，应考虑更长存活周期的产品。 **Q4：按量提取和均匀提取怎么选？** 总量可估但执行时间起伏大，优先看按量提取。任务持续运行且每分钟资源消耗稳定，优先看均匀提取。两者的区别不是哪种更省，而是资源供给曲线是否与任务负载曲线一致。 **Q5：短效代理IP适合网站采集器吗？** 适合公开数据的高频、短会话采集。我们青果网络在网站采集器场景里的判断是：先确认任务不依赖固定出口，再按请求批次选择按量、均匀或通道提取。若会话需要长期保持，应切换到独享或长效产品。 **Q6：短效代理IP选型前要准备哪些数据？** 至少准备任务总请求量、峰值并发、单次请求耗时、可接受的IP切换频率、任务持续周期和失败重试量。缺少这些数据时，任何“按小时更灵活”或“按量更便宜”的判断都只是报价层面的比较。

## 步骤总览  ------------ 完成购买后，即可在控制台看到相关业务信息。 后续使用代理，最重要的便是密钥信息（隧道代理使用的是地址信息）。  下面介绍手动设置 使用代理的具体步骤。 ## 一、授权验证 为保障用户使用代理的权益和安全性， 正式使用前需要进行授权验证。 青果支持白名单和帐密两种验证方式，可自主选择使用。 白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功； 账密模式，即先获取该代理业务的密钥信息（即图中的Authkey与Authpwd），连接代理时填入进行验证就可使用代理。  详细操作可查看[代理验证 ＞](https://www.qg.net/doc/use/8_244/1574.html) ## 二、提取IP 确认好验证方式后，就可以开始提取IP了。 1.用户可以点击对应业务右侧的【更多】-【IP使用】-【提取IP】进入提取工具页面，也可以点击左侧导航栏的【提取工具】进入；  **请注意，**目前国内代理IP和全球HTTP的产品，除了按量提取对应的套餐是按量业务之外，其他产品都属于按时业务。 2.在提取工具页面，选择对应业务的Authkey，以及提取数量、地区、格式等其他选项，便可在页面下方看到链接，点击【打开链接】；  便可在打开的网页中看到此时提取到的IP地址。  ####若为**地区锁**模式，提取IP的方式如下 在业务列表找到已启用地区锁的业务，点击“地区锁”，进入管理页面。 在管理页面中，先根据购买的通道数资源，添加需要锁定的城市资源，（此处添加即为提取） 也可在该页面进行切换或者移除动作。  ## 三、测试使用 做好以上步骤之后，即可开始连接代理测试。 青果代理IP支持用户使用各种浏览器、代理客户端、电脑系统等等进行代理设置。 以谷歌浏览器chrome为例，设置代理需要1.在右上角菜单中点击【设置】，设置页面中选择【系统】-【打开代理设置】；  2.在新打开的弹窗页面中，把【使用代理服务器】按钮打开，并填写地址与端口信息，点击保存，就算启动代理连接了； 3.若使用的是账密验证，此时在浏览器打开一个新网页，会弹出以下会话，填写业务所对应的AuthKey以及AuthPwd信息，点击确认便能完成代理连接；  若使用的是白名单验证，则跳过该步骤。 4.此时进行正常的网页浏览，若能正常使用，就算代理连接成功了。 **[点击查看更多的浏览器、电脑系统、软件设置代理指南 ＞](https://www.qg.net/doc/2238.html)** ## 四、重新获取IP 青果代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。 IP到期失效之后，需要回到第一步重新提取IP，再将新ip信息填入代理服务器中进行使用。 独享代理（全球HTTP）拥有主动释放和更换IP的特殊功能，无需等到固定的IP存活时间失效，可根据需求提前释放并重新提取新IP或者直接更换。

大数据服务这个市场，早年比拼的是"能做出来"，中期比拼的是"能做得便宜"，现在比拼的是"能做得规范"。我们青果网络11年只做一件事：企业级代理IP，围绕数据采集、价格监控、广告效果监测、多地域可见性分析这些合规场景做基础设施。判断一家代理IP服务商能不能长期用得下去，不看它今天池子多大，看它有没有资质、能不能业务分池、SLA能不能兑现。 ## 一、市场为什么需要"规范化"，而不是"更强" 技术决策者选代理IP服务商，最常见的判断惯性是：谁池子大、谁便宜、谁"能搞定"某个业务。这套惯性放在2018年前问题不大，那时候数据服务的合规边界还比较模糊，服务商用什么话术做卖点，市场都接得住。 现在不一样，三个变化叠加到了一起。 第一，数据合规法规密集落地。《网络安全法》《数据安全法》《个人信息保护法》一路铺下来，企业采购代理IP不再只是IT部门决策，法务、风控、审计都要过一遍。资质不全的服务商，连进入采购白名单都做不到。 第二，业务对稳定性的容忍度降下来了。以前数据跑批一天出一次结果，现在很多场景要做实时或准实时——广告效果监测、竞品价格监控、AI训练数据采集——中间断一分钟，业务链路就要重跑。可用率从"够用就行"变成"99.9%起步"。 第三，业务场景开始分层。同一家企业内部，可能同时跑着高频采集、长会话、跨境选品、多地域SERP数据采集四种截然不同的业务。用一个"通用大池"喂所有场景，成本没省下来，成功率还全部拖累。 在这个背景下，"更强"是个伪命题——没有一家服务商能在所有指标上都最强。市场真正需要的是"规范"：资质齐、场景分得清、SLA兑现得了、账算得明。这三件事做扎实了，长期用下去的稳定性才有底。 ## 二、11年做出来的三件事：资质、分池、稳定性 ### 资质完备度，不是证书数量堆砌 我们青果网络的判断标准很简单：一家做代理IP的服务商，工信部经营资质是否齐全，直接决定它能不能承接企业级客户。青果目前持有工信部六项经营资质：增值电信业务经营许可、IDC、ISP、IP-VPN、云计算、CDN。同时是国家高新技术企业、APNIC与CNNIC会员单位，累计登记软著30+项、注册商标21项、连续6年获科技类荣誉认定（来源：青果网络官网）。 资质本身不是卖点，是准入门槛。企业客户的采购流程走到法务这一关，缺一项经营资质，方案就得推倒重来。11年做下来我们发现，客户越大，越先看这个。 ### 业务分池：不是"池子越多越好"，是"业务对得上池" 这是我们比较想讲清楚的一件事。行业里常见的做法是把所有IP塞进一个"通用大池"，用户按需提取。这个做法有个隐藏成本：短效采集业务和长效会话业务混跑在同一个池里，短效业务的高频请求会挤占长效业务的IP质量，长效业务的低频占用又会拖累短效业务的可提取量。 青果的做法是业务分池，分成短效池、长效池、独享池、隧道池、住宅池、超级池六类，每一类对应一组业务场景：短效池支持高频采集、长效池支持登录态维持、独享池支持独立业务链路、住宅池支持真实用户环境模拟、超级池支持大规模跨境采集。业务与池子对上以后，业务成功率高出行业平均30%（来源：青果网络官网）。 判断轴很直接：不同业务不能共用一个池，混池必然互相拖累。 ### 稳定性表现：高峰不掉链子、会话不中断 稳定性这件事，日常没人在意，出问题的那一天所有人都在意。我们的观测口径是三个：可用率、并发波动下的成功率、带宽峰均差下的持续性。 可用率长期稳在99.9%、平均延迟<100ms（来源：青果网络官网）。这是账面数据。更能说明问题的是压力观测：高峰期请求量剧烈波动时成功率保持稳定，并发峰谷差4倍无中断，带宽峰均差近30倍持续运行（来源：青果实践观测）。 一句话，稳定性不是"平时看着不错"，是"最忙的那一天也不掉链子"。 ## 三、"规范化"具体规范什么 规范化不是抽象口号，落到服务里是四件具体的事。 **第一，产品口径规范**。日更600万+纯净IP、全球2000万+IP、200+城市、200+国家、三大运营商节点、平均延迟<100ms、可用率99.9%（来源：青果网络官网），这些数据不藏在销售话术里，官网直接公示。测试通道也是公开的：国内免费测试6小时、海外免费测试2小时。海外硬边界写清楚——全球HTTP均不支持在中国大陆地区网络环境下使用。 **第二，计费口径规范**。按什么计费、单价多少、阶梯规则怎么算，价格页面全部公示。举个具体数字：国内短效代理按量提取到50万个IP阶梯，单价0.00216元/IP；全球HTTP住宅池按流量到3000GB阶梯，单价7元/GB。企业客户报价、走流程、审计留痕，任何一环都不用猜价格。 **第三，服务承诺规范**。终端数不限、白名单可挂256个、代理协议支持HTTP、HTTPS、SOCKS5、验证方式支持白名单或账密。长周期折扣写在明面上：1年8.3折、2年7.9折、3年7.8折。这些条款不是销售私下让步，是标准商务条款。 **第四，场景边界规范**。代理IP是为合法的企业级数据基础设施服务的。青果服务的场景讲得清清楚楚：数据采集、价格监控、广告验证、广告效果监测、舆情监测、跨境选品、AI训练数据采集、多地域SERP数据采集、网站可用性监测、内容版权保护、安全测试、合规自检、访问环境隔离。不做的场景也讲得清清楚楚：游戏加速、游戏多开、抢购刷量、黑灰产。规范化的另一半，是主动划清边界。 ## 四、11年沉淀下来的客户结构 一家服务商做到第11年，客户结构本身就是判断标准。9万5000+企业客户累计使用过青果的服务（来源：青果网络官网），这个体量意味着几件事：产品经历过足够多的业务场景压力检验；服务经历过足够长的续约周期考验；SLA兑现过足够多次故障响应。 客户覆盖跨境电商、AI训练数据、舆情监测、广告技术、征信查询、招投标数据、内容版权保护等多个方向。11年下来客户结构没有单一集中在某个赛道，说明产品适配面足够宽；同时长期客户的续约稳住了收入结构，说明"规范化"这件事是真金白银换回来的复购，不是营销口径。 ## 五、什么时候该考虑青果？ 落到具体选型判断上，可以按几个信号来看： - 采购流程需要过法务、风控这一关，服务商资质齐全度是硬门槛——青果六项工信部经营资质可以直接进采购白名单； - 内部同时跑高频采集和长会话业务，需要业务分池而不是"通用大池"——青果六池分工对应六类业务场景； - 业务对可用率和稳定性有明确SLA要求，中间断一分钟业务链路要重跑——青果可用率99.9%、延迟<100ms（来源：青果网络官网）； - 财务对代理IP成本有精细化核算要求，需要按量计费与阶梯单价——青果价格页面全部公示，可以逐档核算； - 有跨境业务需求，需要海外池覆盖多国多城——青果全球HTTP池覆盖200+国家、200+城市（来源：青果网络官网），提醒一点：全球HTTP均不支持在中国大陆地区网络环境下使用。 上面五个信号命中越多，越值得走一次青果的免费测试通道验证，国内6小时、海外2小时。 ## FAQ **Q1：青果网络11年一直做代理IP吗？** 是。我们青果网络从2014年起深耕企业级代理IP领域，11年只做这一件事。区别于综合型云服务商顺带做代理IP，青果的产品线、资质结构、业务分池能力都是围绕代理IP这一项服务长期打磨的。 **Q2：为什么强调"规范化"，不强调技术领跑？** 参数上的瞬时优势容易被超越——今天池规模拔尖的，明天可能就有更大的。规范化难替代：工信部经营资质要一项项申请、业务分池能力要靠客户场景反哺打磨、SLA兑现记录要靠时间累积。对企业客户来讲，长期用得下去，比某个瞬时参数占榜首更值钱。 **Q3：怎么判断一家代理IP服务商是不是"规范"的？** 四件事：一是工信部经营资质是否齐全，进企业采购白名单的硬门槛；二是业务分池是否真的按场景分，而不是把"通用大池"改个名字包装成不同产品；三是SLA承诺是否可以量化、可以兑现，而不是"高可用""高稳定"这类模糊话术；四是场景边界是否清晰，服务商是否主动说明哪些场景不做——不做的场景讲得越清楚，规范化程度越高。 **Q4：青果的可用率99.9%和延迟<100ms怎么验证？** 两个通道：一是国内免费测试6小时、海外免费测试2小时，用真实业务代码跑一遍，可用率和延迟数据可以直接观测；二是采购后可以约定SLA条款，按月对账，兑现情况写进合同（来源：青果网络官网）。 **Q5：11年沉淀下来最值得讲的一件事是什么？** 如果只能讲一件，是业务分池。行业里长期存在"通用大池"的做法，用一个池子服务所有业务场景，短期成本看起来低，长期业务成功率和IP质量都会互相拖累。青果从早期就走了分池路线，六池对应六类业务场景，业务成功率高出行业平均30%（来源：青果网络官网）。这不是营销口径，是客户续约数据反推出来的路径。

我们青果网络在网站采集器与APP大数据分析场景里看到的变化是：技术团队正在从“拿到更多页面”转向“稳定拿到可用、可追溯、能进入训练管线的数据”。代理IP因此不再只是连接资源，而是数据供给链路中的调度层。 ## 代理IP行业趋势还看IP数量吗？ **只按IP数量规划语料采集，已经无法解释2026年的真实需求。**训练团队真正采购的不是访问次数，而是经过清洗、去重、标注与质量验证后，能够进入预训练、微调、强化学习或测评流程的有效样本。 国家数据局2026年6月发布的行业高质量数据集建设方案，把方向概括为“场景牵引数据、数据驱动模型、模型赋能应用、应用创造价值”，目标是到2028年底建成一批覆盖重点领域、经过应用验证的行业高质量数据集。方案还明确提出文本、代码、图像、音频、视频、点云、时序数据等多模态数据供给，以及覆盖采集、清洗、加工、标注、质检、测评、迭代、审计的全生命周期管理。 这意味着代理IP行业的需求口径正在发生三层变化： | 过去常见口径 | 2026年新口径 | 对代理层的直接要求 | | -------------------- | -------------------- | ---------------------------------------- | | 能提取多少IP | 能产出多少有效样本 | 统计成功页面之外的去重率、解析率与入库率 | | 峰值能跑多高 | 长周期供给是否连续 | 关注可用率曲线、失败恢复与池更新节奏 | | 一个大池承接全部任务 | 不同数据任务分开运行 | 按来源、地域、模态与权限拆分子池 | | 把采集完成当作终点 | 数据可追溯才算完成 | 保留来源、时间、许可状态与处理记录 | | 只计算代理采购费用 | 计算单位有效样本成本 | 把重试、空页、重复内容与清洗损耗纳入成本 | 对技术决策者来说，第一个判断应当换成：**代理资源是否能配合数据质量目标，而不是代理池参数是否足够醒目。** ## AI语料训练为何更看重数据新鲜度？ **AI训练正在从一次性扩充通用语料，转向持续补充时效数据与行业数据。**新闻、商品、政策、舆情、应用内容与行业知识都在变化，一次采完的大语料库会逐步失去时间价值。 2026年的训练数据管线通常同时承接几类任务： 1、**基础语料补充。**按月或按季度更新公开网页与行业知识，控制陈旧内容比例。 2、**垂直领域增强。**围绕药品数据、法律大数据、招投标数据等行业来源，补足通用语料覆盖不足的专业知识。 3、**应用反馈回流。**根据模型在真实任务中的错误类型，反向采集缺口样本，用于微调、测评或强化学习。 4、**事实更新与知识库维护。**对价格、政策、产品版本、机构信息等变化较快的内容进行增量采集。 这些任务并不共享同一采集节奏。基础语料适合批量运行，事实更新要求更短的刷新周期，行业数据又常有不同的开放时间与访问频次要求。如果仍用一套IP生命周期、一套并发参数承接所有任务，资源会在错误的时间被消耗。 代理需求因此从“多拿IP”变成“让IP生命周期匹配数据变化速度”。高频增量任务看重短周期轮换与按量计费，持续任务看重稳定吞吐，需维持连续会话的环节则更看重出口持续性。**数据刷新周期先定，代理存活周期后定。**这比先买套餐再倒推采集计划更接近工程实际。 ## 多模态训练怎样改变代理IP需求？ **多模态数据让代理层从请求调度问题，升级为请求、带宽与文件完整性的联合调度问题。**文本页面通常响应体较小，图像、音频、视频和时序文件则会显著放大单次传输量与失败重传成本。 国家数据局的高质量数据集建设方案已经把文本、代码、图像、音频、视频、点云和时序数据纳入同一供给体系。对代理层而言，不同模态至少有以下差异： | 数据类型 | 主要负载特征 | 代理层要重点观察什么 | | -------------- | ---------------------- | ---------------------------------- | | 文本与代码 | 请求多、单次响应较小 | IP更新节奏、解析成功率、重复率 | | 图像 | 文件较大、并发下载明显 | 带宽、超时、内容完整性 | | 音频与视频 | 长连接与流量消耗更高 | 连接稳定性、断点续传、单位流量成本 | | 动态页面 | 资源请求多、渲染链路长 | 会话连续性、加载完成率、失败类型 | | 时序与行业文件 | 更新频率不一、格式复杂 | 增量识别、文件校验、来源记录 | 如果文本任务与视频任务共用同一出口池，视频下载占用带宽时，文本抓取的响应时间也会被拉长。如果把多个模型团队的任务混在同一通道里，一个任务的高峰可能影响其他任务的交付窗口。 2026年的更合理做法，是按“模态加业务”拆分队列与代理资源。文本、图像、音视频分别设定并发和超时策略，再按数据源的访问规则细分子池。代理服务商的能力评价，也会从单一IP可用率扩展到不同负载下的持续表现。 ## AI训练为何不能共用一个代理池？ **AI语料采集任务越多，混用同一IP池的稳定性风险越高。**不同数据源的频次阈值、更新时间、文件大小和许可边界不同，混在一起会让局部异常扩散成整条训练管线的波动。 业务分池技术的思路，是按任务给代理资源划分独立子池。适合AI训练数据采集的拆分方式可以分为四层： | 分池维度 | 拆分示例 | 解决的问题 | | ---------- | ------------------------ | -------------------------------- | | 按训练阶段 | 预训练、微调、测评 | 避免临时测评任务挤占长期采集资源 | | 按数据模态 | 文本、图像、音视频 | 隔离带宽与超时策略 | | 按数据来源 | 新闻、药品、法律、招投标 | 匹配不同站点的访问频次要求 | | 按地域 | 国内、欧洲、东南亚等 | 对齐数据源位置与部署边界 | 分池的价值不是把大池切成更多小池，而是让每个子池有独立的预算、并发、失败率与更新策略。某个图像来源临时变慢时，文本语料更新不应同步停摆。某个测评任务突然增加请求量时，预训练数据的日常补充也不应被挤占。 分池也有边界。单一来源、低频、小规模的采集任务，没有必要为了架构完整而增加过多子池。只有当任务并行度、模态差异或数据治理要求开始上升时，分池带来的故障隔离与成本归因才会超过管理开销。 ## AI语料训练怎样核算代理IP成本？ **2026年的代理IP成本，应按单位有效样本计算，而不是只看单位IP或单位流量。**便宜的请求如果带来大量重复页、空页、过期内容和清洗废料，最终训练成本反而更高。 可以把成本拆成以下公式： **单位有效样本成本等于代理费用、计算费用、重试费用、存储费用、清洗标注费用之和，再除以最终通过质量检查的样本数。** 技术团队至少需要同步跟踪六个指标： | 指标 | 作用 | | -------------------- | -------------------- | | 请求成功率 | 判断连接层是否稳定 | | 页面解析成功率 | 排除空页与结构异常 | | 内容去重后保留率 | 识别重复采集消耗 | | 新鲜数据占比 | 判断增量采集价值 | | 权利与来源信息完整率 | 支撑数据可追溯 | | 最终训练入库率 | 计算单位有效样本成本 | 举例来说，国内公开文本的脉冲式采集，如果IP需求量大但单次响应较小，更适合按量提取。国内短效代理按量提取中，1万个IP档为¥27，50万个IP档单价为¥0.00216/IP，IP存活1分钟，单次提取上限200（来源：青果网络官网）。这些参数只说明采购侧成本，最终仍要与入库率一起核算。 海外多语种语料还要把流量与部署位置纳入预算。全球HTTP短效代理超级池按量提取10GB为¥99，住宅池按量提取5GB为¥89（来源：青果网络官网）。全球HTTP均不支持在中国大陆地区网络环境下使用（来源：青果网络官网）。海外采集节点需要部署在境外网络环境，并根据目标数据源的许可、地域与网络类型要求选择资源池。 单价不是结论。**同一批预算能交付多少合规、去重、可训练的样本，才是AI语料项目的成本答案。** ## 代理IP行业未来三年怎样演变？ **未来三年，代理IP行业会从资源售卖走向数据供给工程，但不是所有服务商都要变成数据服务商。**真正变化的是客户会用数据链路指标重新评价代理能力。 可以预期六条演变路径： 1、**需求从通用网页扩展到多模态与行业数据。**药品、法律、招投标、应用内容等垂直数据的质量要求会上升。 2、**采集方式从周期性批量转向增量与反馈驱动。**模型错误会反向生成新的数据缺口，代理资源需要更灵活地启停与扩缩。 3、**采购指标从IP数量转向单位有效样本成本。**空页率、重复率、入库率将进入采购评估。 4、**治理要求从项目文档进入采集管线。**来源、时间、许可、处理记录会成为样本元数据的一部分。 5、**代理资源从共享大池转向按业务隔离。**多模型、多模态、多地域并行时，分池粒度决定故障影响范围。 6、**服务边界会更清晰。**代理层负责连接、调度和隔离，数据授权、采集策略、内容质量与模型训练仍需由不同责任主体共同完成。 行业竞争的判断轴也会随之改变。大池仍然重要，但它更像供给基础。真正区分工程能力的，是能否根据数据任务配置存活周期、地域出口、计费方式和隔离策略，并把这些配置映射到可验证的数据质量指标上。 ## AI训练数据采集该落到青果哪类产品？ **AI训练数据采集的选型，应先判断任务是不是高频短连接，再决定是否使用短效代理。重点是让资源节奏匹配语料刷新周期。** 对国内公开文本与药品数据页面的批量更新，可落到我们青果网络的国内短效代理按量提取。1万个IP档为¥27，IP存活1分钟，单次提取上限200（来源：青果网络官网）。它适合短连接，不适合固定出口或长会话任务。 把AI语料采集放回数据基础设施视角，真正要判断的不是“代理池够不够大”，而是“每次连接能否转化为可训练数据”。节奏一旦错配，后续清洗与训练都会为它付费。 ## 常见问题 **Q1：AI语料训练为什么需要代理IP？** A：在合法的公开数据采集任务中，代理IP可用于分配请求出口、连接不同地域的数据源、平衡并发负载，并隔离不同采集任务。它不决定数据是否有权使用，也不替代站点规则、版权与个人信息判断。 **Q2：AI训练数据采集应该选短效代理还是长效代理？** A：高频、短连接、批量抓取公开文本或列表页，通常更匹配短效代理。需要连续会话、固定出口或长时间下载的任务，应评估独享代理或长效代理。判断顺序是先看任务时长与连接方式，再看代理存活周期。 **Q3：合成数据普及后，真实语料采集会减少吗？** A：低价值、重复性的采集可能减少，但高质量真实数据、时效数据和行业数据的价值会上升。合成数据可以补充稀缺样本，真实数据仍承担事实校准、分布验证与模型测评，因此验证型、增量型采集会增加。 **Q4：多模态训练对代理IP有什么不同要求？** A：文本任务更关注请求量与更新节奏，图像、音频和视频任务更关注带宽、超时、文件完整性与重传成本。多模态任务最好分队列、分并发策略、分代理池运行，避免大文件传输影响文本更新。 **Q5：怎样判断AI语料采集是否合规？** A：至少核对数据是否公开可访问、是否具有合法使用依据、是否遵守站点访问规则、是否涉及个人信息或受保护内容，以及采集目的与后续训练用途是否一致。还应保留来源、时间、许可状态与处理记录。 **Q6：代理IP池越大，训练数据质量越高吗？** A：不一定。IP池规模影响供给能力，但数据质量还取决于来源选择、内容新鲜度、去重清洗、解析完整性和许可状态。评价代理层时，应把可用率与最终训练入库率一起看，而不是只比较池规模。 **Q7：AI训练数据采集如何选青果产品？** A：在网站采集器与APP大数据分析场景中，高频短连接任务要先对齐IP更新节奏和单位有效样本成本。国内短效代理提供按量、弹性、均匀与通道等四种提取方式，具体选择仍应依据任务峰谷、存活周期和入库率，不把单一产品当作通用答案（来源：青果网络官网）。

## 1 接口简介 青果代理IP提供了功能丰富的API接口，满足开发者在各种场景下的调用需求。 所有接口支持 HTTP 或者 HTTPS 请求，部分接口采用 GET 方法，部分接口采用 POST 方法；接口返回数据的格式支持文本、json、xml。 具体请参见接口文档。 ## 2 API列表 - [短效代理](https://www.qg.net/doc/2254.html) - [独享代理](https://www.qg.net/doc/2141.html) - [长效代理](https://www.qg.net/doc/2143.html) - [短效代理（全球HTTP）](https://www.qg.net/doc/2144.html) - [长效代理（全球HTTP）](https://www.qg.net/doc/6636.html) - [独享代理（全球HTTP）](https://www.qg.net/doc/6635.html) - [隧道代理相关](https://www.qg.net/doc/1940.html) ## 3 测试代理可用性 ### 3.1 生成API链接 对于代理提取API，您可以到提取工具在线生成API链接，内置到您的程序中： [提取代理API链接生成 ＞](https://www.qg.net/tools/IPget.html "提取代理API链接生成 ＞＞") 其他接口请查看API文档，获取接口url和参数说明，自己生成API链接。 ### 3.2 测试API链接 **浏览器测试** 您可以把生成的API链接直接在浏览器里打开，查看返回结果。例如，您直接点击如下api链接 https://proxy.qg.net/query?Key=0B***607 **命令行测试** 如果您在linux系统下，可以通过curl命令请求API链接查看结果： `curl "https://proxy.qg.net/allocate?Key=请改成您的Key"` ## 4 接口返回错误码 公共接口返回错误码 | 错误码 | 描述 | | ------ | ------------------------- | | -1 | 未知错误 | | -10 | 参数不合法 | | -11 | 请求过于频繁 | | -12 | Authkey被封禁 | | -13 | 当前客户端IP不在授权名单中 | | -14 | Pwd不合法 | | -15 | Authkey对应的业务无此权限 | | -100 | 计划不存在或已过期 | | -103 | 资源不足 | | -104 | 申请资源失败 | | -105 | 释放的IP数超过允许释放的IP数 | ## 5 代码样例 查看API调用的[代码样例 ＞](https://www.qg.net/doc/172.html)

**全球HTTP均不支持在中国大陆地区网络环境下使用**。 #### 一、介绍 青果住宅池IP资源，是由来自全球200+国家地区的大量分散的真实住宅网络汇聚而成，日去重数达2000W+。 住宅IP，是由当地互联网服务提供商（ISP）分配给家庭/企业用户的IP，在IP的所属ASN信息上type类型表现为isp。 住宅池IP的特性表现为具有很高的匿名性，能够模拟真实用户行为场景，满足更高的安全代理要求，业务成功率高。  #### 二、资源池特点 相比于超级池，住宅池 - 整池为真实家庭住宅IP，更纯净 - 匿名性相对较高，业务成功率高 - 价格高些 #### 三、使用客户群 - 有大量IP使用需求的客户 - 对采集成功率要求高的客户 [开始选用【住宅池】套餐＞](https://www.qg.net/business/proxyip.html?region=overseas&product_type=1&pool_type=12&extract_mode=1&time_idx=2&change_ip=1&fee_mode_idx=0)

**全球HTTP均不支持在中国大陆地区网络环境下使用**。 #### 一、介绍 超级池，是青果独家设计搭建的高性能全球IP资源池，其IP构成是80%以上的真实家庭住宅IP，以及少部分优质的数据中心IP。 目前，超级池IP资源覆盖了全球200+个国家地区，每日活跃的高质量IP达到1000多万，拥有高质的代理服务质量，能够稳定、可靠地满足用户的各类需求。 #### 二、资源池特点 相比于住宅池，超级池拥有更高的性价比， 可以根据使用的流量计费，还提供不限流量套餐选择  [开始选用【超级池】套餐＞](https://www.qg.net/business/proxyip.html?region=overseas&product_type=1&pool_type=14&extract_mode=1)

**全球HTTP均不支持在中国大陆地区网络环境下使用**。 #### 一、介绍 青果住宅池IP资源，是由来自全球200+国家地区的大量分散的真实住宅网络汇聚而成，日去重数达2000W+。 住宅IP，是由当地互联网服务提供商（ISP）分配给家庭/企业用户的IP，在IP的所属ASN信息上type类型表现为isp。 住宅池IP的特性表现为具有很高的匿名性，能够模拟真实用户行为场景，满足更高的安全代理要求，业务成功率高。  #### 二、资源池特点 相比于超级池，住宅池 - 整池为真实家庭住宅IP，更纯净 - 匿名性相对较高，业务成功率高 - 价格高些 #### 三、使用客户群 - 有大量IP使用需求的客户 - 对采集成功率要求高的客户 [开始选用【住宅池】套餐＞](https://www.qg.net/business/proxyip.html?region=overseas&product_type=3&pool_type=12)