> 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/huan-jing-zhun-bei/kai-fa-qian-jian-cha-qing-dan.md).

# 开发前检查清单

在将 IPWO 代理集成到项目之前，建议先完成以下检查，避免因配置或网络问题导致开发过程中出现连接失败、认证错误或请求超时等问题。

***

### 一、确认代理套餐已开通

请确认：

* 已注册 IPWO 账号
* 已购买代理套餐
* 套餐状态正常
* 账户余额充足

***

### 二、获取代理信息

在用户中心获取代理连接信息：

```
Host:
us.ipwo.net

Port:
7878

Username:
username_custom_zone_us

Password:
password
```

请妥善保存账号信息，避免配置错误。

***

### 三、确认已创建 Zone

大部分代理配置都依赖 Zone 参数。

请确认：

* 已成功创建 Zone
* 用户名中包含正确的 Zone 名称
* 国家地区参数符合业务需求

例如：

```
username_custom_zone_us
```

***

### 四、确认网络环境

IPWO 住宅代理建议在海外网络环境下使用。

推荐：

* 海外 VPS
* 海外云服务器
* 海外独立服务器

如遇连接异常，请优先检查网络环境。

***

### 五、测试代理连通性

建议先使用 curl 测试：

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

如果返回 IP 信息，说明代理连接正常。

***

### 六、验证代理是否生效

访问：

```
http://ipinfo.io
```

检查：

* IP 是否已变化
* 国家地区是否正确

***

### 七、确认开发环境

根据项目语言准备对应依赖：

| 语言                                                       | 推荐库                    |
| -------------------------------------------------------- | ---------------------- |
| [Python](/kai-fa-zhe-wen-dang/dai-ma-shi-li/python.md)   | requests、httpx、aiohttp |
| [Node.js](/kai-fa-zhe-wen-dang/dai-ma-shi-li/node.js.md) | axios、fetch            |
| [Go](/kai-fa-zhe-wen-dang/dai-ma-shi-li/go.md)           | net/http               |
| [Java](/kai-fa-zhe-wen-dang/dai-ma-shi-li/java.md)       | HttpURLConnection      |
| [PHP](/kai-fa-zhe-wen-dang/dai-ma-shi-li/php.md)         | cURL                   |
| [C#](/kai-fa-zhe-wen-dang/dai-ma-shi-li/c.md)            | HttpClient             |
| [Rust](/kai-fa-zhe-wen-dang/dai-ma-shi-li/rust.md)       | reqwest                |

***

### 八、排查常见问题

开始开发前，建议了解以下常见错误：

* [407 Proxy Authentication Required](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/407-proxy-authentication-required.md)
* [Timeout](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/chao-shi-timeout.md)
* [Connection Reset](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/connection-reset.md)
* [DNS 解析失败](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/dns-jie-xi-shi-bai.md)
* [SSL 证书错误](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/ssl-zheng-shu-cuo-wu.md)

出现问题时可以快速定位原因。

***

### 相关文章

* [海外网络要求](/kai-fa-zhe-wen-dang/huan-jing-zhun-bei/hai-wai-wang-luo-yao-qiu.md)
* [获取代理信息](/kai-fa-zhe-wen-dang/kuai-su-kai-shi/huo-qu-dai-li-xin-xi.md)
* [如何检测代理是否生效](/dai-li-jian-ce-yu-yin-si-an-quan/ru-he-jian-ce-dai-li-shi-fou-sheng-xiao.md)
* [cURL](/kai-fa-zhe-wen-dang/dai-ma-shi-li/curl-dai-ma-shi-li.md)
* [407 Proxy Authentication Required](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/407-proxy-authentication-required.md)
* [如何快速定位问题](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/ru-he-kuai-su-ding-wei-wen-ti.md)

> 建议先完成 curl 测试，再集成到代码或浏览器环境中，可大幅减少排查时间。