> 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)」
* 参数建议逐步添加（避免配置错误）
* 建议在稳定网络环境中使用代理

***

### 🆘 仍未解决？

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

👉 建议提供以下信息：

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

***

### 总结

排查问题的核心流程：

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

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

***


---

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

```
GET https://docs.ipwo.net/gu-zhang-pai-chu.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.