SSH连接GitHub时提示“Host key verification failed”该如何解决？

Question

在使用SSH连接GitHub时，若出现“Host key verification failed”错误，通常是因为本地SSH客户端无法验证GitHub服务器的主机密钥。该问题常见于首次连接或SSH密钥配置异常时。解决方法包括：清除已知主机记录后重新连接、检查SSH配置是否正确、确认SSH密钥是否已正确添加至GitHub账户。此外，还可通过手动更新`~/.ssh/known_hosts`文件或使用`ssh-keyscan`命令重新获取GitHub的公钥来修复此问题。掌握这些排查步骤，有助于快速恢复与GitHub的正常SSH连接。

Answer 1

SSH连接GitHub出现“Host key verification failed”错误的深度解析与解决方案

在使用SSH连接GitHub时，若出现“Host key verification failed”错误，通常是因为本地SSH客户端无法验证GitHub服务器的主机密钥。该问题常见于首次连接或SSH密钥配置异常时。本文将从多个角度深入分析该问题的成因、排查流程及解决方法。

1. 问题成因分析

SSH协议在首次连接远程主机时，会将该主机的公钥信息保存在本地的 ~/.ssh/known_hosts 文件中。当再次连接时，SSH客户端会验证远程主机的指纹是否与本地记录一致。若不一致，则会提示“Host key verification failed”，以防止中间人攻击（MITM）。

常见原因包括：

• 首次连接GitHub，尚未记录其主机密钥。
• GitHub服务器更换了主机密钥（罕见但可能）。
• 本地 ~/.ssh/known_hosts 文件被修改或损坏。
• 使用了代理或网络中间设备篡改了SSH连接。

2. 排查流程图

graph TD
            A[尝试SSH连接GitHub] --> B{是否首次连接？}
            B -->|是| C[添加GitHub主机密钥]
            B -->|否| D[检查known_hosts文件]
            D --> E{是否存在GitHub密钥？}
            E -->|否| F[手动更新known_hosts]
            E -->|是| G[对比密钥是否一致]
            G -->|不一致| H[删除旧密钥并重新添加]
            G -->|一致| I[检查SSH配置和密钥路径]

3. 解决方案详解

以下是解决“Host key verification failed”问题的常见方法，按推荐顺序排列：

3.1 清除已知主机记录后重新连接

可使用以下命令删除GitHub的主机密钥记录：

ssh-keygen -R github.com

随后尝试重新连接GitHub：

ssh -T [e-mail]

3.2 使用 ssh-keyscan 手动更新 known_hosts

可使用 ssh-keyscan 命令获取GitHub的主机公钥并写入 ~/.ssh/known_hosts：

ssh-keyscan github.com >> ~/.ssh/known_hosts

该命令会将GitHub当前的主机密钥追加到你的known_hosts文件中。

3.3 检查SSH配置是否正确

检查 ~/.ssh/config 文件是否包含对GitHub的自定义配置，如：

Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_rsa
    

确保 IdentityFile 指向你当前使用的SSH私钥。

3.4 确认SSH密钥是否已正确添加至GitHub账户

使用以下命令查看当前SSH代理中添加的密钥：

ssh-add -l

若未列出你的私钥，需添加：

ssh-add ~/.ssh/id_rsa

然后将对应的公钥内容（~/.ssh/id_rsa.pub）添加到GitHub账户的SSH Keys设置中。

4. 扩展知识点与建议

为了更好地管理SSH连接，建议掌握以下相关命令和技巧：

命令	作用
ssh -vT [e-mail]	开启详细日志输出，帮助排查连接问题
ssh-keygen -F github.com	检查当前known_hosts中是否已有GitHub条目

同时，建议定期更新 known_hosts 文件，尤其是在企业环境中使用共享SSH配置时。