帮助文档>代理IP>操作指南 > 隧道代理使用指南

隧道代理使用指南

发布时间:2021-08-03 20:48

1 步骤说明

1.在开通隧道代理IP后,单击网站右上角的【控制台】,进入后台管理面板,在左侧栏目里选择【代理IP】-【按时/按量业务】,找到已经开通的隧道代理业务;
image-20221119161844905

image-20221119161801706

2.隧道代理无须提取IP,接入隧道服务即可;

3.参考代码样例请求隧道代理;

4.在程序中通过调用API接口获取代理,然后请求目标网站。

(1)API调用需要验证,验证方式包括密钥验证和白名单验证,根据实际使用自主选择;

(2)密钥验证方式请求头带AuthKey和AuthPwd信息即可;

(3)添加白名单可以免密,添加白名单后大概在30s之后生效。

2 API列表

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

接口类型 API 描述
白名单相关 - whitelist/query
- whitelist/add
- whitelist/del
- 调用 whitelist/query查询IP的白名单
- 调用whitelist/add添加IP的白名单
- 调用whitelist/del删除IP的白名单

3 测试代理的可用性

隧道代理支持密钥验证和白名单两种验证方式,建议先在本机测试;
需要注意的是,隧道代理(动态请求)的请求不超过购买时选择的每秒并发数,支持短期高并发;
隧道代理(固定时长)的同时可用请求不超过购买时选择的通道数,测试OK后就可以正常使用了。

查看测试步骤 >

4 保持IP/IP打标记

如果用户需要多个请求在维持一个IP,比如:需要登录,获取数据两个请求在一个IP下,则可对IP进行打标记,通过标记请求在代理有效期内使用相同的代理IP。
隧道代理(固定时长)需要同时使用多IP,也需要对多个IP打标记,方便识别与使用。
查看代码示例 >

5 错误码一览表

HTTP返回码 说明
400 客户端错误。客户端协议无法被识别;
431 请求头过大。出现在http代理中,header头部信息过多导致;
302 出现302一般有两种情况:
(1).客户端IP为海外IP,服务器会重定向到预警页面;
(2).客户端访问的目标站被拦截,比如银行网站、邮箱、社交软件等,服务器返回重定向到预警页面;
407 授权错误,出现407一般有两种情况:
(1).白名单模式,可能是用户有多出口IP,没有全部添加到白名单;或可能连接使用IP资源,是添加白名单前获取的,白名单未对其生效;
(2).账密模式,可能是账密信息错误;
(3)共享IP产品中可能是IP已过期;
408 目标站不可达。服务端与目标站建连失败,服务端不可达或者当前代理IP掉线;
429 请求数超出。隧道产品中用户QPS大于购买的请求数;独享和共享产品中,用户当前的代理tcp连接超出限制数;
508 代理目标站为代理IP地址导致死循环。一般不出现;
503 当前代理协议不支持,比如ss代理协议;

6 代理请求数据统计

代理请求数据统计包括IP请求统计,提供了对请求量和请求错误的统计分析。方便随时关注采集程序的运行情况,及时发现错误并修正。

同时IP请求统计还提供几种常见的错误类型分析,如请求成功、授权失败、请求数超出、连接超时等,助力数据高效采集。
image-20221108103607172

7 代码样例

  • 调用API >

  • 隧道代理(动态请求)代码示例 >

本文导读

客户热线: