> 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/dai-li-lian-jie-shi-bai.md).

# 代理连接失败

如果在使用代理时出现无法连接、请求超时、无法访问网站等情况，可以按照以下步骤进行排查。

👉 建议优先使用「快速验证」确认代理是否正常

***

### 🔍 常见表现

出现以下情况时，通常属于代理连接失败：

* 请求超时
* 无法建立连接
* 浏览器无法打开网页
* 工具检测代理失败
* cURL 返回连接错误

***

### ⚡ 快速验证（推荐）

请先使用以下命令测试代理：

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

***

#### 判断结果

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

***

### 🛠 排查步骤

#### 1️⃣ 检查代理信息是否正确

请确认以下信息填写无误：

```
Host（代理地址）
Port（端口）
Username（用户名）
Password（密码）
```

👉 建议直接复制粘贴，避免手动输入错误

***

#### 2️⃣ 检查代理协议

IPWO 支持：

* HTTP
* HTTPS
* SOCKS5

👉 请确认工具中的代理类型与实际使用一致

***

#### 3️⃣ 检查网络环境

请确认当前网络环境正常：

* 本地网络可正常访问外网
* 服务器未限制代理连接
* 防火墙未拦截端口

***

#### 4️⃣ 检查代理是否已开通

请确认：

* 已购买对应代理产品
* 当前套餐未过期
* 流量余额充足

👉 可在用户中心查看状态

***

#### 5️⃣ 检查工具配置

如果在浏览器或工具中无法使用：

* 确认代理已保存成功
* 检查是否存在系统代理冲突
* 建议先使用 cURL 测试再接入工具

***

### ❗ 常见原因汇总

| 问题     | 可能原因           |
| ------ | -------------- |
| 无法连接   | Host / Port 错误 |
| 请求超时   | 网络不稳定          |
| 检测失败   | 代理类型错误         |
| 无法访问网站 | 代理未生效          |
| 工具不可用  | 配置不完整          |

***

### 💡 使用建议

* 建议优先使用「[快速验证](#kuai-su-yan-zheng-tui-jian)」测试
* 首次使用时不要添加复杂参数
* 推荐先使用 HTTP 协议测试

***

### 🆘 仍未解决？

如果问题仍未解决，请联系官方客服（官网右侧在线客服）。

👉 建议提供以下信息：

* 使用的代理类型
* 使用的工具或代码
* 错误提示截图
* 测试命令结果

***

### 总结

代理连接失败通常由以下原因导致：

```
代理信息错误
↓
协议不匹配
↓
网络限制
↓
工具配置问题
```

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

***