当前位置：首页 > article >正文

解决 `pip is configured with locations that require TLS/SSL` 错误

article 2025/2/21 17:56:29

在使用 pip 安装 Python 包时，可能会遇到以下错误：

WARNING: pip is configured with locations that require TLS/SSL, however the ssl module in Python is not available.

这意味着 Python 的 ssl 模块未正确安装或配置，导致 pip 无法通过 HTTPS 连接 PyPI（Python Package Index）。

Python 编译时未启用 SSL 支持：
- 在编译 Python 时，如果未正确链接 OpenSSL 库，会导致 ssl 模块不可用。
系统缺少 OpenSSL 开发包：
- 编译 Python 需要 OpenSSL 的开发包（如 libssl-dev 或 openssl-devel），如果未安装，会导致 SSL 支持缺失。

安装 OpenSSL 开发包：

对于 Ubuntu/Debian：

sudo apt update
sudo apt install libssl-dev

重新编译 Python：

下载 Python 源码：

wget https://www.python.org/ftp/python/3.10.12/Python-3.10.12.tgz
tar -zxvf Python-3.10.12.tgz
cd Python-3.10.12

配置并编译：

./configure --enable-optimizations --with-openssl=/usr
make
sudo make install

验证 SSL 模块：
- 运行以下命令检查 ssl 模块是否可用：
```
python3 -c "import ssl; print(ssl.OPENSSL_VERSION)"
```
- 如果输出了 OpenSSL 版本（如 OpenSSL 1.1.1），则说明 SSL 支持已启用。

如果无法重新编译 Python，可以通过配置 pip 使用 HTTP 镜像源来绕过 HTTPS 限制。

创建 pip 配置文件：
- 在用户主目录下创建 .pip 目录和 pip.conf 文件：
```
mkdir -p ~/.pip
vim ~/.pip/pip.conf
```
配置 HTTP 镜像源：
- 在 pip.conf 文件中添加以下内容：
```
[global]
index-url = http://mirrors.aliyun.com/pypi/simple/

[install]
trusted-host = mirrors.aliyun.com
```
- 这里使用了阿里云的 PyPI 镜像源，您也可以选择其他镜像源（如清华源）。
使用 pip 安装包：
- 现在可以正常使用 pip 安装包了：
```
pip install <package-name>
```

如果系统 OpenSSL 环境有问题（如路径错误或版本不兼容），可以尝试以下步骤：

检查 OpenSSL 版本：
- 运行以下命令检查 OpenSSL 版本：
```
openssl version
```
修复 OpenSSL 路径：
- 如果 OpenSSL 安装在非标准路径（如 /usr/local/openssl），需要在编译 Python 时指定路径：
```
./configure --with-openssl=/usr/local/openssl
```
更新系统 OpenSSL：
- 如果 OpenSSL 版本过旧，可以升级到最新版本：
  - 对于 Ubuntu/Debian：
```
sudo apt update
sudo apt install --only-upgrade openssl
```
  - 对于 CentOS/RHEL：
```
sudo yum update openssl
```