> 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/can-shu-su-cha-biao.md).

# 参数速查表

IPWO 支持通过代理用户名、密码和连接参数配置不同的代理使用方式。本文整理常用参数，帮助开发者快速完成代理配置。

如需查看完整参数说明，请参考《[代理参数说明](/kai-fa-zhe-wen-dang/api-shi-yong-zhi-nan/dai-li-can-shu-shuo-ming.md)》。

***

### 一、代理连接参数

| 参数       | 示例                        | 说明           |
| -------- | ------------------------- | ------------ |
| Host     | `us.ipwo.net`             | IPWO 代理服务器地址 |
| Port     | `7878`                    | 代理端口         |
| Protocol | `HTTP / SOCKS5`           | 支持的代理协议      |
| Username | `username_custom_zone_us` | 代理认证用户名      |
| Password | `password`                | 代理认证密码       |

***

### 二、用户名参数

IPWO 通过用户名中的参数控制代理行为。

基本格式：

```
username_zone_country
```

示例：

```
username_custom_zone_us
```

其中：

| 参数      | 示例           | 说明     |
| ------- | ------------ | ------ |
| zone    | custom\_zone | 代理区域   |
| country | us           | 指定国家地区 |

***

### 三、国家地区参数

通过用户名指定代理 IP 所在国家。

示例：

```
username_custom_zone_us
```

表示使用美国地区 IP。

常见国家代码：

| 国家   | 参数   |
| ---- | ---- |
| 美国   | `us` |
| 英国   | `gb` |
| 加拿大  | `ca` |
| 德国   | `de` |
| 法国   | `fr` |
| 日本   | `jp` |
| 韩国   | `kr` |
| 澳大利亚 | `au` |

完整国家列表请参考：

《[国家地区参数说明](/kai-fa-zhe-wen-dang/api-shi-yong-zhi-nan/guo-jia-di-qu-can-shu-shuo-ming.md)》

***

## 四、Session 参数

Session 用于保持代理 IP 稳定。

格式：

```
username_zone_country_session_xxxxx
```

示例：

```
username_custom_zone_us_session_123456
```

参数说明：

| 参数      | 说明             |
| ------- | -------------- |
| session | 会话标识           |
| 123456  | 自定义 Session ID |

使用相同 Session 时，请求会尽可能保持同一个住宅 IP。

适用于：

* 账号登录
* 长时间访问
* 连续业务操作
* 需要稳定 IP 的场景

详细说明：

《[Session 使用说明](/kai-fa-zhe-wen-dang/api-shi-yong-zhi-nan/session-shi-yong-shuo-ming.md)》

***

## 五、城市与地区参数

部分代理场景支持指定更精确的位置。

示例：

```
username_custom_zone_us_city_newyork
```

参数：

| 参数    | 示例         | 说明    |
| ----- | ---------- | ----- |
| city  | newyork    | 指定城市  |
| state | california | 指定州/省 |

实际可用地区取决于 IPWO 代理资源。

***

## 六、代理协议参数

IPWO 支持：

| 协议     | 使用场景               |
| ------ | ------------------ |
| HTTP   | 常规网页访问、API 请求、数据采集 |
| HTTPS  | HTTPS 网站访问         |
| SOCKS5 | 更灵活的网络连接场景         |

示例：

HTTP：

```
http://us.ipwo.net:7878
```

SOCKS5：

```
socks5://us.ipwo.net:7878
```

***

## 七、请求参数建议

| 参数              | 推荐设置    | 说明        |
| --------------- | ------- | --------- |
| Timeout         | 10-30 秒 | 避免请求长时间等待 |
| Retry           | 开启      | 提高请求成功率   |
| Connection Pool | 开启      | 提高多请求效率   |
| Session         | 按需设置    | 保持 IP 稳定  |

***

## 八、常用配置示例

### 美国动态住宅代理

```
Host:
us.ipwo.net

Port:
7878

Username:
username_custom_zone_us

Password:
password
```

***

### 美国固定 Session

```
Username:

username_custom_zone_us_session_123456
```

***

## 九、参数选择建议

根据不同业务场景，可以参考以下配置：

| 使用场景   | 推荐配置            |
| ------ | --------------- |
| 数据采集   | 动态住宅代理 + 多地区 IP |
| 账号登录   | 固定 Session      |
| 广告验证   | 指定国家地区          |
| SEO 监控 | 指定国家/城市         |
| API 调用 | HTTP 代理         |

***

## 十、相关文档

* [代理参数说明](/kai-fa-zhe-wen-dang/api-shi-yong-zhi-nan/dai-li-can-shu-shuo-ming.md)
* [国家地区参数说明](/kai-fa-zhe-wen-dang/api-shi-yong-zhi-nan/guo-jia-di-qu-can-shu-shuo-ming.md)
* [Session 使用说明](/kai-fa-zhe-wen-dang/api-shi-yong-zhi-nan/session-shi-yong-shuo-ming.md)
* [请求最佳实践](/kai-fa-zhe-wen-dang/api-shi-yong-zhi-nan/qing-qiu-zui-jia-shi-jian.md)
* [认证方式说明](/kai-fa-zhe-wen-dang/api-shi-yong-zhi-nan/ren-zheng-fang-shi-shuo-ming.md)
* [代码示例](/kai-fa-zhe-wen-dang/dai-ma-shi-li.md)
* [常见错误](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu.md)