先确认适用条件
适用于 github.com 仓库使用 SSH 地址时连接超时,而网页可以打开。下述入口面向 GitHub.com,不应套用到自建 GitHub Enterprise Server 或带数据驻留的 Enterprise Cloud。
先区分原因与影响范围
网页 HTTPS 可用不说明 SSH 的 22 端口可用。GitHub 提供 ssh.github.com 的 443 端口用于 SSH;协议仍是 SSH,网络若只允许真正的 HTTPS 或有代理限制,也可能阻止它。
按顺序检查,每次只改一项
- 先查看原 remote 地址与 SSH 错误,区分超时和 Permission denied (publickey)。已经到达密钥拒绝阶段时,应检查账号密钥,不以更换端口代替认证修复。
- 用下面的单次 SSH 命令测试 443 入口,先不修改全局配置。首次主机密钥提示需与 GitHub 官方指纹页核对;若出现密钥变化警告,停止核查,不删除全部 known_hosts。
- 看到包含正确 GitHub 用户名的认证成功提示后,再考虑为 Host github.com 添加 HostName ssh.github.com、Port 443、User git。编辑前备份 ~/.ssh/config,并检查是否已有匹配配置。
- 重新运行 ssh -T git@github.com,并对原仓库执行只读的 git ls-remote origin,验证账号是否拥有该仓库的读取权限。不要用 push 作为连接测试。
ssh -T -o ConnectTimeout=10 -p 443 git@ssh.github.comHost github.com
HostName ssh.github.com
Port 443
User git怎样确认已经恢复
GitHub 的 SSH 测试不会提供交互 shell,判断应看认证提示;随后能读取原仓库 refs 才验证到仓库权限。若 443 同样超时,记录网络与时间交给网络管理者处理。
未恢复时如何回退与求助
撤回本轮添加的 Host 配置段即可回到原端口,不删除其他主机设置和密钥。若网络仅允许 HTTPS,可按 GitHub 官方认证文档改用 HTTPS remote,但不要在 URL 中写入访问令牌。