0

0

Git怎么解决SSL证书验证失败_Git如何处理clone时的HTTPS证书错误【避坑】

裘德小鎮的故事

裘德小鎮的故事

发布时间:2026-03-18 20:09:53

|

457人浏览过

|

来源于php中文网

原创

Git clone 报 SSL certificate problem 是因 Git 未正确配置可信 CA 根证书路径所致,需通过 git config --global http.sslCAInfo 指定有效证书文件路径,而非禁用验证。

git怎么解决ssl证书验证失败_git如何处理clone时的https证书错误【避坑】

Git clone 报 SSL certificate problem: unable to get local issuer certificate

这是 Windows/macOS 上 Git 使用系统 OpenSSL 或自带证书链时,找不到可信 CA 根证书导致的。不是网络问题,也不是 GitHub 换了证书,而是 Git 本身没配好信任库路径。

  • Windows 安装 Git for Windows 默认用的是它自带的 curlca-bundle.crt,但有时路径没自动识别或被覆盖
  • macOS 上 Git 可能调用系统钥匙串,也可能用 Homebrew 安装的 OpenSSL,两者证书源不一致就容易出错
  • Linux(如 Ubuntu)通常没问题,因为系统级证书更新及时;但若用自编译 Git 或容器环境,curl-ca-bundle 缺失就会触发该错误

临时绕过验证(仅限测试/内网)

不推荐长期使用,但能快速验证是否真是证书问题——如果绕过之后 git clone 成功,说明就是证书链没对上。

  • 只影响当前命令:git -c http.sslVerify=false clone https://github.com/user/repo.git
  • 影响当前仓库:git config http.sslVerify false(进到 repo 目录后执行)
  • 全局禁用(危险!不建议):git config --global http.sslVerify false —— 后续所有 HTTPS 请求都跳过校验,中间人攻击风险真实存在

正确修复:让 Git 找到可用的 CA 证书文件

核心是告诉 Git 哪里放着可信的根证书。Git 本身不维护证书,它依赖 curlOpenSSL 提供的证书包。

Elser AI
Elser AI

一站式AI动漫、短剧生成平台

下载
  • 先查 Git 当前信任路径:git config http.sslCAInfo,如果输出为空,说明没显式指定,Git 会按默认顺序找(比如 curl-ca-bundle.crt
  • Windows Git for Windows 用户:证书文件通常在 C:\Program Files\Git\mingw64\ssl\certs\ca-bundle.crt,设上即可:git config --global http.sslCAInfo "C:/Program Files/Git/mingw64/ssl/certs/ca-bundle.crt"(注意斜杠方向)
  • macOS Homebrew Git:证书常在 /opt/homebrew/etc/ca-certificates/cert.pem(Apple Silicon)或 /usr/local/etc/ca-certificates/cert.pem(Intel),设为:git config --global http.sslCAInfo /opt/homebrew/etc/ca-certificates/cert.pem
  • Linux(Debian/Ubuntu):一般用 /etc/ssl/certs/ca-certificates.crt,但需确认文件存在:ls /etc/ssl/certs/ca-certificates.crt

CI/CD 环境或 Docker 中证书失效

镜像里往往没预装完整证书包,或者基础镜像太精简(如 alpine:latest)。这时候不能靠系统更新,得手动注入。

  • Alpine 镜像:安装 ca-certificates 包,并确保软链接存在:apk add --no-cache ca-certificates && update-ca-certificates
  • Docker 构建中 Git 失效:在 Dockerfile 里加一句 RUN git config --global http.sslCAInfo /etc/ssl/certs/ca-certificates.crt(前提是该路径已存在)
  • GitHub Actions:默认 Ubuntu runner 是好的,但如果用了自定义 container:,就得自己处理证书路径,否则 actions/checkout 会卡在 clone
证书路径写错、权限不足、文件被覆盖——这三个点最常导致“明明设了 http.sslCAInfo 还是报错”。多用 git config --get http.sslCAInfols -l 看一眼路径是否存在、可读。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

455

2023.06.14

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

183

2023.10.30

github中文官网入口 github中文版官网网页进入
github中文官网入口 github中文版官网网页进入

github中文官网入口https://docs.github.com/zh/get-started,GitHub 是一种基于云的平台,可在其中存储、共享并与他人一起编写代码。 通过将代码存储在GitHub 上的“存储库”中,你可以: “展示或共享”你的工作。 持续“跟踪和管理”对代码的更改。

4613

2026.01.21

自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

1000

2023.07.05

git和svn的区别
git和svn的区别

git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。

582

2023.07.06

git撤销提交的commit
git撤销提交的commit

Git是一个强大的版本控制系统,它提供了很多功能帮助开发人员有效地管理和控制代码的变更,本专题为大家提供git 撤销提交的commit相关的各种文章内容,供大家免费下载体验。

275

2023.07.24

git提交错误怎么撤回
git提交错误怎么撤回

git提交错误撤回的方法:git reset head^:撤回最后一次提交,恢复到提交前状态。git revert head:创建新提交,内容与之前提交相反。git reset :使用提交的 sha-1 哈希撤回指定提交。交互式舞台区:标记要撤回的特定更改,然后提交,排除已撤回更改。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

572

2024.04.09

git怎么对比两个版本的文件内容
git怎么对比两个版本的文件内容

要对比两个版本的 git 文件,请使用 git diff 命令:git diff 比较工作树和暂存区之间的差异。git diff 比较两个提交或标签之间的差异。git diff 输出显示差异块,其中 + 表示添加的行,- 表示删除的行, 表示修改的行。可使用 gitkraken、meld、beyond compare 等可视化工具更直观地查看差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

533

2024.04.09

Python WebSocket实时通信与异步服务开发实践
Python WebSocket实时通信与异步服务开发实践

本专题聚焦 Python 在实时通信场景中的开发实践,系统讲解 WebSocket 协议原理、长连接管理、消息推送机制以及异步服务架构设计。内容包括客户端与服务端通信实现、连接稳定性优化、消息队列集成及高并发处理策略。通过完整案例,帮助开发者构建高效稳定的实时通信系统,适用于聊天应用、实时数据推送等场景。

7

2026.03.18

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Git 教程
Git 教程

共21课时 | 4.3万人学习

Git版本控制工具
Git版本控制工具

共8课时 | 1.6万人学习

Git中文开发手册
Git中文开发手册

共0课时 | 94人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号