Skip to main content

SSH 故障排除

使用 SSH 连接到 GitHub 并进行身份验证时,您可能需要对可能出现的意外问题进行故障排除。

使用 SSH 通过 HTTPS 端口连接

有时,防火墙会完全拒绝允许 SSH 连接。 如果无法选择使用具有凭据缓存的 HTTPS 克隆,可以尝试使用通过 HTTPS 端口建立的 SSH 连接克隆。 大多数防火墙规则应允许此操作,但代理服务器可能会干扰。

恢复 SSH 密钥密码

如果您丢失 SSH 密钥密码,则根据您使用的操作系统,您可能可以恢复它,也可能需要生成新的 SSH 密钥密码。

已删除或缺少的 SSH 密钥

作为安全预防措施,GitHub 会自动删除一年内未使用过的 SSH 密钥。

错误:主机密钥验证失败

作为安全预防措施,SSH 会跟踪之前看到的主机。

错误:权限被拒绝(公钥)

“权限被拒绝”错误表示服务器拒绝了您的连接。 可能有多个原因,最常见的如下所述。

错误:文件编号错误

此错误通常表示您无法连接到服务器。 这通常由防火墙和代理服务器造成。

错误:密钥已被使用

尝试添加已添加到其他帐户或存储库的密钥时,会发生此错误。

错误:用户/仓库拒绝其他用户的权限

此错误意味着您使用的密钥绑定到一个没有仓库访问权限的账户。

错误:用户/仓库拒绝用户/其他仓库的权限

此错误意味着您正在推送的密钥作为 deploy key 附加到另一个仓库,并且对您尝试推送到的仓库的没有访问权限。

错误:代理承认没有签署

在极少数情况下,通过 SSH 在 Linux 上连接到 GitHub 会产生错误 。 请遵循以下步骤解决此问题。

错误:ssh-add:非法选项 -- apple-use-keychain

此错误意味着你的 版本不支持 macOS 密钥链集成,此集成允许你将密码存储在密钥链中。

错误:SSL 证书有问题,请验证 CA 证书是否正常

此错误意味着您的 CA 根证书已过期。 如果你的 CA 根证书需要更新,你将无法从 GitHub 仓库推送或拉取。

错误:未知密钥类型

此错误表示您使用的 SSH 密钥类型无法识别或不受 SSH 客户端支持。

错误:我们正在进行 SSH 密钥审核

此错误意味着无法验证正在用于执行 Git 操作的 SSH 密钥。