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

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

更新时间： 2026-08-25 12:27:29

[TOC]

### 产品说明

隧道代理（短效版）提供固定的入口地址，每分钟服务器自动切换IP。隧道代理（短效版）支持多通道，每个通道在同一换IP周期（1分钟）内使用同一个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地址 进行转发。

由于上述方法仅在目标地址协议为HTTP时有效，对于HTTPS协议的目标地址需要手动切换IP时，可以通过临时转发一个HTTP协议的目标地址来实现。

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

### 多通道

隧道代理（短效版）支持多通道，通道数由所购并发数自动计算。通道数决定隧道同一时间可使用的出口IP的最大数量：每个通道会转发一个独立的出口IP，并独立计算IP更换周期（1分钟），通道越多，同一时刻可用的出口IP就越多。

通道数与并发数的对应关系如下（通道数 = ⌈并发数 ÷ 5⌉，至少1个通道）：

| 并发数 | 可用通道数 |
 | ------------ | :------------: |
 | 1 - 9 | 1 |
 | 10 - 14 | 2 |
 | 15 - 19 | 3 |
 | 20 - 24 | 4 |
 | 25 - 29 | 5 |
 | 以此类推 | 每增加5并发，可用通道数 +1 |

#### 多通道的使用方式

在鉴权串中的『应用密码』后追加『:通道号』，即可指定本次请求通过对应编号的通道转发。
  - 通道号可以是任意随机数或字符串；
  - 相同通道号固定使用同一通道，不同通道号优先分配到不同通道；
  - 最大可用通道数由应用的并发决定，对应关系如上表格；
  - 未指定通道号时由默认通道转发；
  - 当通道数量已超过最大可用通道数时，新的通道号按规则复用已有通道，即有可能出现多个不同通道号使用到同一通道的情况；

#### 多通道的使用示例

假设应用id为 `123456789012345678`，应用密码为 `abcdefgh`，请求需要走第 1 号通道：
```text
123456789012345678:abcdefgh:1
```

### 代码示例

- [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（静态版）接入指南

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