隧道代理开发手册

总览

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

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

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

API接口

隧道代理API接口一览

接口名称 接口功能
GetTpsIp 获取隧道当前IP
ChangeTpsIp 立即更换隧道IP
GetIpWhitelist 获取隧道IP白名单
SetIpWhitelist 设置隧道IP白名单

测试隧道可用性

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

查看测试步骤

关于IP白名单数量

如果您选择设置白名单访问隧道,最多可设置50个白名单IP。
只要请求不超过购买时选择的每秒并发数,通过用户名密码访问隧道的IP数量没有限制。

手动更换IP

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

手动换IP的频率限制

在隧道的1个换IP周期内,调用更换隧道IP接口换IP的次数不能超过2次
举例说明:您购买的是5分钟换IP的隧道,那么5分钟内您最多可以调用此接口2次。

频率限制

隧道代理的请求频率在购买时选择的并发数决定,默认的并发数是1秒5次
请求超过频率可能收到429错误。
注意控制请求频率,持续过快请求,您的IP可能被临时屏蔽。

错误码一览

HTTP返回码 Response body内容 说明
407 - 1. 没有带上用户名密码验证
2. 用户名密码错误,验证失败
429 Too Many Request 请求频率超过限制
503 Service Temporarily Unavailable 隧道转发代理IP错误
403 Over Max Connection 超过最大并发连接数
403 Access Forbidden 禁止访问该网站

开发建议

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

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

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

  3. 尽可能采用gzip压缩加速访问,在header里添加:Accept-Encoding: gzip
  4. 关注隧道返回码可协助您排查错误。

使用gzip详解

使用gzip压缩传输数据可显著提升访问速度,方法非常简单:
只需在http请求的header里加上:
Accept-Encoding: gzip
收到HTTP Response后检查header里是否包含:
Content-Encoding: gzip
如果包含,则对body进行gzip解压,就能得到原始内容。

代码样例

请求http隧道

SDK下载

SDK下载