> 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/zai-xian-ce-shi-dai-li.md).

# 在线测试代理

在线测试代理功能可以帮助开发者快速验证 IPWO 代理是否正常工作，无需编写代码即可检查代理连接状态、出口 IP、国家地区等信息。

在正式集成到业务系统前，建议先通过在线测试确认：

* 代理账号是否有效
* 用户名和密码是否正确
* 代理连接是否正常
* IP 地区是否符合预期
* Session 配置是否生效

***

### 一、测试前准备

开始测试前，请准备以下信息：

| 参数   | 示例                        | 说明           |
| ---- | ------------------------- | ------------ |
| 代理地址 | `us.ipwo.net`             | IPWO 代理服务器地址 |
| 代理端口 | `7878`                    | 代理连接端口       |
| 用户名  | `username_custom_zone_us` | 代理认证用户名      |
| 密码   | `password`                | 代理认证密码       |

如果还未获取代理信息，请先完成：

1. 注册 IPWO 账号
2. 购买代理套餐
3. 创建代理 Zone
4. 获取代理认证信息

***

### 二、开始测试代理

进入在线测试代理页面。

填写代理信息：

```
代理协议：
HTTP / SOCKS5

代理地址：
us.ipwo.net

端口：
7878

用户名：
username_custom_zone_us

密码：
password
```

点击：

```
测试代理
```

系统会自动发送测试请求，并返回代理连接结果。

***

### 三、测试结果说明

测试成功后，通常会返回以下信息：

| 信息            | 说明      |
| ------------- | ------- |
| Proxy Status  | 代理连接状态  |
| IP Address    | 当前出口 IP |
| Country       | IP 所属国家 |
| Region        | IP 所属地区 |
| ISP / ASN     | 网络运营商信息 |
| Response Time | 请求响应时间  |

示例：

```json
{
  "status": "success",
  "ip": "203.0.113.10",
  "country": "US",
  "response_time": "1.2s"
}
```

***

### 四、验证 Session 是否生效

如果使用 Session 功能，可以通过多次测试确认 IP 是否保持稳定。

示例用户名：

```
username_custom_zone_us_session_123456
```

测试方法：

1. 使用相同 Session 发起多次请求
2. 对比返回 IP

如果 IP 保持一致或在有效时间内保持稳定，说明 Session 配置正常。

更多内容请参考：

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

***

### 五、测试代理代码示例

如果在线测试成功，可以直接参考代码示例进行开发。

#### Python Requests

```python
import requests

proxy = "http://username_custom_zone_us:password@us.ipwo.net:7878"

proxies = {
    "http": proxy,
    "https": proxy
}

response = requests.get(
    "https://ipinfo.io/json",
    proxies=proxies,
    timeout=15
)

print(response.text)
```

***

#### cURL

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

***

### 六、常见测试失败原因

#### 1. 代理认证失败

错误表现：

```
407 Proxy Authentication Required
```

可能原因：

* 用户名错误
* 密码错误
* Zone 不存在
* 代理套餐已过期

解决方法：

* 检查代理认证信息
* 重新复制用户名和密码
* 确认账户状态

***

#### 2. 连接超时

错误表现：

```
Connection Timeout
```

可能原因：

* 当前网络无法连接代理节点
* 请求等待时间过短
* 网络不稳定

解决方法：

* 检查代理地址和端口
* 增加 timeout 时间
* 更换代理节点测试

***

#### 3. IP 地区不正确

可能原因：

* 国家参数设置错误
* 使用了错误 Zone
* Session 缓存旧 IP

解决方法：

* 检查国家地区参数
* 创建新的 Session
* 确认代理配置

***

### 七、开发调试建议

在正式业务接入前，建议按照以下流程测试：

```
1. 在线测试代理连接
        ↓
2. 确认出口 IP
        ↓
3. 验证国家地区
        ↓
4. 测试 Session
        ↓
5. 接入业务代码
```

这样可以快速定位代理配置问题，减少开发调试时间。

***

### 八、相关文档

* [参数速查表](/kai-fa-zhe-wen-dang/api-shi-yong-zhi-nan/can-shu-su-cha-biao.md)
* [代理参数说明](/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/ren-zheng-fang-shi-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/chang-jian-cuo-wu.md)
* [请求最佳实践](/kai-fa-zhe-wen-dang/api-shi-yong-zhi-nan/qing-qiu-zui-jia-shi-jian.md)