总览
新手开发者可通过如下2个步骤使用隧道代理：
1、购买成功后，先在控制台查看隧道信息，进行本地调试和验证。
2、参考代码样例（在实例管理下的控制面板中查看）请求隧道代理访问目标网站。
隧道代理使用非常灵活，可以设置ip地区、换ip周期、运营商、IP资源池等。
API接口文档说明
隧道代理 API接口一览
| 接口名称 | 接口功能 |
| GetIP | 获取当前隧道代理服务器 |
| GetTransRuleIP | 查询隧道及当前IP |
| GetIpWhiteList | 获取IP白名单 |
| SetIpWhiteList | 设置IP白名单 |
| AddWhiteIp | 添加IP白名单 |
| DelWhiteIp | 删除IP白名单 |
| ClearWhiteIp | 清空IP白名单 |
| GetProvCode | 获取隧道代理省份编码 |
| GetCityCode | 获取隧道代理城市编码 |
测试隧道可用性
隧道代理支持白名单认证和账号密码两种验证方式，建议首次使用时，先在本地环境完成功能验证，通过测试后即可投入正式使用。
关于IP白名单数量如果您选择设置白名单模式访问，最多支持绑定200个IP地址。 如果您选择用户名密码模式访问，只要并发请求数不超过套餐规格，访问隧道的IP数量没有限制。 |
ip地区、换ip周期、自主选择IP池
控制台设置
您可以在控制台-实例管理-隧道代理里查看和修改当前的地区、换IP周期、自主选择网络运营商、自主选择资源池，成功修改后，60秒内生效。
编码设置
如果您想要更精细化地控制隧道转发，可以在用户名后面添加不同的参数。例如您的用户名为20250114387972168168，密码为hywh8168，下面是参数说明：
area、prov、city 指定出口ip地区
当设置多个地区参数时，如 |
您可以根据使用场景，灵活组合参数 |
当您通过编码方式设置地区、周期，资源调度策略时，系统会忽略您在控制台-实例管理-隧道代理里的地区、周期，资源调度策略。 |
频率限制
隧道代理的请求频率由购买时选择的并发数决定，默认并发数为每秒5次。
超出请求频率可能会收到441错误。
建议定期查看隧道使用统计的频率提示，合理控制请求频率。
如并发数不足，可在隧道管理页升级。
频率控制提示隧道代理采用弹性频率控制，允许短期超出并发规格，以支持更多使用场景。 但若持续请求超频，超出部分的请求将被拒绝。 |
错误码一览
| HTTP返回码 | Response body 内容 | 说明 |
| 407 | 情况一：Proxy Authentication Failed:%auth 情况二：White IP Failed:$client_ip | 情况一：用户名密码验证失败 情况二：白名单验证失败 |
| 440 | Bandwidth Over Limit | 带宽超限 |
| 441 | Request Rate Over Limit | HTTP请求/TCP连接超频 |
| 442 | Authentication Type Error | 认证方式检测失败 |
| 443 | Foreign Client Forbidden | 禁止海外客户端 |
| 444 | Download Not Allowed | 禁止下载文件 |
| 445 | illegal Request Forbidden | 非法的请求 |
| 446 | Host DNS Failed | DNS解析错误 |
| 447 | Real-name Authentication Required | 需要实名认证 |
| 448 | Target Port Forbidden | 禁止访问目标端口 |
| 449 | Foreign Host Forbidden | 禁止访问境外网址 |
| 450 | IP As Host Forbidden | 禁止通过IP访问 |
| 451 | Miss Host | 代理请求格式不正确 |
| 452 | Public Host Required | 目标地址不是公网IP |
| 453 | Proxy Port Error | 使用了错误的端口号 |
| 454 | Proxy Authentication Expired | 代理验证过期 |
| 457 | Backend Proxy Bandwidth Over Limit | 上级代理带宽超限 |
| 458 | Backend Proxy Refused | 上级代理拒绝连接 |
| 464 | Invalid Param | username中携带的参数不合法 |
| 458 | Null Proxy | 所选地区没有ip资源 |
| 462 | Target Domain WhiteList Not Match | 目标域名白名单不匹配 |
| 463 | Target Domain BlackList Forbidden | 目标域名黑名单禁止访问 |
| 503 | Proxy Connect Error | 连接目标网站失败 |
隧道使用统计
隧道使用统计功能可实时分析请求量与请求错误情况。
您能借此洞察采集程序运行趋势，及时发现并修正错误。此外，我们针对常见错误提供了分析与提示，助力提升采集成功率。
隧道带宽监控可帮您实时跟踪平均带宽与峰值带宽占用，通过折线图直观呈现，便于您精准把控带宽使用。
开发建议
以下开发建议可助您更加顺利地完成开发与调试：
1. 同一IP请求同一网站频率建议控制在1秒1次以内，以免被目标网站屏蔽。
2. 建议关闭HTTP协议的keep-alive功能，防止连接复用影响隧道切换IP。
3. 建议启用gzip压缩，通过在header中添加"Accept-Encoding: gzip"加速访问。
4. 关注隧道返回码，有助于快速排查错误。
使用gzip详解使用 gzip 压缩传输数据能显著提升访问速度，操作也很简单： 在 HTTP 请求的 header 中添加 "Accept-Encoding: gzip"。 收到响应后，若 HTTP Response 的 header 包含 "Content-Encoding: gzip"， 则对响应体（body）进行 gzip 解压，即可获取原始内容。 |
