讲师中心 微信公众号
AI工具推荐 视频效率加速

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

落敏酱_3167

落敏酱_3167

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

|

637人浏览过

|

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

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

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

Git Factory
Git Factory

为每个编码任务配置并管理独立的 Git worktree,支持并行分支和清晰的 PR 工作流,避免合并冲突。

下载
  • 只影响当前命令: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 本身不维护证书,它依赖 curl 或 OpenSSL 提供的证书包。

  • 先查 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.sslCAInfo 和 ls -l 看一眼路径是否存在、可读。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

相关专题

更多
curl_exec
curl_exec

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

3583

2023.06.14

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

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

795

2023.10.30

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

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

8485

2026.01.21

GitHub官网入口版本汇总
GitHub官网入口版本汇总

本专题整合了GitHub入口版本地址汇总,阅读专题下面的文章了解更多详细内容。

858

2026.04.02

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

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

6119

2023.07.05

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

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

1780

2023.07.06

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

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

1054

2023.07.24

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

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

3997

2024.04.09

Revel框架入门与安装配置
Revel框架入门与安装配置

本专题从Revel框架环境搭建讲起,系统介绍命令行工具安装、项目创建、目录结构、配置文件及热代码重载,帮助开发者快速完成首个Go Web应用。

0

2026.10.16

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
vscode手册
vscode手册

共0课时 | 0人学习

Git 教程
Git 教程

共21课时 | 8万人学习

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

共8课时 | 1.9万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn