GitHub 在中国大陆失败时，先明确操作：打开仓库网页、解析主机名、登录、完成 SSO、调用 API，或通过 HTTPS、SSH 执行 clone、fetch、pull、push。各操作涉及不同主机、协议、凭据和组织控制；网页可开不代表 push 成功，单次 clone 失败也不证明平台处处不可用。

关键要点：

更改凭据、远端或代理前，先保存提交、补丁和未跟踪文件。

记录失败命令、协议、主机、网络、时间和完整错误，但不要泄露令牌或仓库资料。

分开比较网页、API、HTTPS Git 和 SSH Git，不把单一端点结果外推到整个平台。

排查过程中保留 TLS 验证、SSH 主机密钥检查、SSO 和组织策略。

本文不承诺任何地点或时段的可用性。公开旅行建议指出中国大陆互联网可能受限，实况随服务、运营商、地点和时间变化。［1］通用排查见中国大陆上网检查清单；本文只谈 GitHub 开发。

GitHub 在中国大陆究竟是哪一层失败？

建立最小故障矩阵

从一个你获准使用的仓库和一项非破坏性操作开始。不要通过强制推送、删除凭据或反复触发认证来测试。收集足以区分各层的细节。

检查面	安全观察	差异可能指向
公共网页	完整加载、部分加载还是超时？	浏览器、DNS、TLS、CDN 或网络路径
登录后网页	能否登录并打开目标组织？	身份提供方、MFA、SSO、会话或策略
HTTPS Git	`fetch` 是否到达远端后才拒绝凭据？	传输已到达，下一步查认证或授权
SSH Git	是否在仓库授权前就连接失败？	端口、代理、主机验证或 SSH 凭据
API	最小官方请求是否返回 HTTP 响应？	API 主机、令牌范围、限流或策略可能与网页不同
另一仓库	获准的公共或测试仓库是否不同？	体积、LFS、权限、钩子或组织策略

GitHub 官方建议核对连接，仅在需要时使用最新 IP 信息；涉及防火墙、代理或组织网络时，与管理员协作。［2］第三方镜像和复制凭据不能充当诊断捷径。

1. 保存本地工作并记录最小复现

修改配置之前，先确认已提交的工作确实保存在本机，并把无法替代的未跟踪文件复制到获准的安全位置。记录去掉秘密后的仓库远端地址、所做的操作（clone、fetch、pull、push、API 调用或浏览器加载）、协议、大致时间和完整错误文本。同时记下已安装的 Git 版本，以及是否涉及 Git LFS、子模块、凭据助手或企业 SSO 流程。

只对你有权访问的仓库执行 git ls-remote 这类只读命令。不要快速连续重试：这会掩盖时序、可能触发限流或身份控制，也让不同网络之间更难比较。仓库若包含敏感名称，分享日志前先遮盖。

2. 分开网页、DNS、TLS 与服务状态

检查 GitHub 公共页面、登录页、仓库页和官方状态页是否以同样方式失败。浏览器扩展、缓存会话、受管证书、DNS 解析器或强制门户，可能只影响浏览器而不影响命令行 Git，反过来也一样。只有组织政策允许时才用一个无痕窗口对比；在保存有用的会话和错误证据之前，不要清空全部浏览器数据。

按错误原意分类。域名解析失败、TCP 超时、TLS 证书错误、代理响应、403、404、429 和 5xx 属于不同层。不要跳过证书警告，也不要为了加载页面安装无法核验的根证书。

3. 如何在不削弱 TLS 的前提下检查 HTTPS Git？

确认远端使用预期的 https://github.com/OWNER/REPOSITORY.git 形式，并与 GitHub 官方文档中的 clone 流程对照。［3］如果连接已经到达 GitHub 但认证失败，检查凭据方式、令牌范围、令牌有效期、SSO 授权和仓库权限。在 Git 操作中，密码认证不能替代受支持的凭据流程。

分别检查仓库级、全局和系统级 Git 代理设置，以及相关环境变量，过程中不要输出秘密。过期的代理可能让浏览器正常而 Git 失败。每次只改一个层级，并记下原来的值。不要设置 http.sslVerify=false、关闭证书验证，或把凭据保存在远端 URL 中。

4. 将 SSH 作为独立传输路径检查

确认远端主机是预期的 GitHub 主机、客户端提供的是正确密钥，而且该密钥绑定在预期的账户或组织上。主机密钥验证是一道安全边界：把观察到的指纹与 GitHub 公布的指纹比较，不一致就停止。不要整个删除 known_hosts，也不要启用宽松的主机检查。

在某些网络上，22 端口的表现可能与 HTTPS 不同。对于封锁普通 SSH 的网络，GitHub 文档提供了经由 HTTPS 端口使用 SSH 的方案；按官方配置操作，并在使用前核验备用主机密钥。［4］这只改变传输路径，不改变仓库权限、SSO、分支保护、签名要求或组织策略。

5. 问题在身份、API 范围、SSO 还是组织控制？

把认证和授权分开看。有效的账户会话或令牌仍可能没有仓库访问权；组织可能要求 SAML SSO、IP 允许列表、获批的 OAuth 应用、细粒度令牌审批、受管用户控制或指定 SSH 证书。私有仓库返回 404，可能是有意隐藏其存在。

做 API 排查时，记录主机、HTTP 状态、限流响应头、令牌类型和所需范围，但不要把令牌写进日志。只测试文档中最小的读取操作。请组织所有者或网络管理员确认策略，不得绕过。个人仓库的结果并不证明企业组织也应表现相同。

6. 审计本地代理并比较一条受控网络路径

盘点浏览器与系统代理、Git 配置、SSH ProxyCommand 或 ProxyJump、容器、IDE 以及环境变量。不同层冲突很常见：浏览器可能走一条路径，Git、IDE 扩展或容器则走另一条。只删除能够解释且确定过期的条目。

若当地法律与组织政策允许，可在一条受控替代路径上重复同一个非破坏性操作。VPN 可以改变网络路由，但不能修复 GitHub 服务事件、授予仓库权限、完成 SSO、批准令牌或覆盖雇主控制。保持命令、账户、仓库与时间窗口一致，比较才有意义。若这次对照获准，可用 AethoVPN 为同一条 git ls-remote 提供备选路由。

7. 安全恢复并记录有效边界

只应用经确认的最小修正：修复预期的代理、刷新获准的凭据、完成 SSO 授权、请管理员更新策略、使用 GitHub 官方的 SSH 备用端口，或等待已确认的服务事件恢复。然后重复原操作并核对仓库状态。push 要通过获准的页面确认远端已有预期的提交，不能只看没有报错。

记录哪些检查面可用、哪些不可用，所用网络和协议，最终的错误或结果，以及需要撤销的临时改动。若仍没有可用路径，保留本地仓库，并协调获准的交接、补丁传递或稍后重试。不要把专有代码上传到公开仓库或非官方镜像。

总结

判断可用性之前，先明确具体的 GitHub 检查面和操作。
保存本地工作，并收集最小、已脱敏的复现记录。
分开处理网页、API、HTTPS Git、SSH Git、身份与组织策略。
绝不关闭 TLS 或 SSH 验证，也绝不绕过雇主管控。
在仓库层面验证恢复，并记录仍然存在的边界。

常见问题

GitHub 在中国大陆是否完全被屏蔽？

不要把不断变化、依赖路径的结果简化成统一的是或否。应在当前网络上测试具体获准的网页、Git 或 API 操作，并记录日期、地点和端点。

为什么 github.com 能打开，但 git clone 失败？

浏览器和 Git 客户端可能使用不同协议、代理、凭据、主机与组织控制。应分别排查 HTTPS 或 SSH 传输。

是否应该关闭 SSL 验证来修复 clone？

不应该。TLS 错误可能表示拦截、时钟错误、强制门户、受管证书问题或不安全路径。应保留错误信息，并修复信任或路由问题。

能否从 SSH 改用 HTTPS？

可以，前提是仓库和组织支持，但切换只改变传输，不改变权限。请使用官方远端格式与获准的凭据方式。

SSH 22 端口超时怎么办？

只在允许时使用 GitHub 官方的 SSH 经 HTTPS 端口流程，核验官方指纹，并保持严格主机密钥检查。

为什么个人仓库能用，组织仓库却失败？

组织可能要求 SSO 授权、获批令牌、IP 控制、受管身份或不同权限。应由所有者或管理员确认。

VPN 是否保证 GitHub push 成功？

不保证。路由只是其中一层，服务状态、凭据、SSO、仓库权限、钩子、分支保护与组织策略仍会决定结果。

免责声明：本文提供一般操作信息，不构成法律、安全、雇主政策或特定服务建议。请遵守适用法律、组织控制和 GitHub 最新官方文档。

来源

UK Government, China travel advice, internet access and security: https://www.gov.uk/foreign-travel-advice/china/safety-and-security
GitHub Docs, Troubleshooting connectivity problems: https://docs.github.com/en/get-started/using-github/troubleshooting-connectivity-problems
GitHub Docs, Cloning a repository: https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository
GitHub Docs, Using SSH over the HTTPS port: https://docs.github.com/en/authentication/troubleshooting-ssh/using-ssh-over-the-https-port

Sources checked 2026 年 9 月 12 日。

延伸阅读：

GitHub 在中国大陆：开发者网页、Git 与 API 访问检查清单