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

Git 连接 GitHub 失败:Failed to connect to port 443 排查与解决

Git 连接 GitHub 端口 443 失败通常由网络代理或 DNS 缓存引起。若使用 VPN,需检查系统代理并同步配置 Git 的 http/https.proxy,同时刷新 DNS 缓存;若未使用 VPN 却报错,则可能是残留了旧的代理配置,需取消设置后重试。通过区分网络环境调整 Git 代理状态,可快速恢复连接。

古灵精怪发布于 2026/3/22更新于 2026/9/875 浏览
Git 连接 GitHub 失败:Failed to connect to port 443 排查与解决

在使用 Git 进行代码管理时,偶尔会收到 Failed to connect to github.com port 443 after ... ms: Couldn't connect to server 的错误提示。这类问题通常源于网络配置、代理设置或 DNS 缓存的干扰。根据你是否处于 VPN 环境,处理逻辑会有所不同。

使用 VPN 环境下的解决方案

当你开启 VPN 时,GitHub 连接失败往往是因为 Git 配置的代理端口与实际系统不一致,或者代理服务器本身不稳定。此时需要确保 Git 能正确通过代理访问外网。

1. 检查当前代理设置

先确认系统的代理端口。VPN 客户端通常会占用一个本地端口(如 127.0.0.1:1234)。

  • Windows:进入 设置 > 网络和 Internet > 代理,查看'手动代理设置'中的地址和端口。
  • macOS:在 系统偏好设置 > 网络 > 高级 > 代理 中查找。

记录下这个端口号,后续配置 Git 时需要用到。

2. 配置 Git 使用代理

让 Git 跟随系统的代理设置。假设你的代理端口是 1234,执行以下命令:

git config --global http.proxy http://127.0.0.1:1234
git config --global https.proxy http://127.0.0.1:1234

这样 Git 就会通过该代理转发请求。注意,如果之前配置过其他代理,这些命令会覆盖旧值。

3. 验证代理设置是否生效

配置完成后,列出全局配置确认一下:

git config --global -l

输出中应包含 http.proxy 和 https.proxy 且指向你刚才设置的地址。如果没看到,说明配置未成功写入。

4. 刷新 DNS 缓存

有时候 DNS 解析残留也会导致连接超时,建议刷新系统缓存后再试。

  • Mac 用户:
    sudo dscacheutil -flushcache
    sudo killall -HUP mDNSResponder
    
  • Windows 用户:
    ipconfig /flushdns
    

5. 重新尝试 Git 操作

完成上述步骤后,执行 git push 或 git pull 测试连接。如果依然失败,请检查 VPN 服务是否正常,或尝试切换节点。

未使用 VPN 环境下的解决方案

如果你没有开 VPN,却遇到同样的报错,大概率是 Git 配置里残留了之前的代理信息,导致它试图走不存在的代理通道。

1. 取消 Git 配置的代理

移除所有全局代理设置,恢复直连模式:

git config --global --unset http.proxy
git config --global --unset https.proxy

这两条命令会清除之前可能遗留的代理配置。

2. 验证代理设置已成功移除

再次运行查看配置的命令:

git config --global -l

如果输出列表中没有 http.proxy 或 https.proxy 相关条目,说明清理彻底。

3. 重试 Git 操作

现在可以直接尝试拉取或推送代码。如果问题依旧,请检查本地防火墙设置,确保没有拦截 443 端口的出站流量。

总结

GitHub 连接失败的核心在于网络路径是否通畅。在 VPN 环境下,重点是同步代理配置并刷新 DNS;在非 VPN 环境下,关键是清除残留的代理设置。按照上述步骤排查,绝大多数情况下都能恢复正常。

目录

  1. 使用 VPN 环境下的解决方案
  2. 1. 检查当前代理设置
  3. 2. 配置 Git 使用代理
  4. 3. 验证代理设置是否生效
  5. 4. 刷新 DNS 缓存
  6. 5. 重新尝试 Git 操作
  7. 未使用 VPN 环境下的解决方案
  8. 1. 取消 Git 配置的代理
  9. 2. 验证代理设置已成功移除
  10. 3. 重试 Git 操作
  11. 总结

更多推荐文章

查看全部
  • llama-cpp-python 完整安装与配置指南
  • Stable Diffusion XL 1.0 实战:灵感画廊创意应用案例
  • GitHub 项目本地运行指南:Python/Node.js/Java 实战部署与容器化
  • 鸿蒙金融理财全栈:运维监控、性能优化与安全加固实战
  • WebGL 基础教程:矩阵变换原理与 3D 动画实战
  • 微信支付商家转账常见问题及 Java 调用示例
  • nanobot 轻量级 AI Agent 框架搭建 QQ 机器人实践与开源贡献
  • NewStar CTF Web 题目解析与解题思路
  • 通用人工智能平台功能解析与商业化应用场景指南
  • 利用 AI 智能体快速完成 C 语言与前端实训项目实战
  • ES6 进阶:深入理解进制、Symbol 与 Class 语法
  • GitHub 启用双因素身份验证(2FA)配置指南:TOTP 动态验证码设置
  • Java CountDownLatch 核心原理、API 详解与实战应用
  • 人工智能 10 大算法详解:原理、优缺点及实战案例
  • Llama-2-7b 模型在昇腾 NPU 上的性能测评与部署优化
  • 全自动 AI 视频创作与发布工具:LuoGen-agent
  • 基于 AI 辅助编程的在线图书借阅平台设计与实现
  • Llama-3.2-3B 部署优化:Ollama 量化与 GPU 适配实践
  • GitHub Copilot Pro 学生认证与配置指南
  • AI 驱动游戏:鸿蒙生态的机会在哪里?

相关免费在线工具

  • 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