> ## Documentation Index
> Fetch the complete documentation index at: https://help.miyaip.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 代理 IP 轮换与粘性会话配置指南

> 比较每次请求切换 IP、粘性会话与受支持的手动切换，配置地区和会话参数，并用命令行核验连续请求的实际出口。

你可以保持同一网关地址，同时按会话策略使用不同出口。先选择任务需要的持续方式，再生成连接字段。[来源：MiyaIP 轮换代理说明](https://miyaip.com/blog/rotating-proxy)。

## 选择模式

| 模式 | 出口使用方式 | 配置时核对 |
| - | - | - |
| **每次请求切换** | 按该产品的请求规则选择出口 | 不要把短样本中的重复 IP 当作整个代理池的结论 |
| **粘性会话** | 在指定窗口内请求保持出口映射 | 时长、同一组会话字段和中断后的行为 |
| **手动 API 切换** | 使用产品提供的切换操作 | 当前产品是否提供此模式及对应说明 |
| 静态代理 | 使用分配给你的较长期固定地址 | 到期、续费与更换规则 |

当前动态生成器默认 **30 分钟**粘性会话，时长选项为 **5、10、15、30 分钟**。动态住宅和移动产品提供受支持的手动切换选项；不限量住宅当前提供每次请求切换和粘性会话，不提供手动 API 切换。以当前后台和套餐规则为准。

会话时长不会保存应用登录状态，也不能保证出口在整个窗口内始终可用。

## 配置与记录

<Steps>
  <Step title="选择产品与策略">
    打开[动态住宅](/zh/proxy/dynamic-residential/quick-start)、[动态移动](/zh/proxy/mobile/quick-start)或[不限量住宅](/zh/proxy/unlimited-residential/quick-start)的设置。核对 **轮换模式**，再选择 **持续时间**。

    若选择手动 API 切换，使用后台该模式提供的说明与接口。不要猜测切换 URL，也不要套用其他服务商的接口。
  </Step>

  <Step title="固定测试条件">
    选择出口地区、入口网关和协议，再复制生成的主机、端口、用户名、密码。记录模式、时长、地区和时间。

    测试粘性会话时复用同一组生成字段。重新生成用户名或更改会话设置后，开始一组新的记录。
  </Step>

  <Step title="逐次核验出口">
    运行下面与你的平台和协议一致的命令。顺序发出少量请求，记录返回 IP、完成情况和时间。然后用实际目标验证应用行为。

    每次请求切换与粘性会话分别测试，不要在同一组比较中同时更改地区、网关和协议。
  </Step>

  <Step title="处理不符合预期的结果">
    先检查请求是否确实经过代理、认证是否有效，以及生成字段是否对应所选模式。遇到超时或中断，保留错误后按当前产品规则恢复连接。

    重复 IP 需要结合会话、连接复用和所选规则判断。IP 检查服务只报告该次请求的出口；你还需要验证实际应用。
  </Step>
</Steps>

## 核验会话

以下全部大写字段都是占位符，请替换为你自己的后台输出。IP 检查使用 [ipify](https://www.ipify.org/) 的公开接口。HTTP 代理可以访问 HTTPS 目标；两者是不同的协议设置。

### macOS 或 Linux：HTTP

```bash theme={null}
curl --proxy 'http://PROXY_HOST:PROXY_PORT' --proxy-user 'PROXY_USERNAME:PROXY_PASSWORD' --noproxy '' --connect-timeout 10 --max-time 30 --url 'https://api.ipify.org?format=json'
printf 'curl_exit=%s\n' "$?"
```

### macOS 或 Linux：SOCKS5

```bash theme={null}
curl --proxy 'socks5h://PROXY_HOST:PROXY_PORT' --proxy-user 'PROXY_USERNAME:PROXY_PASSWORD' --noproxy '' --connect-timeout 10 --max-time 30 --url 'https://api.ipify.org?format=json'
printf 'curl_exit=%s\n' "$?"
```

### Windows PowerShell

```powershell theme={null}
$sessionProxy = 'http://PROXY_HOST:PROXY_PORT'
# For SOCKS5, use 'socks5h://PROXY_HOST:PROXY_PORT'
$sessionPreviousNoProxy = $env:NO_PROXY
try {
  $env:NO_PROXY = ''
  curl.exe --proxy $sessionProxy --proxy-user 'PROXY_USERNAME:PROXY_PASSWORD' --connect-timeout 10 --max-time 30 --url 'https://api.ipify.org?format=json'
  "curl_exit=$LASTEXITCODE"
} finally {
  $env:NO_PROXY = $sessionPreviousNoProxy
}
```

使用 `curl.exe` 避免 PowerShell 的 `curl` 别名。示例临时清空 `NO_PROXY`，结束后恢复，避免代理被排除规则绕过；不向旧版 PowerShell 传递易丢失的空字符串参数。

`socks5h://` 让代理解析目标域名；`socks5://` 则由本地解析。连接超时为 10 秒，总超时为 30 秒。命令中的测试超时与产品的会话分钟数无关。参数定义见 [curl 手册](https://curl.se/docs/manpage.html)。

检查 IP 后，再按[延迟测试](/zh/guides/latency)记录请求结果。分享记录时移除真实用户名和密码。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.