> 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/ssl-zheng-shu-cuo-wu.md).

# SSL 证书错误

如果出现：

```
SSL certificate verify failed
SSL Error
CERTIFICATE_VERIFY_FAILED
```

通常表示：

```
HTTPS 证书校验失败
```

这是开发者使用代理或请求 HTTPS 网站时的常见问题。

***

### 一、常见原因

#### 1. 本地证书环境异常

例如：

* 系统证书缺失
* Python CA 证书异常
* OpenSSL 版本过旧

***

#### 2. 网络环境问题

部分国内网络环境可能导致：

```
HTTPS 握手异常
```

建议优先使用：

* 海外 VPS
* 海外云服务器

***

#### 3. HTTPS 请求被拦截

可能出现：

* 防火墙拦截
* 中间代理干扰
* SSL 握手失败

***

#### 4. 目标网站证书异常

部分网站：

```
证书配置不完整
```

可能导致验证失败。

***

### 二、常见报错示例

#### cURL

```bash
curl: (60) SSL certificate problem
```

***

#### Python requests

```python
SSLError: CERTIFICATE_VERIFY_FAILED
```

***

### 三、推荐排查方式

#### 1. 先测试代理是否正常

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

***

#### 2. 临时关闭 SSL 验证（仅测试）

**cURL**

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

***

**Python**

```python
requests.get(url, verify=False)
```

***

#### ⚠️ 注意

```
仅建议调试测试使用
```

生产环境不建议长期关闭 SSL 验证。

***

### 四、推荐解决方案

推荐：

* 更新系统证书
* 更新 OpenSSL
* 使用海外 VPS
* 更换 DNS

避免：

* 老旧 Python 环境
* 国内网络直接高频请求海外 HTTPS 网站

***

### 五、推荐排查流程

```
1. curl 测试代理
↓
2. 测试 HTTPS 请求
↓
3. 临时关闭 SSL 验证
↓
4. 更新证书环境
↓
5. 再次测试
```

***

### 六、相关文章

* [超时 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)
* [代理连接失败](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/dai-li-lian-jie-shi-bai.md)
* [如何检测代理是否生效](/dai-li-jian-ce-yu-yin-si-an-quan/ru-he-jian-ce-dai-li-shi-fou-sheng-xiao.md)
* [API 调用与批量采集](/dai-li-ji-chu-zhi-shi/api-diao-yong-yu-pi-liang-cai-ji.md)
* [为什么需要海外网络环境](/dai-li-ji-chu-zhi-shi/wei-shen-me-xu-yao-hai-wai-wang-luo-huan-jing.md)