隧道代理（短效版）手动切换IP的使用说明-帮助中心 - 小象代理

隧道代理（短效版）手动切换IP的使用说明

更新时间： 2026-09-18 14:49:51

短效版隧道代理默认按分钟自动更换出口IP，适合大多数常规采集场景。但在实际业务中，我们经常遇到“等不到下一分钟”的情况：突然被目标网站限速、触发验证码、当前IP被临时封禁，或者需要让某个通道立即切换到一个新IP继续任务。这时，手动换IP功能就派上了用场。

小象代理隧道代理（短效版）支持通过 HTTP 请求头 `Proxy-Switch-Ip: true` 手动触发IP更换。本文给出一份完整使用说明和示例，帮助你快速接入。

---

## 一、功能说明

在请求头中加入：

```http
Proxy-Switch-Ip: true
```

代理服务器收到该请求后，会为当前通道立即更换出口IP。手动换IP是在短效版自动换IP之外增加的即时触发方式，适合需要“马上换一个IP”的场景。

几个关键规则：

1. **最低使用时长 10 秒**  
   每次更换后的IP至少使用10秒。如果距离上次换IP不足10秒，再次携带该请求头可能不会立即生效。

2. **按通道独立生效**  
   如果你使用了多通道功能，手动换IP只影响当前请求所使用的通道，其他通道不受影响。

3. **不指定通道时作用于默认通道**  
   鉴权串不追加通道号时，请求走默认通道，手动换IP也会切换默认通道的出口IP。

4. **HTTPS 场景需注意请求头传递方式**  
   对于 HTTPS 目标，普通请求头会随加密流量发送给目标站，代理服务器不一定能看到。建议使用支持“代理请求头”的客户端，例如 curl 的 `--proxy-header`，如当前使用的客户端/SDK不支持“代理请求头”，也可以参考下面

## 二、cURL 示例

### 1. HTTP 目标：手动换IP

```bash
curl -x "http://123456789012345678:abcdefgh@隧道代理地址:端口" \
     --proxy-header "Proxy-Switch-Ip: true" \
     "http://cip.cc"
```

### 2. HTTPS 目标：手动换IP

HTTPS 场景建议使用 `--proxy-header`，让请求头发送给代理服务器，而不是目标网站：

```bash
curl -x "http://123456789012345678:abcdefgh@隧道代理地址:端口" \
     --proxy-header "Proxy-Switch-Ip: true" \
     "https://cip.cc"
```

### 3. 验证IP是否已切换

可以先请求一次查看当前IP，再带换IP头请求一次：

```bash
# 查看当前出口IP
curl -x "http://123456789012345678:abcdefgh@隧道代理地址:端口" \
     "http://cip.cc"

# 等待10秒
# 手动触发换IP
curl -x "http://123456789012345678:abcdefgh@隧道代理地址:端口" \
     --proxy-header "Proxy-Switch-Ip: true" \
     "http://cip.cc"
```

---

## 三、Python requests 示例

Python requests库不支持“代理请求头”。
对于 HTTP 目标，可以通过 `headers` 传递换IP请求头：

```python
import requests

proxy_url = "http://123456789012345678:abcdefgh@隧道代理地址:端口"
proxies = {
    "http": proxy_url,
    "https": proxy_url,
}

headers = {
    "Proxy-Switch-Ip": "true"
}

# 手动换IP并请求
resp = requests.get(
    "http://cip.cc",
    proxies=proxies,
    headers=headers,
    timeout=10
)

print(resp.text)
```

注意：如果你请求的是 HTTPS 目标，`requests` 的普通 `headers` 通常不会出现在代理的 CONNECT 请求中，因此可能无法触发手动换IP。HTTPS 场景建议可通过上述换IP请求头的方式发起一个任意HTTP请求（比如就固定请求http://www.baidu.com, http://cip.cc 等），或使用支持代理请求头设置的客户端/SDK。

---

## 四、适用场景

手动换IP特别适合以下情况：

- 当前IP突然被目标网站限速或封禁，需要立即更换；
- 采集任务卡在验证码页面，希望换IP后继续；
- 多通道场景下，只希望切换某一个通道的IP；
- 定时任务需要在特定时间点主动切换出口IP；
- 调试代理时，需要快速验证不同IP的访问效果。

---

## 五、注意事项

1. **不要每个请求都携带换IP头**  
   频繁触发换IP会造成IP资源浪费，也可能影响业务稳定性。建议仅在需要时使用。

2. **遵守最低10秒限制**  
   同一通道换IP后至少10秒内不会再次更换，短时间内重复触发可能无效。

3. **多通道之间互不影响**  
   通道1手动换IP，不会影响通道2、通道3等其他通道。

4. **检查鉴权信息**  
   如果返回 407、403 或连接失败，请检查应用ID、应用密码、通道号、代理地址和端口是否正确。

5. **HTTPS 优先使用代理请求头**  
   curl 使用 `--proxy-header`；其他语言和框架请确认是否支持将自定义头发送给代理服务器。

---

## 六、常见问题

**Q：为什么我加了 `Proxy-Switch-Ip: true` 但没有换IP？**  
A：常见原因有：距离上次换IP不足10秒；HTTPS 请求头没有传递给代理；通道号写错；鉴权失败；代理地址或端口配置错误。

**Q：多通道下如何只换某个通道的IP？**  
A：在鉴权串中指定通道号，例如 `应用ID:应用密码:1`，然后携带 `Proxy-Switch-Ip: true` 发起请求，即可只切换该通道的出口IP。

**Q：手动换IP后，新IP能用多久？**  
A：换到的IP至少可使用10秒，之后仍按短效版隧道代理的自动切换规则继续运行。

**Q：HTTPS 下 Python requests 怎么写？**  
A：常规 `requests` 写法对 HTTPS CONNECT 不一定生效。建议使用 curl 的 `--proxy-header` 验证，或参考小象代理官方文档/SDK 中关于 HTTPS 手动换IP的推荐方式。

---

手动换IP功能无需额外开通，已随隧道代理（短效版）提供。你只需要在需要立即切换IP的请求中加上 `Proxy-Switch-Ip: true`，即可让当前通道快速换到一个新的出口IP。更多细节可参考官方文档：  
https://www.xiaoxiangdaili.com/help/dev/guide_tun_short

上一篇： IP池客户端API文档