Ubuntu22.04容器中pip安装包遇SSLCertVerificationError问题求助
2026-7-30
解决Docker容器内pip SSL证书验证失败问题
可行的解决步骤
1. 配置pip全局信任主机
无需每次安装都附加参数，直接在容器内创建pip全局配置：
- 创建配置目录：
mkdir -p ~/.config/pip - 创建并编辑配置文件：
nano ~/.config/pip/pip.conf - 写入以下内容并保存：
[global] trusted-host = pypi.org pypi.python.org files.pythonhosted.org
完成后重新尝试pip安装操作。
2. 更新容器内系统证书
Ubuntu容器可能缺失根证书，执行以下命令更新证书库：
apt update && apt install -y ca-certificates update-ca-certificates
更新完成后再次运行pip安装命令。
3. 切换至国内pip镜像源
使用国内镜像源绕过SSL验证问题，例如阿里云镜像：
- 单次安装指定源：
pip install <package> -i https://mirrors.aliyun.com/pypi/simple/ - 配置全局使用国内源：在上述
pip.conf中替换内容为：
[global] index-url = https://mirrors.aliyun.com/pypi/simple/ trusted-host = mirrors.aliyun.com
4. 排查MacOS代理影响
若MacOS开启了全局代理，Docker容器可能继承代理设置导致证书问题：
- 关闭MacOS的代理服务，重启Docker容器后重试安装。
- 或在容器内直接清除代理环境变量：
unset HTTP_PROXY HTTPS_PROXY http_proxy https_proxy，执行后再运行pip命令。
内容的提问来源于stack exchange，提问作者Pedro Tavares
相关产品推荐
相关产品推荐
