> For the complete documentation index, see [llms.txt](https://docs.ipwo.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ipwo.net/kai-fa-zhe-wen-dang/api-shi-yong-zhi-nan/session-shi-yong-shuo-ming.md).

# Session 使用说明

IPWO 支持 Session（会话）功能，用于在一定时间内保持同一出口 IP，适用于需要“稳定登录状态”的业务场景。

***

### 一、什么是 Session？

Session（会话）是指在代理请求中，通过指定参数让同一段时间内的请求使用相同的出口 IP。

简单理解：

```
不使用 Session → 每次请求可能换 IP
使用 Session → 一段时间内固定 IP
```

***

### 二、适用场景

Session 主要适用于：

* 社交媒体账号登录（TikTok / Facebook / Instagram）
* 电商账号运营（Amazon / eBay）
* 广告账户管理
* 需要保持登录状态的业务
* 防止频繁 IP 变化触发风控

***

### 三、Session 使用方式

在用户名中加入 Session 参数即可启用固定 IP 会话。

***

#### 示例格式

```
username_custom_zone_us_session_123456
```

说明：

* `session_123456` 为自定义 Session ID
* 相同 Session ID → 使用相同 IP
* 不同 Session ID → 分配不同 IP

***

### 四、cURL 示例

```bash
curl -x http://us.ipwo.net:7878 \
-U username_custom_zone_us_session_123456:password \
http://ipinfo.io
```

***

### 五、Session 规则说明

#### 1. Session 保持时间

* 在有效时间内保持同一 IP
* 超过时间后可能重新分配 IP

***

#### 2. Session 切换逻辑

```
Session A → IP 1
Session A → IP 1（保持）
Session B → IP 2
```

***

#### 3. Session 随机性

* Session ID 相同 → IP 稳定
* Session ID 不同 → IP 不同

***

### 六、如何设计 Session ID？

建议使用：

* 用户 ID + 时间戳
* 业务编号
* 账号标识

示例：

```
user_1001_tiktok
order_20240601
fb_account_01
```

***

### 七、使用建议

推荐：

* 一个账号对应一个 Session ID
* 不要频繁更换 Session
* 长期登录场景保持固定 Session
* 多账号使用不同 Session

***

### 八、常见问题

#### Session 不生效

请检查：

* 是否正确写入 username
* Session 格式是否正确
* 是否使用相同 Session ID

***

#### IP 仍然变化

可能原因：

* Session ID 每次请求都不同
* Session 已过期
* 使用了轮换模式

***

#### Session 和轮换冲突

如果同时使用：

* Session → 固定 IP
* 轮换 → 自动换 IP

请避免混用逻辑冲突。

***

### 九、相关文章

* [什么是粘性会话](/dai-li-ji-chu-zhi-shi/shen-me-shi-nian-xing-hui-hua.md)
* [什么是轮换 IP](/dai-li-ji-chu-zhi-shi/shen-me-shi-lun-huan-ip.md)
* [如何降低账号关联风险](/dai-li-jian-ce-yu-yin-si-an-quan/ru-he-jiang-di-zhang-hao-guan-lian-feng-xian.md)
* [代理连接失败](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/dai-li-lian-jie-shi-bai.md)
* [如何检测代理是否生效](/dai-li-jian-ce-yu-yin-si-an-quan/ru-he-jian-ce-dai-li-shi-fou-sheng-xiao.md)

> 建议在账号登录类业务中优先使用 Session 模式，可显著降低登录频繁失效和风控风险。