文档中心

## 步骤总览  **注：若使用白名单验证模式，请先添加白名单再进行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](https://www.qg.net/doc/179.html)
[查询白名单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接口及代码示例，以协助开发者更便利地使用代理。 本篇仅以【提取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信息填入代理服务器中进行使用。

## 步骤总览  ------------ 完成购买后，即可在控制台看到相关业务信息。 后续使用代理，最重要的便是密钥信息（隧道代理使用的是地址信息）。  下面介绍手动设置 使用代理的具体步骤。 ## 一、授权验证 为保障用户使用代理的权益和安全性， 正式使用前需要进行授权验证。 青果支持白名单和帐密两种验证方式，可自主选择使用。 白名单模式，即把要实现代理的服务器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或者直接更换。

**全球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)

## 1 产品简介 独享代理（全球HTTP）为您提供真实的海外家庭住宅IP资源，由您独享带宽与IP，不与其他用户共用，从源头保障IP纯净度与业务成功率。提供全球海量住宅资源节点，可自由选定IP地区，支持多机器或多进程使用代理IP。广泛适用于对账号稳定性和地域精准度要求较高的各类业务场景。 - **地区锁定**：指定地区后，切换到的IP均来自同一地区，确保业务全程的地域一致性 - **时长灵活**：单IP存活时长最长可达1天，期间可自主切换IP，灵活掌控使用节奏 独享代理使用非常方便，只需几分钟，您就可以通过[API链接](https://www.qg.net/tools/IPget.html?type=2-1)获取代理IP并参照[代码样例](https://www.qg.net/list/192.html)集成到您的程序中。 ## 2 产品优势 - IP存活时长≤24H，IP存活30秒后可释放申请新的IP，可根据需求，自主切换IP； - 独享带宽和IP，能有效的保证IP的纯净度和业务的成功率； - 5Mbps带宽，高速、不限流量； - 提供代理请求统计，包括请求频率、请求错误类型等，帮助自主排查，提升程序运行的成功率； - 提供IP提取监控，精准回溯每一次的提取记录； - 极速（访问百度测试，响应时间<1秒） - 支持多台设备或多个进程同时进行 - 覆盖全球200+国家地区 - 支持指定获取某个城市IP ## 3 适合人群 独享代理适用于对IP质量要求较高或对带宽要求较高的业务场景。 ## 4 计费模式 目前仅支持按时计费模式，包括按周、按月、按年三种按时付费模式 ## 5 产品属性 - 免费白名单数量：256 - 支持协议：HTTP/HTTPS/SOCKS5 - 单IP最大连接数：1000 - 带宽峰值：5Mbps - 终端数限制：无限制 - 提取资源频率： (通道数*5+10 ) 次/分钟 - 单次提取IP上限：100个 ## 6 用途 **独享代理可用于：** - 广告检测 - 征信查询 - 直播/短视频数据监控分析 - SEO检测 **不适用于以下场景** - 大文档、音乐、视频等大文件下载； - 登录和访问色情、赌博等不健康的网站； - 用于网络攻击等违法行为。 ## 7 使用指南 独享代理使用非常方便，您可以选择①**手动设置**代理IP并在浏览器中使用， 也可以通过②**API接口获取**代理并参照代码样例集成到您的程序中。 具体请查看 - [手动设置代理指南 ＞](https://www.qg.net/doc/6674.html) - [开发者使用代理指南 ＞](https://www.qg.net/doc/6675.html) ##8 产品购买 - [隧道代理（全球HTTP）＞](https://www.qg.net/business/proxyip.html?region=overseas&product_type=3&pool_type=14 ) - [短效代理（全球HTTP） ＞](https://www.qg.net/business/proxyip.html?region=overseas&product_type=1&pool_type=14&extract_mode=1 ) - [长效代理（全球HTTP） ＞](https://www.qg.net/business/proxyip.html?region=overseas&product_type=4&pool_type=14&number=1) - [独享代理（全球HTTP） ＞](https://www.qg.net/business/proxyip.html?region=overseas&product_type=2&pool_type=14&number=1)

## 1 产品简介 **全球HTTP均不支持在中国大陆地区网络环境下使用** 长效代理（全球HTTP）由海外家庭用户闲置或共享的带宽IP资源进行深度优化，构建了覆盖全球、规模达十万级的专属定制代理池。池内IP单次可用时长长达4小时至1天，在线时间更久，尤其适合需要长时间维持同一身份的持续会话场景；能够帮助您在广告监播、社媒运营等场景中顺利推进业务、达成目标。 - **超长时效**：单IP可用时长最高达24小时，满足长时间会话需求 - **IP质量优质**：真实住宅IP，纯净度高，业务成功率高 长效代理使用非常方便，只需几分钟，您就可以通过[API链接](https://www.qg.net/tools/IPget.html?type=1-1)获取代理IP并参照[代码样例](https://www.qg.net/list/192.html)集成到您的程序中。 ## 2 产品优势 - IP存活数小时-一天之间； - IP到期自然失效，更接近真人网络行为模式； - 真实住宅IP地址，IP纯净高可用； - 提供丰富的API接口，调用方便快捷； - IP真实，全年7x24小时稳定可用； - 极速（访问百度测试，响应时间<1秒）； - 支持指定获取国家地区IP或全球随机。 - 提供代理请求统计，包括请求频率、请求错误类型等，帮助自主排查，提升程序运行的成功率； - 提供IP提取监控，精准回溯每一次的提取记录； ## 3 适合人群 适用于需要高真实IP环境或长时长稳定会话的业务场景。 ## 4 付费模式 长效代理（全球HTTP）按通道数计费，每个通道在某个时刻可以使用一个IP。当这个IP的存活时长结束之后，通道可以提取一个新的IP来替代。 当前定价为59元/通道/月。年付享有折扣，具体请以购买页为准。 ## 5 IP提取使用 相应的，长效代理的IP采取通道提取方式，用户可通过[提取工具](https://www.qg.net/tools/IPget.html)手动提取，也可使用[API接口](https://www.qg.net/doc/6636.html)提取。由于长效住宅IP的特性，同一通道内，用户需要在原IP自然失效之后，才可提取新IP。 *本产品当前已默认开启了隧道转发功能----可在IP失效释放后，将会自动连接新IP，省去重新提取IP的步骤，用户可根据需求选择是否开启该功能。 ## 6 产品属性 - 免费白名单数量：256 - 支持协议：HTTP/HTTPS/SOCKS5 - 单IP最大连接数：1000 - 单IP带宽限制：2Mbps - 终端数限制：无限制 - 提取资源频率： (通道数*5+10 ) 次/分钟 - 单次提取IP上限：100个 ## 7 用途 **长效代理（全球HTTP）可用于：** - 广告检测 - 舆情监测 - 社媒运营 - 隐私保护 - 海外数据采集 **不适用于以下场景** - 大文档、音乐、视频等大文件下载； - 登录和访问色情、赌博等不健康的网站； - 用于网络攻击等违法行为。 ## 8 使用指南 长效代理使用非常方便，您可以选择①**手动设置**代理IP并在浏览器中使用， 也可以通过②**API接口获取**代理并参照代码样例集成到您的程序中。 具体请查看 - [手动设置代理指南 ＞](https://www.qg.net/doc/6672.html) - [开发者使用代理指南 ＞](https://www.qg.net/doc/6671.html) ##9 产品购买 - [隧道代理（全球HTTP）＞](https://www.qg.net/business/proxyip.html?region=overseas&product_type=3&pool_type=14 ) - [短效代理（全球HTTP） ＞](https://www.qg.net/business/proxyip.html?region=overseas&product_type=1&pool_type=14&extract_mode=1 ) - [长效代理（全球HTTP） ＞](https://www.qg.net/business/proxyip.html?region=overseas&product_type=4&pool_type=14&number=1) - [独享代理（全球HTTP） ＞](https://www.qg.net/business/proxyip.html?region=overseas&product_type=2&pool_type=14&number=1)

## 1 概述 为了保证您购买的代理业务只有您的服务器才能使用，我们采用了IP白名单验证方式，通过设置IP白名单IP，除了您指定的服务器IP外，其他IP不能使用。 白名单可以免密钥验证，免费IP白名单鉴权数量高达256个，也就是说购买后您有256台独立外网IP的机器可以使用。不限制同时使用的终端设备数量，满足多业务需求。 需要注意的是，短效代理与独享代理需要在未提取IP之前添加白名单IP，才能生效； 同个账号内不同key的白名单IP若有冲突可联系售前或售后处理。 ## 2 步骤说明 ### 2.1 先查到您要使用的机器的外网IP。 如果是办公室电脑，可以访问https://ip.cn/api/index?ip=&type=0 查询您的外网IP； 如果是Linux服务器，可以通过如下命令查看机器外网IP：`curl https://d.qg.net/ip` ### 2.2 绑定您机器的IP作为白名单 根据您购买的代理业务，您可以在【会员中心-列表操作-白名单】或调试工具添加IP白名单，完成设置后，这些IP对应的机器就可以正常使用了。 **2.2.1 白名单管理** 进入控制台，点击【代理IP】菜单，找到您所要使用的业务，点击其右侧【更多】下的【业务设置】-【白名单管理】，进入设置；  你可以在该页面方框中对白名单IP进行增加、删除、修改，设置完毕后点击【提交】。 详情如下图：  ** 2.2.2 调试工具** 在调试工具上勾选要使用的业务key，选择【IP白名单】模块相关操作接口，包括添加、删除和查询，输入您的机器外网IP，点击测试即可完成设置。详情如下图：   ### 2.3 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＞")