> 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/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/dai-li-lian-jie-shi-bai.md).

# 代理连接失败

如果出现以下情况：

```
Proxy connection failed
Failed to connect to proxy
Could not connect to proxy server
```

通常表示：

```
客户端无法与代理服务器建立连接
```

这是最基础但也最常见的代理错误之一。

***

### 一、常见原因

#### 1. 代理地址或端口错误

请检查：

* Host 是否正确
* 端口是否正确
* 是否写错协议

***

#### 正确示例

```bash
curl -x http://us.ipwo.net:7878 -U username_custom_zone_us:password http://ipinfo.io
```

***

#### 2. 网络无法访问代理服务器

常见于：

* 国内网络限制
* 公司网络防火墙
* VPS 出口限制

***

#### 3. 代理协议不匹配

例如：

* HTTP 代理用 SOCKS5 写法
* SOCKS5 用 HTTP 写法

***

#### 4. [白名单未配置或未生效](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/bai-ming-dan-bu-sheng-xiao.md)

如果使用白名单模式：

```
当前 IP 未加入白名单
```

***

#### 5.[ DNS 解析失败](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/dns-jie-xi-shi-bai.md)

可能导致：

```
无法解析 us.ipwo.net
```

***

### 二、常见错误示例

#### cURL

```
curl: (7) Failed to connect to us.ipwo.net port 7878
```

***

#### Python

```python
requests.exceptions.ProxyError
```

***

#### Node.js

```
ECONNREFUSED
```

***

### 三、推荐排查方式

#### 1. curl 基础测试

```bash
curl -v -x http://us.ipwo.net:7878 -U username_custom_zone_us:password http://ipinfo.io
```

***

#### 2. 检查 DNS 是否正常

```bash
nslookup us.ipwo.net
```

***

#### 3. 更换网络环境

建议测试：

* 手机热点
* 海外 VPS
* 不同网络

***

#### 4. 检查白名单

确认当前公网 IP 是否已添加。

***

### 四、推荐解决方案

建议：

* 使用稳定网络环境（海外 VPS）
* 确认代理账号正确
* 使用 curl 先验证
* 检查 DNS 与端口

***

### 五、推荐排查流程

```
1. 检查代理账号
↓
2. 检查 Host / Port
↓
3. curl 测试连接
↓
4. 检查 DNS
↓
5. 检查白名单
↓
6. 更换网络测试
```

***

### 六、相关文章

* [407 Proxy Authentication Required](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/407-proxy-authentication-required.md)
* [超时 Timeout](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/chao-shi-timeout.md)
* [DNS 解析失败](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/dns-jie-xi-shi-bai.md)
* [IP 不生效](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/ip-bu-sheng-xiao.md)
* [白名单不生效](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/bai-ming-dan-bu-sheng-xiao.md)
* [如何检测代理是否生效](/dai-li-jian-ce-yu-yin-si-an-quan/ru-he-jian-ce-dai-li-shi-fou-sheng-xiao.md)
* [HTTP 与 SOCKS5 区别](/dai-li-ji-chu-zhi-shi/http-yu-socks5-qu-bie.md)