本地ISP代理怎么用？新手配置教程与避坑指南
很多新手把"ISP代理"等同于"住宅代理的廉价替代"，选型时只看IP类型标签。实际上，ISP代理的核心价值不在IP类型本身，而在出口的长期稳定性和可控性。
搞清楚这一点，配置才不会走弯路。
## 什么是本地ISP代理？它和住宅代理到底有什么区别？
ISP代理是通过运营商（电信、联通、移动等）分配的IP，部署在数据中心但注册在运营商名下。住宅代理则是真实家庭宽带出口的IP。两者的关键差异不在"名字"，在业务适配性：
| 维度 | ISP代理（长效静态IP）（来源：青果网络官网） | 住宅代理 |
| ---------- | ------------------------------------------- | -------------------------- |
| IP来源 | 运营商分配，数据中心部署 | 真实家庭宽带出口 |
| 存活周期 | IP长期固定不变 | 随宽带拨号更新，存活不确定 |
| 带宽稳定性 | 固定带宽（1-2Mbps） | 受家庭网络波动影响 |
| 适用场景 | 需要固定出口、长会话、出口可追溯 | 需要贴近真实家庭环境 |
| 成本结构 | 按通道按月，¥49-59/月起 | 按流量计费，用量波动大 |
**判断标准**：如果你的业务需要"每次请求从同一个IP出去、且这个IP长期不变"，ISP代理（对应青果网络的长效代理静态IP）是对的选择；如果你的业务需要"IP看起来像真实家庭用户"，住宅代理才合适。两者不是替代关系，是场景互补。
## 新手第一步：长效静态IP的基础配置怎么走？
以青果网络的长效代理静态IP为例，配置分四步：
**第一步：确认业务需求**
动手之前先回答三个问题：
- 是否需要IP长期固定？（需要 → 静态IP；不需要 → 考虑动态IP或短效代理）
- 需要几个独立出口？（每个出口 = 1个通道）
- 对带宽有没有硬要求？（普通版1Mbps，高级版2Mbps，来源：青果网络官网）
**第二步：选择版本**
| 版本 | 单IP带宽 | 释放频次 | 月费（来源：青果网络官网） | 适用判断 |
| ------ | -------- | ---------------- | -------------------------- | ------------------------------ |
| 普通版 | 1Mbps | — | ¥49/通道 | 数据量不大、对带宽不敏感 |
| 高级版 | 2Mbps | 24小时起，1周2次 | ¥59/通道 | 需要更高带宽，或需要定期更换IP |
高级版比普通版贵10元/月，核心差异在带宽翻倍和可释放更换。如果业务对带宽不敏感且不需要换IP，普通版够用。
**第三步：验证方式配置**
青果网络支持两种验证：白名单验证和账密验证（来源：青果网络官网）。
- **白名单验证**：把你的服务器IP加入白名单（最多256个），请求时无需额外认证。适合服务器IP固定的场景。
- **账密验证**：每次请求带用户名密码。适合服务器IP不固定或多机器共用的场景。
新手建议先用白名单验证，配置简单，出错概率低。
**第四步：连通性测试**
配置完成后做三项验证：
1. 发一个请求，确认返回的出口IP是分配的静态IP（不是你的本机IP）
2. 间隔10分钟再发一次，确认出口IP没变
3. 跑一个小时的连续请求，统计成功率是否 ≥95%
三项都通过，基础配置完成。
## 新手最容易踩的三个坑是什么？
**坑一：把静态IP当"永远不变"**
静态IP是"长期固定"，不是"永远固定"。运营商层面的IP回收、网络调整都可能导致IP变更。高级版支持24小时起释放、1周2次更换（来源：青果网络官网），本身就是为IP需要更新的场景设计的。
业务层面的建议：关键任务不要硬绑定单一IP，而是在业务逻辑里预留IP变更的处理机制（比如检测到出口IP变化时自动重新认证）。
**坑二：通道数配少了，业务互相拖累**
一个通道 = 一个独立出口。如果征信查询和招投标数据采集共用一个通道，两个业务的请求共享同一个IP和带宽。任何一个业务的请求量突增，都会拖累另一个。
**正确做法**：不同业务用不同通道，物理隔离出口。这也是业务分池技术在长效代理上的落地逻辑：不同业务走不同的出口通道，互不干扰。
**坑三：忽略协议选择**
青果网络长效代理支持HTTP、HTTPS、SOCKS5三种协议（来源：青果网络官网）。新手常犯的错误是统一用HTTP，结果访问HTTPS站点时出现证书问题或连接失败。
**判断标准**：目标站点是HTTPS的，代理协议也用HTTPS或SOCKS5；不确定的时候用SOCKS5，兼容性最好。
## 长效静态IP适合什么场景，不适合什么场景？
适合与不适合的边界要划清楚：
| 适合 | 不适合 |
| ---------------------------------- | --------------------------------------------- |
| 征信查询：需要固定出口、请求量稳定 | 高频大量采集：IP不轮换，容易触发频次门槛 |
| 招投标数据采集：对出口一致性要求高 | 需要大量不同IP的场景：静态IP通道数有限 |
| 长会话任务：登录态保持、固定身份 | 需要贴近住宅环境的场景：ISP的IP注册在数据中心 |
| 网站可用性监测：固定出口做对照基线 | 地域频繁切换的场景：静态IP绑定固定地域 |
不适合的场景不是产品缺陷，是场景错配。高频大量采集该用短效代理，需要住宅环境该用住宅代理。
## 长效动态IP和长效静态IP怎么选？
青果网络的长效代理分动态IP和静态IP两种（来源：青果网络官网），新手容易混淆：
| 维度 | 长效动态IP | 长效静态IP |
| -------- | -------------------------- | -------------------------- |
| IP行为 | 自然失效后自动更换 | IP长期固定不变 |
| 起步价 | ¥49/月/通道 | 普通版¥49/月、高级版¥59/月 |
| 适用判断 | 需要长存活但不要求固定出口 | 需要IP长期固定、出口可追溯 |
| 附加选项 | 隧道转发¥10/通道/月 | 高级版支持定期释放更换 |
**一句话判断**：业务逻辑里有没有"这个IP必须是上次那个"的硬需求？有 → 静态；没有 → 动态够用且更灵活。
## 总结
ISP代理的选型判断不在IP类型标签，在出口稳定性和业务隔离。基于这条判断，固定出口需求落到我们青果网络的长效代理静态IP上：普通版¥49/月起、单IP带宽1Mbps、IP长期固定不变；高级版¥59/月起、单IP带宽2Mbps、支持24小时起释放（来源：青果网络官网）。本篇讲的是ISP代理在征信查询、招投标数据这类高合规场景的配置与避坑，不覆盖需要大量轮换IP的高频采集场景。那类需求该走短效代理或隧道代理，产品边界不同，选型逻辑也不同。
## 常见问题 Q&A
**Q1：ISP代理和机房代理是一回事吗？**
A：不完全是。ISP代理的IP注册在运营商（电信、联通、移动等）名下，虽然部署在数据中心，但在目标站点看来更接近运营商分配的"正常"IP。传统机房代理的IP注册在数据中心自身，部分站点对此类IP的访问门槛更高。两者的区别在IP的注册主体，不在物理位置。
**Q2：长效静态IP的带宽够用吗？**
A：取决于业务。做征信查询、招投标数据采集这类请求量不大但要求稳定的场景，1-2Mbps足够。做视频流、大文件下载等高带宽任务，静态IP不是合适的选择，该考虑独享代理（带宽峰值5Mbps，来源：青果网络官网）。
**Q3：一个通道能跑多个业务吗？**
A：技术上可以，但不建议。不同业务共用通道意味着共享IP和带宽，任一业务的请求量波动都会影响其他业务。我们青果网络在服务征信查询类客户时的实践经验是，不同业务拆到不同通道做物理隔离，是保障业务稳定性的基础配置。
**Q4：静态IP被目标站点限制了怎么办？**
A：高级版支持24小时起释放、1周2次更换IP（来源：青果网络官网）。如果业务频繁触发目标站点的频次门槛，先检查请求节奏是否合理，再考虑换IP。频繁换IP说明静态代理可能不是最优选择，该评估短效代理或隧道代理。
**Q5：长效代理支持按城市选IP吗？**
A：支持。青果网络覆盖200+城市、三大运营商节点（来源：青果网络官网）。配置时可以指定出口城市和运营商。做招投标数据采集需要特定区域出口的，直接在配置里指定即可。
**Q6：新手应该先买普通版还是高级版？**
A：先问自己两个问题：业务对带宽的最低要求是多少？是否需要定期更换IP？两个都不需要，普通版¥49/月起（来源：青果网络官网）够用；任一需要，高级版¥59/月起更合适。差价10元/月，不用纠结，按需选。
IP代理HTTPS支持度怎么验证？目标网站兼容性测试详解
本篇讲的是代理IP在HTTPS场景下的兼容性验证方法。我们青果网络长期服务网站采集器、广告监测这类对HTTPS请求完整性要求极高的企业级采集业务，在实际项目里反复看到一个现象：技术团队以为买了支持HTTPS的代理就万事大吉，上线后才发现目标站点的TLS版本要求、证书校验逻辑、SNI检测各不相同，代理端"支持HTTPS"和"在这个站点上跑得通"是两件事。下文按验证层级逐项展开。
## 协议列表写了HTTPS就够了吗？
不够。大多数技术团队在选型阶段只看代理服务商的协议列表，看到写着"支持HTTP、HTTPS、SOCKS5"就认为HTTPS兼容性没问题。这个判断在实际业务里经常翻车。
翻车的根因在于：HTTPS不是一个单一能力，而是一组协议层行为的组合。代理服务商说的"支持HTTPS"，通常指代理端能处理CONNECT方法建立隧道，客户端与目标站点之间的TLS握手通过隧道透传。但"能建隧道"和"隧道里的TLS握手在目标站点上能完整通过"之间，隔着好几层细节：
| 层级 | 具体行为 | 常见翻车点 |
| --------------- | ----------------------------------------- | ------------------------------------------------------------ |
| CONNECT隧道建立 | 代理端接受CONNECT请求，建立TCP隧道 | 部分代理对非443端口的CONNECT请求直接拒绝 |
| TLS版本协商 | 客户端与目标站点协商TLS版本 | 代理中间件降级TLS1.3到TLS1.2，目标站点要求TLS1.3最低版本时握手失败 |
| SNI传递 | ClientHello中的Server Name Indication字段 | 代理转发时丢失或篡改SNI，目标站点返回错误证书或直接拒绝连接 |
| 证书链校验 | 客户端校验目标站点的完整证书链 | 代理做中间人解密(MITM)时替换证书，客户端校验不通过 |
| HTTP/2协商 | ALPN扩展协商HTTP/2 | 代理只支持HTTP/1.1转发，目标站点强制HTTP/2时降级或报错 |
这五层中任何一层出问题，采集任务的表现就不是"慢一点"，而是直接拿不到数据。所以验证HTTPS支持度，本质上是逐层确认这五个行为在你的目标站点上都能正常完成。
## HTTPS兼容性要验证哪几层？
把上面的五层翻译成可执行的验证项，按优先级排列：
**第一层：CONNECT隧道可达性**
这是最基础的一层。发一个CONNECT请求到目标站点的443端口，看代理是否返回`200 Connection Established`。如果这一步就失败，后面的验证都不用做。
验证命令示例：
```bash
curl -x http：//代理地址：端口 -v https：//目标站点 2>&1 | grep "CONNECT"
```
观察输出中是否包含`HTTP/1.1 200 Connection established`，有则通过。
**第二层：TLS版本兼容**
目标站点要求的最低TLS版本与代理实际透传的TLS版本是否匹配。当前主流站点已全面要求TLS1.2起，部分站点要求TLS1.3。
验证方法：通过代理向目标站点发起请求，强制指定TLS版本，观察握手是否成功：
```bash
curl -x http：//代理地址：端口 --tls-max 1.2 -v https：//目标站点
curl -x http：//代理地址：端口 --tls-max 1.3 -v https：//目标站点
```
对比两次结果：如果TLS1.3成功而TLS1.2失败，说明目标站点要求TLS1.3最低版本；反之则说明代理端存在TLS版本降级行为。
**第三层：SNI传递完整性**
SNI是TLS握手中ClientHello消息里的关键字段，告诉目标服务器客户端要访问的域名。如果代理在转发过程中丢失或修改了SNI，目标站点会返回错误证书或直接断开连接。
验证方法：
```bash
openssl s_client -connect 代理地址：端口 -servername 目标域名 -proxy 代理地址：端口
```
检查返回的证书CN(Common Name)或SAN(Subject Alternative Name)是否与目标域名匹配。不匹配则说明SNI传递有问题。
**第四层：证书链完整性**
确认通过代理获取的证书链与直连目标站点获取的证书链一致。如果代理做了中间人解密，证书链会被替换，客户端拿到的是代理自签证书。
验证方法：分别直连和通过代理获取证书指纹，做对比：
```bash
# 直连
echo | openssl s_client -connect 目标站点：443 2>/dev/null | openssl x509 -fingerprint -noout
# 通过代理
echo | openssl s_client -connect 目标站点：443 -proxy 代理地址：端口 2>/dev/null | openssl x509 -fingerprint -noout
```
两次指纹一致，说明代理没有做证书替换，HTTPS隧道是真正的端到端加密透传。
**第五层：HTTP/2与ALPN协商**
部分目标站点强制要求HTTP/2，通过ALPN扩展在TLS握手阶段协商。如果代理不支持ALPN透传，连接会降级到HTTP/1.1，目标站点可能返回不同的内容结构或直接拒绝。
```bash
curl -x http：//代理地址：端口 --http2 -v https：//目标站点 2>&1 | grep "ALPN"
```
观察是否成功协商到h2协议。
## 具体怎么跑一遍完整的兼容性测试？
上面五层是单项验证，实际操作中建议按以下流程一次性跑完，形成一份可复用的兼容性测试报告。
**步骤1：列出目标站点清单**
把业务涉及的所有目标站点整理成清单。不同站点的TLS配置差异很大，不能用一个站点的结果代表全部。建议按采集频次从高到低排序，优先验证高频目标。
**步骤2：准备测试环境**
| 准备项 | 说明 |
| -------- | ------------------------------------------------------------ |
| 测试机器 | 与生产环境同一网络出口，避免网络环境差异导致误判 |
| 代理配置 | 分别准备HTTP代理和SOCKS5代理的接入方式，对比两种协议的HTTPS兼容表现 |
| 工具 | curl(≥7.68，支持--tls-max)、openssl(≥1.1.1)、Python requests库(验证代码级兼容) |
| 对照组 | 每个站点先直连一次，记录基准数据(TLS版本、证书指纹、HTTP协议版本、响应状态码) |
**步骤3：逐站点跑五层验证**
把五层验证写成脚本批量执行。核心输出四列：
| 检查项 | 直连结果 | 代理结果 | 是否一致 |
| ----------- | --------------- | -------------------------- | -------- |
| CONNECT响应 | — | 200 Connection Established | ✓/✗ |
| TLS版本 | TLS1.3 | TLS1.3 | ✓/✗ |
| SNI传递 | example.com | example.com | ✓/✗ |
| 证书指纹 | SHA256：ABCD... | SHA256：ABCD... | ✓/✗ |
| HTTP/2 | h2 | h2 | ✓/✗ |
五项全部一致，该站点的HTTPS兼容性验证通过；任一项不一致，需要定位原因。
**步骤4：记录异常项并归因**
对不一致的项，按下一节的排查逻辑定位是代理侧问题还是目标站点侧问题。
**步骤5：换代理产品复测**
如果当前代理产品在某些站点上兼容性不过关，换一种代理产品类型复测。不同代理产品的转发机制不同，兼容性表现也不同。以青果网络的产品为例：隧道代理通过CONNECT方法建立TCP隧道，TLS握手在隧道内端到端完成，代理不参与解密；短效代理的HTTP模式则可能在某些场景下需要额外配置才能确保HTTPS透传。代理协议全线支持HTTP、HTTPS、SOCKS5(来源：青果网络官网)，但不同产品类型的HTTPS处理机制有差异，验证时需要分别跑。
## 目标网站返回异常，怎么定位是代理问题还是站点问题？
兼容性测试中最常见的困惑是：通过代理访问目标站点返回异常(证书错误、连接超时、403状态码)，不确定问题出在代理还是目标站点。以下是排查路径：
**判断1：直连是否正常？**
先不走代理，直连目标站点。如果直连也异常，问题在目标站点或本地网络，与代理无关。
**判断2：换IP后是否恢复？**
通过代理访问异常时，换一个出口IP再试。如果换IP后恢复正常，说明之前的出口IP触发了目标站点的访问频次控制，不是HTTPS协议层问题。日更600万+纯净IP(来源：青果网络官网)，IP轮换后仍然异常的，大概率是协议层兼容性问题。
**判断3：SOCKS5与HTTP代理对比**
同一个目标站点，分别用HTTP代理模式和SOCKS5代理模式访问。SOCKS5工作在更底层，不解析应用层协议，TLS握手的透传更完整。如果SOCKS5正常而HTTP代理异常，问题定位到HTTP代理的CONNECT实现或Header处理逻辑上。
**判断4：抓包对比握手过程**
用tcpdump或Wireshark在代理出口侧抓包，对比直连和代理两种路径下的TLS握手过程：
| 对比项 | 直连 | 代理 | 问题信号 |
| -------------------- | -------- | -------- | ------------------ |
| ClientHello中的SNI | 有 | 缺失 | 代理丢弃SNI |
| ServerHello的TLS版本 | 1.3 | 1.2 | 代理降级TLS |
| 证书主体 | 目标站点 | 代理自签 | 代理做MITM |
| ALPN协商结果 | h2 | 无 | 代理不支持ALPN透传 |
抓包是最终定位手段。大多数兼容性问题在抓包对比后都能明确归因。
**常见异常与对策速查**：
| 异常表现 | 大概率原因 | 处理方向 |
| ---------------------------------- | ---------------------------------- | --------------------------- |
| SSL： CERTIFICATE_VERIFY_FAILED | 代理替换了证书(MITM)或证书链不完整 | 换用CONNECT隧道模式或SOCKS5 |
| 连接超时(无TLS握手) | CONNECT请求被代理拒绝 | 确认代理端口是否支持CONNECT |
| 403 Forbidden | 出口IP触发目标站点频次控制 | 换IP或降低请求频率 |
| ERR_SSL_VERSION_OR_CIPHER_MISMATCH | TLS版本不兼容 | 确认代理是否降级了TLS版本 |
| 返回内容与直连不同 | HTTP/2降级到HTTP/1.1 | 确认代理是否支持ALPN透传 |
## 不同代理协议模式下，HTTPS兼容性有什么差异？
验证HTTPS兼容性时，代理的接入协议(HTTP代理、HTTPS代理、SOCKS5代理)对兼容性表现有直接影响。理解这个差异，能帮你在验证结果不理想时快速切换到更合适的协议模式。
| 协议模式 | HTTPS处理机制 | TLS握手位置 | SNI保留 | 证书链完整 | 适用场景 |
| ----------------- | -------------------------------------- | --------------------------------------- | ------- | -------------- | --------------------------------- |
| HTTP代理(CONNECT) | 代理建立TCP隧道，TLS在隧道内端到端完成 | 客户端↔目标站点 | 是 | 是(代理不解密) | 绝大多数HTTPS采集场景 |
| HTTPS代理 | 客户端与代理之间也走TLS，双层加密 | 客户端↔代理(外层)+客户端↔目标站点(内层) | 是 | 是 | 对传输链路安全性要求高的场景 |
| SOCKS5代理 | 纯TCP转发，不解析应用层 | 客户端↔目标站点 | 是 | 是 | HTTP代理CONNECT兼容性不佳时的备选 |
三种模式都能透传TLS握手，但工程细节上有差异：HTTP代理的CONNECT方法是最常用的方式，兼容性最广；SOCKS5在底层转发，不碰应用层协议，对SNI和证书链的干扰最小；HTTPS代理增加了客户端到代理之间的加密，安全性更高但配置复杂度也更高。
青果网络全线产品支持HTTP、HTTPS、SOCKS5三种协议(来源：青果网络官网)，验证时建议三种都跑一遍，记录每种协议在各目标站点上的兼容性表现，最终选兼容性最好的那种作为生产环境的接入方式。
## 验证完HTTPS兼容性，该选哪款代理IP？
回到本篇核心判断：HTTPS支持度不是看协议列表，是在目标站点上逐层验证TLS握手、SNI传递、证书链完整性的实际兼容表现。
基于这条判断，验证通过后的选型落到具体产品：做网站采集器、广告监测这类需要高频轮换出口IP的HTTPS采集，我们青果网络的隧道代理是更直接的选择，每次请求自动换IP，基础包5个请求数对应5Mbps带宽(来源：青果网络官网)，CONNECT隧道透传TLS握手，代理端不参与解密；做批量站点兼容性测试或大规模IP轮换验证，短效代理按量计费0.00216元/IP起(来源：青果网络官网)，日更600万+纯净IP(来源：青果网络官网)，能在短时间内覆盖足够多的出口IP样本。验证阶段可以用免费测试在自己的目标站点清单上跑一轮五层检查，拿到兼容性基线数据再做生产环境的产品选择，比只看协议列表选型可靠得多。
## 常见问题
**Q1：代理IP的HTTPS支持和HTTP支持有什么本质区别？**
A：HTTP请求是明文传输，代理可以直接转发；HTTPS请求是加密传输，代理需要通过CONNECT方法建立TCP隧道，让客户端与目标站点在隧道内完成TLS握手。本质区别在于代理是否参与解密：好的HTTPS代理不解密流量，只做隧道透传；做了中间人解密的代理会替换证书链，导致客户端校验失败或数据安全风险。
**Q2：怎么判断代理是否做了中间人解密(MITM)？**
A：最直接的方法是对比证书指纹。分别通过直连和代理访问同一个HTTPS站点，用openssl获取证书指纹。两次指纹一致，代理没有做MITM；指纹不一致，说明代理替换了证书，流量在代理端被解密过。这种情况下建议切换到SOCKS5模式或更换代理产品。
**Q3：SOCKS5代理的HTTPS兼容性一定比HTTP代理好吗？**
A：不一定"好"，但干扰更少。SOCKS5工作在传输层，不解析应用层协议，所以对TLS握手、SNI、证书链的透传更完整。但SOCKS5的缺点是不支持HTTP层面的Header控制，某些需要自定义请求头的采集场景反而不如HTTP代理灵活。建议两种都测，选兼容性和功能性都满足的那种。
**Q4：验证HTTPS兼容性需要多少个IP样本才有统计意义？**
A：单个IP的验证结果只能说明"这个出口IP在这个站点上兼容"，不能代表整个IP池的表现。建议至少用50个不同出口IP对同一个目标站点跑五层验证，统计通过率。通过率在95%以上的，可以认为该代理产品对该站点的HTTPS兼容性合格。我们青果网络在企业级服务实践中观察到，把验证样本量控制在50-100个IP区间，既能保证统计可信度，又不浪费测试资源(来源：青果实践观测，验证样本量建议，基于网站采集器场景的企业级客户服务经验)。
**Q5：目标站点更新了TLS配置，之前验证通过的代理会不会突然不兼容？**
A：会。目标站点的TLS配置不是静态的，升级TLS最低版本、更换证书、启用新的加密套件都可能导致之前兼容的代理突然不通。建议每月对高频目标站点做一轮复测，把五层验证脚本加入定时任务自动执行，异常时告警。
**Q6：用Python的requests库通过代理访问HTTPS站点报SSL错误，一定是代理问题吗？**
A：不一定。Python的requests库默认使用certifi包内置的CA证书库校验证书链。如果代理做了MITM替换了证书，requests会报SSL错误；但如果是certifi版本过旧、缺少目标站点的根证书，直连也会报同样的错误。排查时先不走代理直连测一次，再走代理测一次，对比结果定位。
长效代理-产品介绍
## 1 产品简介
长效代理是以高性能云主机为主，一手散段IP资源为辅建设的高品质代理服务器，青果除了为客户提供可以长期持有的静态IP之外，还有多种存活时长(1天以上)、可动态切换的长效IP资源。
【静态类型】：普惠版与高级版，普惠版的IP是长期不变的，独享带宽高稳定性。而高级版特别提供了自主更换IP的功能，一周可自主更换**2**次。
【动态类型】：IP存活时长为数小时到数天范围内自然失效，有低带宽和高带宽套餐可选。API提取模式下，需手动提取IP；也可选择打开隧道转发功能，那么IP失效之后将自动连接新IP。
长效代理使用非常方便，只需几分钟，您就可以通过[API链接](https://www.qg.net/tools/IPget.html?type=1-1)获取代理IP并参照[代码样例](https://www.qg.net/list/192.html)集成到您的程序中。
## 2 产品优势
- IP时长可控，自主释放，可用时长从24小时到365天全覆盖，满足多场景需求；
- 真实IP地址，IP稳定性强；
- 提供丰富的API接口，调用方便快捷。
- IP真实，全年7x24小时稳定可用
- 静态类型独享带宽和IP，稳定性强
- 极速（访问百度测试，响应时间<1秒）
- 支持指定获取某个城市IP或全国随机
## 3 适合人群
适用于需要业务环境隔离或长期固定IP的业务场景。
## 4 付费模式
静态产品提供普通版和高级版两种套餐，对应不同价格
- 普惠版产品IP长期不变，
- 高级版可根据需求，一周内可自主更换两次。
皆为按时计费 模式，可按周、按月、按年付费。
动态产品提供不同带宽的两个套餐，对应不同价格。
## 5 产品属性
- 免费白名单数量：256
- 支持协议：HTTP/HTTPS/SOCKS5
- 单IP最大连接数：1000
- 单IP带宽限制：静态普惠版1Mbps，静态高级版2Mbps。动态有2M和5M选择。
- 终端数限制：无限制
- 提取资源频率： (通道数*5+10 ) 次/分钟
- 单次提取IP上限：100个
## 6 用途
**长效代理可用于：**
- 跨境电商店铺运营
- 观看视频
- 舆情监测
- 广告检测
- 直播/短视频数据监控分析
**不适用于以下场景**
- 访问谷歌等国内正常无法访问的网站；
- 大文档、音乐、视频等大文件下载；
- 登录和访问色情、赌博等不健康的网站；
- 用于网络攻击等违法行为。
## 7 使用指南
长效代理使用非常方便，您可以选择①**手动设置**代理IP并在浏览器中使用，
也可以通过②**API接口获取**代理并参照代码样例集成到您的程序中。
具体请查看
- [手动设置代理指南 ＞](https://www.qg.net/doc/product/6_258_281/2268.html)
- [开发者使用代理指南 ＞](https://www.qg.net/doc/product/6_258_281/1795.html)
##8 产品购买
- [短效代理 ＞](https://www.qg.net/business/proxyip/2.html?region=domestic&product_type=1&pool_type=2&extract_mode=4&spec_idx=0&num_idx=0&time_idx=3&number=1000&authkey_type=0 )
- [隧道代理 ＞](https://www.qg.net/business/proxyip/42.html?region=domestic&product_type=3&pool_type=1&extract_mode=1&spec_idx=0&num_idx=0&time_idx=3&number=5&authkey_type=0 )
- [独享代理 ＞](https://www.qg.net/business/proxyip/6.html?region=domestic&product_type=2&pool_type=1&extract_mode=1&spec_idx=0&num_idx=0&time_idx=2&number=1&authkey_type=0)
- [长效代理 ＞](https://www.qg.net/business/proxyip/6.html?region=domestic&product_type=4&pool_type=1&extract_mode=1&spec_idx=0&num_idx=0&time_idx=2&number=1&authkey_type=0 )
全球-长效代理-API接口介绍
## 1 说明
通过编码使用长效代理（全球HTTP）-通道提取主要有以下4步骤：
1.先在[提取工具](https://www.qg.net/tools/IPget.html)或[调试工具](https://www.qg.net/tools/IPdebug.html)上获取api接口；
2.使用白名单或账密进行授权验证；
3.进行代理测试；[查看测试步骤＞＞](https://www.qg.net/doc/1574.html "查看测试步骤")
4.参考[代码样例](https://www.qg.net/list/192.html)编写采集程序，使用代理IP。
## 2 API接口
长效代理（全球HTTP）-通道提取API接口一览
| 接口类型 | API | 描述 |
| ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 资源相关 | - [get](https://www.qg.net/doc/6637.html)
- [query](https://www.qg.net/doc/6638.html)
- [channels](https://www.qg.net/doc/6639.html)
| - 提取IP资源
- 查询在用IP资源
- 查询通道数
|
| 白名单相关 | - [whitelist/query](https://www.qg.net/doc/180.html "whitelist/query")
- [whitelist/add](https://www.qg.net/doc/178.html "whitelist/add")
- [whitelist/del](https://www.qg.net/doc/179.html "删除白名单")
| - 查询IP的白名单
- 添加IP的白名单
- 删除IP的白名单 |
全球-长效代理-查询通道数
## 1. 接口描述
接口请求域名： overseas.proxy.qg.net。
本接口 (/channels) 用于全球-长效代理产品查询通道数的接口。
默认接口请求频率限制：60次/分钟。
推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html?type=2-2)。
## 2. 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
| -------- | ---- | ------ | ------------------------ |
| key | 是 | String | 公共参数，产品唯一标识。 |
## 3. 输出参数
| 参数名称 | 类型 | 描述 |
| ---------- | ------- | ------------------------------------------------------------ |
| code | String | 请求状态码。 |
| data.toal | Integer | key的通道总数。 |
| data.idle | Integer | 空闲通道数。 |
| request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 |
## 4. 示例
#### 输入示例
```
GET https://overseas.proxy.qg.net/channels?key=<您的key信息>
```
#### 输出示例
```json
{
"code": "SUCCESS",
"data": {
"total": 10,
"idle": 5
},
"request_id": "83158ebe-be6c-40f7-a158-688741083edc"
}
```
## 5. 错误码
| 错误码 | 描述 |
| ---------------------- | ------------------------------------------------------------ |
| INTERNAL_ERROR | 系统内部异常。 |
| INVALID_PARAMETER | 参数错误（包含参数格式、类型等错误）。 |
| INVALID_KEY | Key不存在或已过期。 |
| UNAVAILABLE_KEY | Key不可用，已过期或被封禁 |
| ACCESS_DENY | Key没有此接口的权限。 |
| API_AUTH_DENY | Api授权不通过，请检查[Api鉴权配置](https://www.qg.net/user/proxyIpManage)。 |
| KEY_BLOCK | Key被封禁。 |
| REQUEST_LIMIT_EXCEEDED | 请求频率超出限制。 |
全球-长效代理-查询在用IP资源
## 1. 接口描述
接口请求域名： overseas.proxy.qg.net。
本接口 (/query) 用于全球-长效代理产品查询在用的IP资源的接口。
默认接口请求频率限制：60次/分钟。
推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html?type=5-2)。
## 2. 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
| -------- | ---- | ------ | ------------------------ |
| key | 是 | String | 公共参数，产品唯一标识。 |
## 3. 输出参数
| 参数名称 | 类型 | 描述 |
| ---------- | ----------------------------------------------- | ------------------------------------------------------------ |
| code | String | 请求状态码。 |
| data | Array of [IP](https://www.qg.net/doc/1839.html) | IP资源列表。
**注：IP结构中的server才是代理地址，proxy_ip是代理的真实出口IP。** |
| request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 |
## 4. 示例
#### 输入示例
```
GET https://overseas.proxy.qg.net/query?key=<您的key信息>&<其他输入参数>
```
#### 输出示例
```json
{
"code": "SUCCESS",
"data": [{
"proxy_ip": "129.150.42.240",
"server": "129.150.42.240:18080",
"area": "新加坡",
"deadline": "2023-02-25 15:38:36"
}],
"request_id": "83158ebe-be6c-40f7-a158-688741083edc"
}
```
## 5. 错误码
| 错误码 | 描述 |
| ---------------------- | ------------------------------------------------------------ |
| INTERNAL_ERROR | 系统内部异常。 |
| INVALID_PARAMETER | 参数错误（包含参数格式、类型等错误）。 |
| INVALID_KEY | Key不存在或已过期。 |
| UNAVAILABLE_KEY | Key不可用，已过期或被封禁 |
| ACCESS_DENY | Key没有此接口的权限。 |
| API_AUTH_DENY | Api授权不通过，请检查[Api鉴权配置](https://www.qg.net/user/proxyIpManage)。 |
| KEY_BLOCK | Key被封禁。 |
| REQUEST_LIMIT_EXCEEDED | 请求频率超出限制。 |
全球-长效代理-提取IP资源
## 1. 接口描述
接口请求域名： overseas.proxy.qg.net。
本接口 (/get) 用于全球-长效代理产品提取IP的接口。
默认接口请求频率限制：（通道数*5+10）次/分钟。
推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html?type=5-2)。
需注意，如使用白名单IP，请在提取前添加白名单。
## 2. 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
| -------- | ---- | ------- | ------------------------------------------------------------ |
| key | 是 | String | 公共参数，产品唯一标识。 |
| area | 否 | String | 国家筛选。支持国家编码和自定义编码，比如：US,EU，或者990100,990200。[国家编码](https://www.qg.net/doc/use/8_234_201/1975.html) |
| area_ex | 否 | String | 排除某些地区提取。使用方式同上 |
| num | 否 | Integer | 提取个数，默认为1 |
## 3. 输出参数
| 参数名称 | 类型 | 描述 |
| ---------- | ----------------------------------------------- | ------------------------------------------------------------ |
| code | String | 请求状态码。 |
| data | Array of [IP](https://www.qg.net/doc/1839.html) | IP资源列表。
**注：IP结构中的server才是代理地址，proxy_ip是代理的真实出口IP。** |
| request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 |
## 4. 示例
#### 输入示例
```
GET https://overseas.proxy.qg.net/get?key=<您的key信息>&<其他输入参数>
```
#### 输出示例
```json
{
"code": "SUCCESS",
"data": [{
"proxy_ip": "129.150.42.240",
"server": "129.150.42.240:18080",
"area": "新加坡",
"deadline": "2023-02-25 15:38:36"
}],
"request_id": "83158ebe-be6c-40f7-a158-688741083edc"
}
```
## 5. 错误码
| 错误码 | 描述 |
| ---------------------- | ------------------------------------------------------------ |
| INTERNAL_ERROR | 系统内部异常。 |
| INVALID_PARAMETER | 参数错误（包含参数格式、类型等错误）。 |
| INVALID_KEY | Key不存在或已过期。 |
| UNAVAILABLE_KEY | Key不可用，已过期或被封禁 |
| ACCESS_DENY | Key没有此接口的权限。 |
| API_AUTH_DENY | Api授权不通过，请检查[Api鉴权配置](https://www.qg.net/user/proxyipResource)。 |
| KEY_BLOCK | Key被封禁。 |
| REQUEST_LIMIT_EXCEEDED | 请求频率超出限制。 |
| BALANCE_INSUFFICIENT | Key余额不足。 |
| NO_RESOURCE_FOUND | 资源不足。 |
| FAILED_OPERATION | 提取失败。 |
| EXTRACT_LIMIT_EXCEEDED | 超出提取配额。 |
全球-独享代理（地区锁）-API接口介绍
## 1 说明
通过编码使用全球-独享代理（地区锁独占）主要有以下4步骤：
1.先在[提取工具](https://www.qg.net/tools/IPget.html)或[调试工具](https://www.qg.net/tools/IPdebug.html)上获取api接口；
2.使用白名单或账密进行授权验证；
3.进行代理测试；[查看测试步骤＞＞](https://www.qg.net/doc/1574.html "查看测试步骤")
4.参考[代码样例](https://www.qg.net/list/192.html)编写采集程序，使用代理IP。
## 2 API接口
全球-独享代理（地区锁独占）-按量提取API接口一览
| 接口类型 | API | 描述 |
| ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 资源相关 | - [monopolize](https://www.qg.net/doc/6630.html)
- [query_monopolize](https://www.qg.net/doc/6631.html)
- [channels](https://www.qg.net/doc/6632.html)
- [changeip](https://www.qg.net/doc/6633.html)
- [delete_monopolize](https://www.qg.net/doc/6634.html)
| - 提取资源
- 查询在用资源
- 查询通道
- 更换IP
- 释放资源
|
| 白名单相关 | - [whitelist/query](https://www.qg.net/doc/180.html "whitelist/query")
- [whitelist/add](https://www.qg.net/doc/178.html "whitelist/add")
- [whitelist/del](https://www.qg.net/doc/179.html "删除白名单")
| - 查询IP的白名单
- 添加IP的白名单
- 删除IP的白名单 |
全球-独享代理（地区锁）-释放资源
## 海外独占-释放资源
`https://overseas.proxy.qg.net/delete_monopolize`
### 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
| -------- | ---- | ------ | ------------------------ |
| key | 是 | String | 公共参数，产品唯一标识。 |
| uuid | 是 | String | 释放指定的独占资源。 |
### 输出参数
| 参数名称 | 类型 | 描述 |
| ---------- | --------------- | ------------------------------------------------------------ |
| code | String | 请求状态码。 |
| data | Array of String | 释放成功的独占资源UUID列表。 |
| request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 |
### 输入示例
```
GET https://overseas.proxy.qg.net/delete_monopolize?key=<您的key信息>&<其他输入参数>
```
### 输出示例
```json
{
"code": "SUCCESS",
"data": [
"jike-hk:ppp497"
],
"request_id": "df747ce4-2e60-4c3d-bade-05535f5dadee"
}
```
全球-独享代理（地区锁）-更换IP
## 海外独占-更换IP
`https://overseas.proxy.qg.net/changeip`
### 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
| -------- | ---- | ------ | --------------------------------------------------- |
| key | 是 | String | 公共参数，产品唯一标识。 |
| uuid | 是 | String | 需要更换IP的独占资源uuid。 更换指定的独占资源的IP。 |
### 输出参数
| 参数名称 | 类型 | 描述 |
| ---------- | --------------- | ------------------------------------------------------------ |
| code | String | 请求状态码。 |
| data | Array of String | 更换成功的独占资源UUID列表。 |
| request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 |
### 输入示例
```
GET https://overseas.proxy.qg.net/changeip?key=<您的key信息>&<其他输入参数>
```
### 输出示例
```json
{
"code": "SUCCESS",
"data": [
"jike-hk:ppp497"
],
"request_id": "61af19f0-e906-4654-9c08-ab86ed0a0ba3"
}
```
---
