动态独享代理使用指南-文档中心-青果网络

## 1 步骤说明

开发者可以通过如下4个步骤使用动态独享代理

1. 在开通动态独享代理产品后，单击网站右上角的【控制台】，进入后台管理面板，在左侧栏目里选择【代理IP】-【按时/按量业务】，找到已经开通的动态独享代理业务；
   ![image-20221119161844905](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-19/161846b898eee.png)![image-20221119161801706](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-19/161850c226638.png)

2. 在业务列表选择【操作-提取IP】，或[提取工具](https://www.qg.net/tools/IPget.html?type=2-1 )或[调试工具](https://www.qg.net/tools/IPdebug.html?type=2-1)上选择对应的key提取IP，进行本地调试和验证。
   ![image-20221119162106612](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-19/162108c89d877.png)

3. 参考[代码样例](https://www.qg.net/list/192.html)请求动态独享代理。

4. 在程序中通过调用API接口获取代理，然后请求目标网站。
   1. API调用需要验证，验证方式包括密钥验证和白名单验证，根据实际使用自主选择。
   2. 密钥验证方式请求头带AuthKey和AuthPwd信息即可。
   3. 添加白名单可以免密，需要在未提取IP之前添加白名单。

## 2 API接口

| 接口类型 | 接口 |
| -------------------------- | ------------------------------------------------------------ |
| 动态独享代理 | [提取资源](https://www.qg.net/doc/1840.html) [查询资源](https://www.qg.net/doc/1841.html) [释放资源](https://www.qg.net/doc/1842.html) [替换资源](https://www.qg.net/doc/1843.html) [查询通道数](https://www.qg.net/doc/1844.html) [查询地区和运营商](https://www.qg.net/doc/1845.html) |
| 动态独享代理（启用地区锁） | [提取资源](https://www.qg.net/doc/1858.html) [查询资源](https://www.qg.net/doc/1857.html) [释放资源](https://www.qg.net/doc/1856.html) [更换资源IP](https://www.qg.net/doc/1855.html) [查询地区和运营商](https://www.qg.net/doc/1854.html) |
| 白名单相关 | [添加白名单IP](https://www.qg.net/doc/178.html) [删除白名单IP](https://www.qg.net/doc/179.html) [查询白名单IP](https://www.qg.net/doc/180.html) |

## 3 测试代理的可用性

动态独享代理支持密钥验证和白名单两种验证方式，建议先在本机测试，测试OK后就可以正常使用了。

[查看测试步骤 ＞](https://www.qg.net/doc/1574.html "查看测试步骤 ＞")

## 4 地区锁功能

地区锁指的是用户可以锁定地区IP进行切换，不会因为资源紧张而出现提取不到指定地区IP的情况。适合于需要使用固定地区家庭IP的场景。

启用地区锁后，提取速度会降低，使用方式也会改变。

1. 查看地区锁启用状态：在控制台中筛选“动态独享代理”产品，可通过地区锁字段查看当前业务是否启用地区锁功能![image-20230427115810055](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-04-27/14043884ecd2a.png)
2. 启用或者停用地区锁：在业务列表中找到需要操作的业务，查看详情![image-20230427134032050](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-04-27/1404358b97dea.png)在详情页中，找到"地区锁"字段，进行启用或停用。切换地区锁功能，将强制释放已提取IP，并且12小时后才能切换地区锁。![image-20230427134229110](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-04-27/1404520feccac.png)
3. 在控制台中使用地区锁模式：在业务列表找到已启用地区锁的业务，点击“地区锁”，进入管理页面。![image-20230427135104616](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-04-27/14045586d8ae5.png)在管理页面中，先根据购买的通道数资源，添加需要锁定的城市资源，然后在IP管理中进行切换或者移除即可。![image-20230427135310848](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2023-04-27/140457a61cd72.png)
4. 当启用地区锁之后，所调用的API接口也会发生变化，[查看详情](https://www.qg.net/doc/1858.html)

## 5 错误码一览表

| HTTP返回码 | 说明 |
| :--------- | :----------------------------------------------------------- |
| 400 | 客户端错误。客户端协议无法被识别； |
| 431 | 请求头过大。出现在http代理中，header头部信息过多导致； |
| 302 | 出现302一般有两种情况： 1.客户端IP为海外IP，服务器会重定向到预警页面 2.客户端访问的目标站被拦截，比如银行网站、邮箱、社交软件等，服务器返回重定向到预警页面 |
| 407 | 授权错误，出现407一般有两种情况： 1.白名单模式，可能是用户有多出口IP，没有全部添加到白名单；或可能连接使用IP资源，是添加白名单前获取的，白名单未对其生效 2.账密模式，可能是账密信息错误 3.共享IP产品中可能是IP已过期 |
| 408 | 目标站不可达。服务端与目标站建连失败，服务端不可达或者当前代理IP掉线 |
| 429 | 请求数超出。隧道产品中用户QPS大于购买的请求数；独享和共享产品中，用户当前的代理tcp连接超出限制数 |
| 508 | 代理目标站为代理IP地址导致死循环。一般不出现 |
| 503 | 当前代理协议不支持，比如ss代理协议 |

## 6 代理请求数据统计

代理请求数据统计包括IP请求统计、IP提取明细，提供了对请求量和请求提取、使用的统计和记录。方便随时关注采集程序的运行情况，及时发现错误并修正。

同时IP请求统计还提供几种常见的错误类型分析，如请求成功、授权失败、请求数超出、连接超时等，助力数据高效采集。
![image-20221108103607172](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-08/103608ff884e9.png)

## 7 代码样例&SDK下载

- [调用API ＞ ](https://www.qg.net/doc/1565.html "调用API ＞ ")

- [代码示例 ＞](https://www.qg.net/list/192.html "请求动态独享代理 ＞")

- [SDK下载](https://www.qg.net/doc/1745.html)

青果云

电商云

云代付

服务器租用

服务器托管

整机柜托管

动态共享

动态独享

隧道代理

静态独享

云电脑

拨号VPS

融合CDN

电商浏览器

云手机

实名认证

堡垒机

励销云搜客宝

励销云CRM

励销云SCRM

励销云电话机器人

使用指南

动态独享代理使用指南