> 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/ji-cheng-jiao-cheng/gong-ju-yu-dai-li-ruan-jian/ru-he-shi-yong-curl-pei-zhi-ipwo-dai-li.md).

# 如何使用 cURL 配置 IPWO 代理

cURL 是一款常用的命令行网络请求工具，支持 HTTP、HTTPS、FTP 等多种协议，广泛应用于接口测试、网络调试、自动化脚本和开发验证。使用 cURL 可以快速验证 IPWO 代理是否配置成功，也是官方推荐的代理连通性测试方式之一。

***

### 一、准备工作

开始配置前，请确保已完成以下准备：

* 已开通[ IPWO 动态住宅代理](/huo-qu-yu-pei-zhi-dai-li/ru-he-huo-qu-dai-li.md)
* 已创建 Zone
* 已获取代理用户名、密码和代理地址
* 本地环境支持 cURL（Windows 10/11、macOS 和大多数 Linux 发行版通常已默认安装）

可以执行以下命令检查是否可用：

```
curl --version
```

如果能够输出版本信息，例如：

```
curl 8.x.x
```

说明 cURL 已可以正常使用。

如果提示：

```
curl: command not found
```

则需要根据当前操作系统安装 cURL。

***

### 二、使用 HTTP 代理

使用 `-x` 参数指定代理服务器，使用 `-U` 参数传入代理认证信息。

示例：

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

参数说明：

| 参数                        | 说明           |
| ------------------------- | ------------ |
| `-x`                      | 指定代理服务器地址    |
| `-U`                      | 指定代理用户名和密码   |
| `us.ipwo.net:7878`        | IPWO 代理服务器地址 |
| `username_custom_zone_us` | 代理用户名        |
| `password`                | 代理密码         |

请根据自己的账户信息替换用户名、密码和 Zone。

***

### 三、使用 SOCKS5 代理

如果需要使用 SOCKS5 协议，可以执行：

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

请根据实际购买的代理协议选择对应的连接方式。

***

### 四、测试代理是否生效

建议访问 IP 检测接口验证代理是否生效：

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

正常情况下会返回类似结果：

```json
{
  "ip": "203.0.113.10",
  "country": "US"
}
```

如果返回的公网 IP 已发生变化，并且国家地区符合配置，则说明代理已经配置成功。

***

### 五、查看详细请求信息

如果需要排查连接问题，可以增加 `-v` 参数查看详细日志。

示例：

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

详细日志可以帮助定位：

* 是否成功连接代理服务器
* 是否完成代理认证
* 请求是否正常发送
* 返回状态码是否正确

***

### 六、设置请求超时时间

建议为请求设置合理的超时时间，避免因网络波动导致程序长时间等待。

例如：

```bash
curl \
-x http://us.ipwo.net:7878 \
-U username_custom_zone_us:password \
--connect-timeout 10 \
--max-time 30 \
https://ipinfo.io/json
```

参数说明：

| 参数                  | 说明            |
| ------------------- | ------------- |
| `--connect-timeout` | 建立连接超时时间（秒）   |
| `--max-time`        | 整个请求最大执行时间（秒） |

***

### 七、常见问题

### [返回 407](/gu-zhang-pai-chu/dai-li-407-cuo-wu.md) Proxy Authentication Required

请检查：

* 用户名是否正确
* 密码是否正确
* Zone 是否配置正确

***

#### [请求超时（Timeout）](/gu-zhang-pai-chu/chao-shi-timeout.md)

请检查：

* 当前网络是否能够访问代理节点
* 网络连接是否稳定
* 超时时间设置是否过短

***

#### 返回的 IP 未变化

请确认：

* 是否正确使用 `-x` 参数指定代理
* 是否正确使用 `-U` 参数进行认证
* 用户名和密码是否填写正确

***

#### 国家地区不正确

请检查：

* Zone 是否配置正确
* 是否使用了对应国家的代理入口
* 用户名中的国家参数是否填写正确

***

### 八、使用建议

为了获得更稳定的使用体验，建议：

* 首次接入时优先使用 cURL 验证代理连通性
* 登录或长期会话业务建议使用固定 Session
* 根据目标业务选择对应国家地区
* 控制请求频率，避免短时间大量请求
* 在正式开发前，先确认代理能够正常返回目标国家 IP

***

### 九、相关文章

* [如何为 Python Requests 设置 IPWO 代理](/ji-cheng-jiao-cheng/gong-ju-yu-dai-li-ruan-jian/ru-he-wei-python-requests-she-zhi-ipwo-dai-li.md)
* [如何为 Scrapy 设置 IPWO 代理](/ji-cheng-jiao-cheng/gong-ju-yu-dai-li-ruan-jian/ru-he-wei-scrapy-she-zhi-ipwo-dai-li.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/guo-jia-di-qu-can-shu-shuo-ming.md)
* [请求最佳实践](/kai-fa-zhe-wen-dang/api-shi-yong-zhi-nan/qing-qiu-zui-jia-shi-jian.md)
* [API 调用与批量采集](/dai-li-ji-chu-zhi-shi/api-diao-yong-yu-pi-liang-cai-ji.md)
* [如何检测代理是否生效](/dai-li-jian-ce-yu-yin-si-an-quan/ru-he-jian-ce-dai-li-shi-fou-sheng-xiao.md)