隧道代理开发手册

总览

新手开发者可通过如下2个步骤使用隧道代理：

一、购买成功后，先在会员中心查看隧道信息，进行本地调试和验证。

二、 参考代码样例请求隧道代理访问目标网站。

API接口

隧道代理API接口一览

测试隧道可用性

隧道代理支持白名单和用户名密码两种验证方式，建议您先在本机测试，测试OK后就可以正常使用了。

查看测试步骤

使用多通道

对于换IP周期15秒~1小时的隧道代理，支持多通道使用，在同一换IP周期内每个通道会转发一个独立的代理IP。

目前支持2种转发模式：

您可以在会员中心-隧道订单管理里查看和修改转发模式。

编程使用多通道

以10通道的隧道订单为例，可划分通道编号为1~10。
您可以在程序中通过如下两种方式指定转发到哪个编号的通道：

import base64
print base64.b64encode('t18725652473456:jkr369ry:3') #输出dDE4NzI1NjUyNDczNDU2OmprcjM2OXJ5OjM=

kdl-tps-channel: 3

手动更换IP

对于换IP周期>=1分钟的隧道代理，隧道会根据您购买时选择的周期自动切换IP，但使用途中如果您发现该IP不可用，可以调用更换隧道IP接口让隧道立即更换一个新IP。

频率限制

隧道代理的请求频率在购买时选择的并发数决定，默认的并发数是1秒5次。
请求超过频率可能收到441错误。
建议经常关注隧道使用统计的频率提示，把握好请求频率。
并发数不够用可在隧道管理页升级并发数。

错误码一览

隧道使用统计

隧道使用统计功能提供了对请求量和请求错误的统计分析。
您可以随时关注采集程序的运行走势，了解发生的错误并及时修正。我们还为几种常见的错误提供了分析和提示，帮助您提升采集程序运行的成功率。

隧道带宽监控方便您跟踪平均带宽和峰值带宽占用。 通过带宽监控折线图，您可以更好地把控带宽使用情况。

开发建议

参考如下开发建议，可以帮助您更加顺利地完成开发和调试：

1. 控制好请求频率，用同一IP请求同一网站建议不超过1秒1次，避免IP被目标网站屏蔽。

2. 使用中发现IP不可用可调用更换隧道IP接口让隧道立即更换一个新IP。了解手动换IP>>
   

3. 建议关闭HTTP协议的keep-alive功能，避免因连接复用导致隧道不能切换IP
4. 尽可能采用gzip压缩加速访问，在header里添加：Accept-Encoding: gzip
5. 关注隧道返回码可协助您排查错误。

代码样例

请求http隧道

SDK下载

SDK下载