隧道代理-使用指南-开发版
青果隧道代理与其他形式的代理IP不同，不需要API接口即可连接使用代理IP，因此省去了获取IP和管理IP池等动作。以下介绍如何用代码方式，快速使用隧道代理。
步骤总览
一、获取隧道地址
1.在青果完成产品购买后，就会自动进入控制后台，看到如以下的页面，产品列中就有隧道地址；
请注意，目前国内代理IP和全球HTTP的产品，除了按量提取对应的套餐是按量业务之外，其他产品都属于按时业务。
二、授权验证
获取到隧道地址之后，还需要有授权验证才能使用代理。隧道代理支持白名单和帐密两种验证方式，可自主选择使用。
白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功；
账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。
详细步骤可查看代理验证 ＞
三、代理测试
在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。
以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。
curl -x http://{authkey}:{authpwd}@隧道地址 {targetUrl}
若响应不成功，可对应错误码表，排查问题。
四、编写采集程序
测试代理可用后，便可开始编写代理采集程序了。
青果提供了多种编程语言的代码示例供开发者参考，
详情查看
注：青果代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。
五、其他应用
参数规则
| 参数 | 含义 | 格式 | 示例 |
|---|---|---|---|
| -A- | 指定地区（单个） | -A-{地区编码} | -A-120100（天津） |
| -C- | 指定通道 | -C-{通道名} | -C-tunnel3 |
| -S- | 指定通道（同 -C-） | -S-{通道名} | -S-tunnel1 |
| -T- | 指定存活时长（秒） | -T-{秒数} | -T-60 |
- -A- 格式支持拼在authkey后面，也支持拼在authpwd后面。国内代理仅支持通过地区编码指定地区。编码详见 国内区域编码表。
兼容旧格式 :A、:C、:T（如 :A120100、:Cchannel-1、:T60），旧格式仅支持拼在密码后面。
参数拼接说明
所有参数不区分位置，可以拼接在 Authkey（用户名） 后面，也可以拼接在 AuthPwd（密码） 后面，也可以两边同时拼接，顺序不固定。
curl -x {Authkey}{参数}:{AuthPwd}{参数}@{隧道服务器} {目标url}
示例：
# 参数全部拼在 Authkey 后面
curl -x authkey-C-tunnel1-A-120100-T-60:password@tun-szbhry.qg.net:25889 myip.ipip.net
# 参数全部拼在 AuthPwd 后面
curl -x authkey:password-C-tunnel1-T-60-A-120100@tun-szbhry.qg.net:25889 myip.ipip.net
# 参数分散在两边
curl -x authkey-T-60:password-A-120100-C-tunnel1@tun-szbhry.qg.net:25889 myip.ipip.net
- 优先级： 当两侧同时指定了相同参数时，密码侧优先。
指定使用某个地区的IP
隧道代理每次请求会随机更换IP，通过 -A- 可将随机范围限定到某个地区。（仅限中国大陆地区）
使用英文缩写
curl -x authkey:password-A-120100@tun-szbhry.qg.net:25889 myip.ipip.net
// 或
curl -x authkey-A-120100:password@tun-szbhry.qg.net:25889 myip.ipip.net
如果两侧同时指定了地区，密码侧优先：
// 用户名指定天津(120100)，密码指定北京(110100)，最终使用北京IP
curl -x authkey-A-120100:password-A-110100@tun-szbhry.qg.net:25889 myip.ipip.net
地区编码详见 国内区域编码表。
保持IP不变
如果需要多个请求维持同一个IP（如登录 + 获取数据），可通过 -T- 指定存活时长（单位：秒）。
隧道代理下，-T- 必须与 -S-（或 -C-）同时传或同时不传。 通道名为任意非特殊符号字符串。
// 参数全在密码侧
curl -x authkey:password-S-tunnel1-T-30@tun-szbhry.qg.net:25889 myip.ipip.net
// 参数全在用户名侧
curl -x authkey-S-tunnel1-T-30:password@tun-szbhry.qg.net:25889 myip.ipip.net
// 参数分布在两侧
curl -x authkey-T-30:password-S-tunnel1@tun-szbhry.qg.net:25889 myip.ipip.net
注意： 仅指定 -T- 而不指定通道，无法保证IP不变。
组合使用
多个参数可以自由组合，顺序不限。
// 参数全在密码侧
curl -x authkey:password-A-120100-C-tunnel3-T-30@tun-szbhry.qg.net:25889 myip.ipip.net
// 参数分布在两侧
curl -x authkey-A-120100:password-S-tunnel1-T-30@tun-szbhry.qg.net:25889 myip.ipip.net
// 参数全在用户名侧
curl -x authkey-A-110100-S-tunnel2-T-30:password@tun-szbhry.qg.net:25889 myip.ipip.net