隧道代理（短效版）接入指南-帮助中心 - 小象代理 - 优质高速HTTP代理IP-爬虫-代理服务器

隧道代理（短效版）接入指南

更新时间： 2023-09-18 09:12:55

[TOC]

### 产品说明

隧道代理（短效版）提供固定的入口地址，用户成功接入后，一分钟之内所有请求都是通过同一个 IP 进行转发，每分钟服务器自动切换IP。

### 服务器地址

| 服务器地址 | 端口 | 并发抵扣比例 |
| ------------ | ------------ | :------------: |
| http-short.xiaoxiangdaili.com | 10010 | 1 |

### 用户鉴权

[使用代理时的鉴权认证方式](https://www.xiaoxiangdaili.com/help/dev/quickstart#使用代理时的鉴权认证方式)

### 手动更换IP

默认情况下，隧道代理（短效版）的真实转发IP由云端服务器自动每分钟进行切换。同时也支持用户手动进行切换，具体方法如下：

在 HTTP 请求中增加键为『Proxy-Switch-Ip』， 值为『true』的协议头信息，应用程序将请求通过隧道发出后，HTTP隧道会立刻提取一个新的IP，当前请求和随后发起的请求都会通过新的 IP地址 进行转发。

每次更换的IP最低使用时长为10秒，低于10秒内的多次更换指令将会被忽略。

### 代码示例

- [AutohotKey](https://www.xiaoxiangdaili.com/tunnel-dynamic/AutohotKey/guide)
- [C#](https://www.xiaoxiangdaili.com/tunnel-dynamic/CSharp/guide)
- [Delphi](https://www.xiaoxiangdaili.com/tunnel-dynamic/Delphi/guide)
- [Golang](https://www.xiaoxiangdaili.com/tunnel-dynamic/Golang/guide)
- [JAVA](https://www.xiaoxiangdaili.com/tunnel-dynamic/JAVA/guide)
- [NodeJS](https://www.xiaoxiangdaili.com/tunnel-dynamic/NodeJS/guide)
- [PHP](https://www.xiaoxiangdaili.com/tunnel-dynamic/PHP/guide)
- [Python](https://www.xiaoxiangdaili.com/tunnel-dynamic/Python/guide)
- [Selenium](https://www.xiaoxiangdaili.com/tunnel-dynamic/Selenium/guide)

### 软件接入示例

- [Chrome](https://www.xiaoxiangdaili.com/tunnel-dynamic/Chrome/guide)
- [curl](https://www.xiaoxiangdaili.com/tunnel-dynamic/curl/guide)
- [Firefox](https://www.xiaoxiangdaili.com/tunnel-dynamic/Firefox/guide)
- [httpie](https://www.xiaoxiangdaili.com/tunnel-dynamic/httpie/guide)
- [mitmproxy](https://www.xiaoxiangdaili.com/tunnel-dynamic/mitmproxy/guide)
- [PhantomJS](https://www.xiaoxiangdaili.com/tunnel-dynamic/PhantomJS/guide)
- [Squid](https://www.xiaoxiangdaili.com/tunnel-dynamic/Squid/guide)
- [wget](https://www.xiaoxiangdaili.com/tunnel-dynamic/wget/guide)

### 注意
- Java8以上版本，请在运行的时候，加上 `-Djdk.http.auth.tunneling.disabledSchemes=""`。 具体原因请参考： [Unable to tunnel through proxy since Java 8 Update 111](https://stackoverflow.com/questions/41806422/java-web-start-unable-to-tunnel-through-proxy-since-java-8-update-111)

- 使用Python2 的示例代码访问 HTTPS 协议的 URL 会有问题，建议使用 Python3。

### 常见错误码
| 错误码 | 提示信息 | 说明 |
| ------------ | ------------ | ------------ |
| 407 | No Proxy-Authorization or Authorization can be found | 鉴权失败。未正确设置账号密码，且当前用户ip不在白名单列表 |
| 407 | Appkey is not a number | 账号包含非数字字符 |
| 407 | Not found | 应用不存在 |
| 407 | Wrong password | 密码错误 |
| 407 | Disabled | 应用被禁止 |
| 407 | Expired | 应用已过期 |
| 407 | Not found or expired | 应用不存在或已过期 |
| 407 | Proxy type mismatch | 产品类型不匹配 |
| 429 | Too Many Requests | 超过并发限制，请降低频率或者使用调整隧道代理套餐 |
| 500 | Unknown exception | 未知异常，一般是目标站点异常响应 |

### 开发建议
1. 控制好请求频率，超过并发后服务器会返回429错误，注意做好异常处理。
2. 优先使用各个程序框架原生的账号密码认证，可避免白名单变化导致调用失败。尽可能不要用请求头的认证方式，有很多框架会过滤请求头导致认证失败。
3. 尽可能采用gzip压缩可显著提升访问速度，在header里添加：Accept-Encoding: gzip

上一篇：代理IP（静态版）接入指南

下一篇：隧道代理（动态转发）接入指南