> 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/readme.md).
# 快速开始
本教程介绍如何在 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)（推荐）
#### 一步测试
请将以下内容替换为你的代理信息：
```
curl -x "host:port" -U "username:password" https://ipinfo.io
```
#### 📌 示例
```
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）
```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)」，再接入业务环境
可以避免：
* 配置错误
* 环境不支持
* 业务直接失败