> 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 测试，再集成到代码或浏览器环境中，可大幅减少排查时间。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ipwo.net/kai-fa-zhe-wen-dang/huan-jing-zhun-bei/kai-fa-qian-jian-cha-qing-dan.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.