> 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/gu-zhang-pai-chu.md).

# 故障排除

在使用代理过程中遇到问题时，可以通过本页面快速定位并解决。

👉 建议优先使用「快速自检」，再根据问题类型排查

***

### 🔍 我遇到的问题是：

* 无法连接代理
* 认证失败（407）
* IP 未变化 / 不正确
* IP 频繁变化
* 工具（浏览器 ）无法使用

👇 点击或向下查看对应解决方案

***

### ⚡ 快速自检（强烈推荐）

请先使用以下命令测试代理是否正常：

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

#### 判断结果：

* ✅ 返回 IP 信息 → 代理正常
* ❌ 无返回 / 报错 → 请继续排查

***

### 🔌 无法连接代理

#### 表现

* 请求超时
* 无法建立连接

#### 解决方法

* 检查 Host / Port 是否正确
* 确认代理服务已开通
* 检查本地网络或服务器网络
* 确认代理协议是否匹配（HTTP / SOCKS5）

***

### 🔐 认证失败（407）

#### 表现

* 返回：407 Proxy Authentication Required

#### 解决方法

* 检查用户名和密码是否正确
* 确认格式为：

```
username:password
```

* 检查用户名参数是否拼写正确

***

### 🌍 IP 未变化 / 地区不正确

#### 表现

* IP 与本机相同
* IP 未切换
* 地区不符合预期

#### 解决方法

* 确认请求已正确走代理
* 检查是否使用固定 `sid`（会导致 IP 不变）
* 检查地区参数（国家 / 城市）
* 使用 [https://ipinfo.io](https://ipinfo.io/) 进行验证

***

### 🔄 IP 频繁变化（不稳定）

#### 表现

* 每次请求 IP 不一致
* 登录状态无法保持

#### 解决方法

* 检查是否未设置 `sid`
* 使用粘性 IP（设置 `sid + time`）

***

### ⚙️ 工具无法使用（浏览器 / AdsPower）

#### 表现

* 代理检测失败
* 浏览器无法打开网页

#### 解决方法

* 检查代理类型是否正确（HTTP / SOCKS5）
* 确认代理信息填写完整
* 建议先使用 cURL 测试代理
* 检查是否存在系统代理冲突

***

### 🌐 API 无法访问

#### 表现

* API 请求失败
* 无返回或报错

#### 解决方法

* 检查是否已配置 IP 白名单
* 确认服务器 IP 是否在白名单中
* 检查 API 参数是否正确

***

### ❗ 常见问题速查表

| 问题      | 常见原因           |
| ------- | -------------- |
| 无法连接    | Host / Port 错误 |
| 407 错误  | 账号密码错误         |
| IP 不变   | 使用了 sid        |
| IP 频繁变化 | 未设置 sid        |
| API 失败  | 未配置白名单         |

***

### 💡 使用建议

* 优先进行「[快速自检](#kuai-su-zi-jian-qiang-lie-tui-jian)」
* 参数建议逐步添加（避免配置错误）
* 建议在稳定网络环境中使用代理

***

### 🆘 仍未解决？

如果以上方法未能解决问题，请联系官方**在线客服**。

👉 建议提供以下信息：

* 使用的代理类型
* 请求方式（代码 / 工具）
* 错误提示截图

***

### 总结

排查问题的核心流程：

```
快速验证 → 检查连接 → 检查认证 → 检查参数
```

👉 按顺序排查，大多数问题都可以快速解决

***