跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / Bash

GitHub 连接 443 端口报错及 SSL 证书配置解决方案

对 GitHub 访问时出现 443 端口无法连接及 SSL 证书文件错误(error setting certificate file)的问题提供解决方案。核心原因通常是 Git 无法找到或正确使用根证书包。解决方法按优先级包括:1. 清除全局自定义证书配置,让 Git 使用系统默认;2. 手动指定正确的 ca-bundle.crt 路径;3. 临时禁用 SSL 验证(不安全);4. 重新安装 Git。建议优先尝试清除配置的方法。

片刻发布于 2026/3/30更新于 2026/5/2930 浏览
GitHub 连接 443 端口报错及 SSL 证书配置解决方案

前言

最近在使用 GitHub 上传公开代码和资料时,遇到默认访问缓慢甚至无法访问的问题。在尝试克隆或提交代码后,第二天突然显示 443 提示无法连接到服务器。

解决方法

通过直接配置全局参数并移除自定义的 PEM 文件路径设置来解决该问题。

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

证书提示

错误信息:error setting certificate file: /path/to/cacert.pem

此错误表示 Git 在尝试进行 SSL/TLS 安全连接时,无法找到或无法正确使用指定的证书包文件(cacert.pem)。Git 需要一组受信任的根证书来验证 GitHub 服务器的身份。如果找不到该文件、路径错误或文件损坏,就会抛出此错误。

请按顺序尝试以下方法解决:

方法一:最简单的方法(推荐)- 让 Git 使用系统自带的证书存储

这是最直接、最一劳永逸的方法。我们不需要指定自定义的证书文件,而是让 Git 使用操作系统或 Git 自己内置的证书存储。

  1. 打开 Git Bash 或命令行。
  2. 执行以下命令,告诉 Git 不要使用任何自定义的证书文件,而是使用系统默认的:
git config --global --unset http.sslCAInfo
git config --global --unset http.sslCAPath

这两个命令会删除全局配置中关于自定义证书路径的设置。对于大多数现代 Windows 系统(Git for Windows 2.14+)和 macOS 系统,这通常能立刻解决问题。

如果方法一之后问题依旧,请继续尝试方法二。

方法二:手动指定正确的证书文件路径

有时,特别是某些旧版 Git 或特殊环境下,可能需要手动告诉 Git 证书文件在哪里。

第一步:找到 cacert.pem 或 ca-bundle.crt 文件

这个文件通常就在你的 Git 安装目录里。

  • 常见的路径可能是:
    • C:\Program Files\Git\mingw64\ssl\certs\ca-bundle.crt (Windows)
    • C:\Program Files\Git\mingw64\ssl\certs\ca-bundle.trust.crt (Windows)
    • /usr/ssl/certs/ca-bundle.crt (Git Bash)

注意:Git 更常用 ca-bundle.crt 而不是 cacert.pem。

第二步:设置正确的路径

一旦找到了正确的文件,使用以下命令将其路径配置给 Git:

git config --global http.sslCAInfo "C:/Program Files/Git/mingw64/ssl/certs/ca-bundle.crt"

重要提示:

  • 在 Windows 的 Git Bash 中使用路径时,建议使用正斜杠格式,或者使用双引号将包含空格的路径括起来。
  • 确保路径完全正确,一个字符都不能错。

方法三:临时忽略 SSL 验证(⚠️ 不推荐,最后的手段)

这是一个不安全的方法,因为它会使你的连接容易受到中间人攻击。除非你完全信任你的网络环境,并且只是临时需要完成某项工作,否则不要这样做。

该方法会告诉 Git 跳过对服务器证书的验证。

# 临时为当前命令禁用 SSL 验证
git -c http.sslVerify=false clone https://github.com/username/repo.git

# 或者,为当前仓库禁用(进入仓库目录后执行)
git config http.sslVerify false

# 【慎用】全局禁用 SSL 验证(非常不安全!)
git config --global http.sslVerify false

强烈建议在完成紧急操作后,立即撤销此设置:

git config --global --unset http.sslVerify

方法四:重新安装 Git

如果以上所有方法都失败了,可能是你的 Git 安装本身不完整或已损坏。最彻底的方法就是:

  1. 卸载当前版本的 Git。
  2. 从 Git 官方网站下载最新版本。
  3. 重新安装。在安装过程中,所有默认选项通常就是最佳选择。

总结与操作流程

  1. 首先尝试方法一:git config --global --unset http.sslCAInfo。这是最干净利落的解决方案,90% 的情况能搞定。
  2. 如果不行,尝试方法二:仔细找到正确的 ca-bundle.crt 文件路径并重新配置。
  3. 如果只是临时的紧急需求,可以考虑方法三,但务必记得事后恢复。
  4. 如果问题非常顽固,方法四(重装) 总能解决问题。

根据你的描述,方法一大概率能直接解决你的问题。请先尝试它。

目录

  1. 前言
  2. 解决方法
  3. 证书提示
  4. 方法一:最简单的方法(推荐)- 让 Git 使用系统自带的证书存储
  5. 方法二:手动指定正确的证书文件路径
  6. 方法三:临时忽略 SSL 验证(⚠️ 不推荐,最后的手段)
  7. 临时为当前命令禁用 SSL 验证
  8. 或者,为当前仓库禁用(进入仓库目录后执行)
  9. 【慎用】全局禁用 SSL 验证(非常不安全!)
  10. 方法四:重新安装 Git
  11. 总结与操作流程
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Open WebUI 部署报错 pkg_resources 缺失解决方案
  • GitHub 学生认证及 VS Code 中配置 Copilot 实战指南
  • OpenClaw 技能精选仓库:本地 AI 助手插件市场指南
  • Stable Diffusion WebUI 本地部署教程
  • 前端 AI 与营销增长:基于热门视频的核心趋势解析
  • DeerFlow 2.0:字节开源超级 Agent 框架
  • 程序员转行大模型领域:热门岗位推荐与选择策略
  • 基于Python的新能源汽车销量预测分析与可视化
  • 2017 年技术类书籍精选推荐
  • Python 核心基础知识点汇总
  • Neo4j Python SDK 手册
  • MATLAB 2025a 发布:深色模式与 Copilot 编程助手上线
  • M 系列 Mac 安装 Clawdbot 与 API 配置教程
  • C++ 继承机制详解:从基础语法到多态应用
  • AI 辅助开发:使用 DeepSeek 构建贪吃蛇游戏
  • AI 大模型训练与微调实操经验总结
  • 土木专业转行互联网产品经理的路径与经验总结
  • Python 测试工程师使用 Faker 库生成测试数据
  • Clawdbot 集成 Qwen3-32B 本地部署与 18789 端口调试
  • Neo4j 安装与基础使用教程

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online