# 快速开始

本教程介绍如何在 3 分钟内完成 [IPWO 住宅代理](https://www.ipwo.net/)的接入，支持 HTTP 和 SOCKS5 协议，适用于 Python 爬虫、[Selenium](/ji-cheng-jiao-cheng/gong-ju-yu-dai-li-ruan-jian/ru-he-zai-selenium-zhong-shi-yong-ipwo-dai-li.md)、[Playwright ](/ji-cheng-jiao-cheng/gong-ju-yu-dai-li-ruan-jian/ru-he-zai-playwright-zhong-shi-yong-ipwo-dai-li.md)及跨境业务场景。

***

## 🎁 第一步：注册账号并[领取免费试用](/readme/ling-qu-mian-fei-shi-yong.md)（强烈推荐）

首次使用建议先注册账号并领取免费流量测试。

### ✔ 注册流程

1. 访问官网并[注册账号](https://www.ipwo.net/user/register)
2. 登录用户中心
3. 完成[实名认证](/readme/shi-ming-ren-zheng-shuo-ming.md)（用于合规校验）
4. 自动[领取免费试用](/readme/ling-qu-mian-fei-shi-yong.md)流量包

***

### 🎁 免费试用内容（新用户福利）

完成实名认证后即可获得：

* 👤 [个人认证](/readme/shi-ming-ren-zheng-shuo-ming/ge-ren-ren-zheng.md)：赠送 **0.5GB 免费流量**
* 🏢 [企业认证](/readme/shi-ming-ren-zheng-shuo-ming/qi-ye-ren-zheng.md)：赠送 **1GB 免费流量**

👉 可直接用于测试所有代理功能

***

### ⚠️ 重要说明

* 实名认证仅用于合规审核
* 不会对外泄露或用于其他用途
* 认证通过后自动开通试用权限

***

## 🚀 第二步：[获取代理信息](/huo-qu-yu-pei-zhi-dai-li/ru-he-huo-qu-dai-li.md)

进入：

```
用户中心 → 代理产品 → 动态住宅代理 / 静态住宅代理
```

你可以获得代理信息

👉请参考：

* 「[如何获取代理](https://docs.ipwo.net/huo-qu-yu-pei-zhi-dai-li/ru-he-huo-qu-dai-li)」→ 获取完整代理信息
* 「[用户名 & 密码认证](https://docs.ipwo.net/huo-qu-yu-pei-zhi-dai-li/ru-he-huo-qu-dai-li/yong-hu-ming-he-mi-ma-ren-zheng)」→ 查看账密使用方式

例如：

```
Host：us.ipwo.netPort：7878Username：xxx_custom_zone_USPassword：xxxxxx
```

***

## ⚡ 第三步：[快速验证](/kai-fa-zhe-wen-dang/kuai-su-kai-shi/kuai-su-yan-zheng.md)（推荐）

#### 一步测试 <a href="#yi-bu-ce-shi" id="yi-bu-ce-shi"></a>

请将以下内容替换为你的代理信息：

```
curl -x "host:port" -U "username:password" https://ipinfo.io
```

#### 📌 示例 <a href="#shi-li" id="shi-li"></a>

```
curl -x "us.ipwo.net:7878" -U "username:password" https://ipinfo.io
```

### ✔ 成功返回示例

```
203.0.113.10
```

👉 表示代理已生效

***

## 🌍 第四步：选择使用方式

***

### 🖥 浏览器用户（推荐新手）

适用于：

* [AdsPower](/ji-cheng-jiao-cheng/zhi-wen-liu-lan-qi/adspower-liu-lan-qi-ji-cheng-zhi-nan.md)
* Chrome
* [指纹浏览器](/ji-cheng-jiao-cheng/zhi-wen-liu-lan-qi.md)

👉 只需填写代理信息即可使用

***

### 💻 开发者（[代码接入](/kai-fa-zhe-wen-dang/dai-ma-shi-li.md)）

#### Python 示例（requests） <a href="#python-shi-li-requests" id="python-shi-li-requests"></a>

```python
import requests
if __name__ == '__main__':
proxyip = "http://username_custom_zone_US:password@us.ipwo.net:7878"
url = "http://ipinfo.io"
proxies = {
'http': proxyip,
}
data = requests.get(url=url, proxies=proxies)
print(data.text)
```

***

## 🔄 第五步：选择代理模式

***

### 🔁 [轮换 IP](/huo-qu-yu-pei-zhi-dai-li/lun-huan-ip.md)（适合数据业务）

* 每次请求自动更换 IP
* 适合高频访问
* 降低封禁风险

适用：

```
数据采集 / SEO监控 / AI数据训练
```

***

### 📌 [粘性 IP](/huo-qu-yu-pei-zhi-dai-li/nian-xing-ip.md)（适合账号业务）

* IP 在一定时间内保持不变
* 更稳定
* 更适合登录环境

适用：

```
TikTok / Facebook / Amazon / 多账号运营
```

***

## 🌍 第六步：[选择国家地区](/huo-qu-yu-pei-zhi-dai-li/can-shu-shuo-ming/guo-jia-cheng-shi-she-zhi.md)

通过用户名控制国家：

```
US → 美国JP → 日本GB → 英国
```

示例：

```
username_custom_zone_US
```

👉 获取美国 IP

***

## ⚠️ 常见问题（必看）

***

### ❓ 为什么无法连接代理？

可能原因：

* 未使用海外网络环境
* 用户名或密码错误
* Host / Port 填写错误

***

### ❓ 为什么 IP 没变化？

可能原因：

* 使用了粘性会话
* session 未更新
* 网站缓存影响

***

## 🧭 一句话总结流程

```
注册账号→ 实名认证领取免费流量→ 获取代理信息→ curl测试→ 正式接入业务
```

***

## 🚀 最重要建议

👉 新用户一定先做「[免费试用](#mian-fei-shi-yong-nei-rong-xin-yong-hu-fu-li) + [curl测试](#di-san-bu-kuai-su-yan-zheng-tui-jian)」，再接入业务环境

可以避免：

* 配置错误
* 环境不支持
* 业务直接失败


---

# Agent Instructions: 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:

```
GET https://docs.ipwo.net/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
