> 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/dai-li-can-shu-shuo-ming.md).

# 代理参数说明

在 IPWO 中，代理参数主要通过**用户名（Username）传递**，用于控制 IP 的地区、会话、时长等行为。

👉 这是 IPWO 动态住宅代理的核心机制

***

### 🚀 参数格式

用户名结构示例：

```
username_custom_zone_US_sid_12345_time_10
```

👉 基本格式：

```
username + 参数拼接（用 _ 连接）
```

***

### 📌 常用参数说明

#### 🌍 国家（zone）

指定代理 IP 所在国家

```
custom_zone_US
```

常见示例：

* US → 美国
* JP → 日本
* GB → 英国

👉 用于实现地区定向访问 ([Zkjds](https://www.zkjds.com/post/2579.html?utm_source=chatgpt.com))

***

#### 🔄 会话（sid）

控制是否使用粘性 IP（固定 IP）

```
sid_12345
```

说明：

* 相同 sid → 使用同一个 IP
* 不同 sid → 分配不同 IP

👉 适用于登录、账号等需要稳定 IP 的场景

***

#### ⏱ IP 时长（time）

控制 IP 保持时间（分钟）

```
time_10
```

说明：

* 单位：分钟
* 到期后自动更换 IP

👉 常用于动态轮换代理 ([Zkjds](https://www.zkjds.com/post/2579.html?utm_source=chatgpt.com))

***

#### 🏙 城市（可选）

指定更精细的地理位置

```
city_Tokyo
```

👉 可与国家参数组合使用

***

#### 🧭 省份 / 州（可选）

```
st_California
```

👉 适用于更精准定位（部分地区支持）

***

### ⚡ 完整示例

```bash
curl -x "us.ipwo.net:7878" \
-U "username_custom_zone_US_st_California_city_LosAngeles_sid_12345_time_10:password" \
https://ipinfo.io
```

***

### 🔍 参数组合规则

* 参数通过 `_` 连接
* 顺序不限（建议保持规范顺序）
* 可按需组合多个参数

示例：

```
username_custom_zone_JP_sid_8888_time_5
```

***

### 💡 使用建议

* 新手建议先只使用 `zone`
* 需要稳定 IP 时再添加 `sid`
* 避免一次添加过多参数，方便排错
* 参数越多，控制越精细

***

### ❗ 常见问题

#### 参数不生效？

* 检查拼写是否正确
* 确认参数格式是否符合规则

***

#### IP 不切换？

* 检查是否设置了固定 sid

***

#### IP 不在指定地区？

* 检查 zone / city 是否正确

***

### 👉 下一步

* 查看「[快速验证](/kai-fa-zhe-wen-dang/kuai-su-kai-shi/kuai-su-yan-zheng.md)」→ 测试参数是否生效
* 查看「[接入方式](broken://pages/FytZ1eL5v0h0ZG7guXuy)」→ 集成到代码
* 查看「[API 提取](/kai-fa-zhe-wen-dang/kuai-su-kai-shi/huo-qu-dai-li-xin-xi/api-dong-tai-huo-qu-jin-dong-tai-dai-li.md)」→ 自动获取代理

***

### 总结

IPWO 参数的核心特点：

* 参数写在用户名中
* 通过拼接控制代理行为
* 支持地区、会话、时长等多维控制

👉 理解这一点，就掌握了 IPWO 的核心用法

***