步骤总览

注：若使用白名单验证模式，请先添加白名单再进行API接口获取。

一、获取隧道地址

1.在开通隧道代理（全球HTTP）后，就会进入后台管理面板，会看到如以下画面。在业务列表中，可以看到对应的隧道地址。
隧道代理特殊的地方就在于不需要提取和管理大量IP，只需要拿到1个隧道地址便可直接在使用过程中获得所需动态IP，获取隧道地址就近似于获取其他代理产品的IP地址与端口。

请注意，目前国内代理IP和全球HTTP的产品，除了按量提取对应的套餐是按量业务之外，其他产品都属于按时业务。

二、授权验证

获取隧道地址之后，还需要有授权验证才能使用代理。青果代理支持白名单和帐密两种验证方式，可自主选择使用。

白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功；

账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。

详细步骤可查看代理验证

三、代理测试

在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。

以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。

curl -x http://{authkey}:{authpwd}@隧道地址 {targetUrl}

若使用白名单模式，不需要添加authkey和authpwd。

curl -x {隧道服务器} {目标url}
例子 curl -x overseas.tunnel.qg.net:15561 www.baidu.com

四、编写采集程序

测试代理可用后，便可开始编写代理采集程序了。

青果提供了以下的编程语言的代码示例以及SDK下载包供开发者进行隧道代理参考，

＞＞SDK下载

＞＞隧道代理 Go 语言接入指南

＞＞隧道代理 Python 语言接入指南

其他应用

另外，虽然隧道代理不需要API接口就能使用代理，但也提供了白名单验证的接口，以下简单介绍隧道相关的白名单接口使用以及一些指定功能。

API列表

隧道不支持API的调用，只有白名单功能的API接口。

指定使用某个国家的IP

因为隧道代理每次请求都会随机更换IP，如果你希望随机范围限定在某个国家，可以通过添加国家编码参数来指定使用某个国家的IP。具体编码请查看 区域编码表

curl -x {authkey}:{authpwd}:A{国家编码}@{隧道服务器} {目标url}
// 例子，指定使用美国IP
curl -x HBRMO154:4799868CE54:A990100@overseas.tunnel.qg.net:15561 www.baidu.com

保持IP不变

如果用户需要多个请求在维持一个IP，比如：需要登录,获取数据两个请求在一个IP下,则可对IP进行打标记，通过标记请求在代理有效期内使用相同的代理IP，并且可以支持设定该通道的存活时间。

curl -x {authkey}:{authpwd}:C{自定义通道名}:T{存活时间}:A{国家编码}@{隧道服务器} {目标url}
// 例子，通道名自定义为100，存活时间设为60秒
curl -x HBRMO154:4799868CE54:Cchannel-1:T60:A990100@overseas-us.tunnel.qg.net:15561 www.baidu.com

注意：如果需要保持IP不变一段时间，那么不可以使用通用的overseas.tunnel.qg.net域名，需要使用特定地区的服务器域名，比如：overseas-us.tunnel.qg.net/overseas-hk.tunnel.qg.net等!!!否则服务器无法保证是否可以保持IP不变。

指定隧道服务器

为了降低使用隧道服务的延迟，青果网络为隧道代理（全球HTTP）提供了多个隧道服务器，用户可根据自身的使用情况就近选择隧道服务器。隧道服务器的地址可在控制台中查看。

curl -x {authkey}:{authpwd}:C{自定义通道名}:T{存活时间}:A{国家编码}@{隧道服务器} {目标url}
// 例子，更换隧道服务器为美国的隧道服务器
curl -x HBRMO154:4799868CE54:Cchannel-1:T60:A990100@overseas-us.tunnel.qg.net:15561 www.baidu.com