使用多个 GitHub 账号的 SSH 配置与常见问题排查

jieshenai

已于 2024-09-17 10:49:03 修改

阅读量570

点赞数 9

分类专栏：软件工具文章标签： github ssh 运维

于 2024-09-17 10:46:48 首次发布

本文链接：https://blog.csdn.net/sjxgghg/article/details/142312282

版权

软件工具专栏收录该内容

6 篇文章 0 订阅

订阅专栏

文章目录

- - 使用多个 GitHub 账号的 SSH 配置与常见问题排查

使用多个 GitHub 账号的 SSH 配置与常见问题排查

摘要

在开发过程中，可能会涉及到多个 GitHub 账号的使用。为了避免每次切换账号时手动输入用户名和密码，我们可以通过配置多个 SSH 密钥来管理这些账号。本文将详细介绍如何为每个 GitHub 账号生成独立的 SSH 密钥、如何配置 SSH 代理、以及在使用 SSH 连接克隆仓库时遇到的常见错误及其解决方案。

1. 使用多个 GitHub 账号的场景介绍

在日常开发中，可能有以下场景需要使用多个 GitHub 账号：

工作与个人项目分离：你可能有一个工作账号用于公司项目管理，还有一个个人账号用于自己的开源项目或其他私有项目管理。
多重身份管理：不同的组织或团队可能要求你使用不同的 GitHub 账号来管理项目。

为了简化这些场景中的账户切换和管理，我们可以通过 SSH 配置，让每个仓库使用特定的 GitHub 账号而无需反复输入密码或切换登录状态。

2. 配置多个 SSH 密钥

2.1 生成多个 SSH 密钥

每个 GitHub 账号需要一个独立的 SSH 密钥。通过 ssh-keygen 命令为每个账号生成密钥，并指定不同的文件名。

为第一个 GitHub 账号生成密钥：

ssh-keygen -t rsa -b 4096 -C "your-email-for-account1@example.com"

命令执行后，它会提示你输入文件名，保存路径可以为：

/home/your-username/.ssh/id_rsa_account1

同样，为第二个账号生成另一个密钥：

ssh-keygen -t rsa -b 4096 -C "your-email-for-account2@example.com"

保存路径可以为：

/home/your-username/.ssh/id_rsa_account2

2.2 添加 SSH 密钥到 SSH 代理

接下来，需要启动 SSH 代理并将生成的密钥添加到代理中。

启动 SSH 代理：

eval "$(ssh-agent -s)"

然后将每个密钥添加到代理中：

ssh-add ~/.ssh/id_rsa_account1
ssh-add ~/.ssh/id_rsa_account2

2.3 将 SSH 公钥添加到 GitHub 账户

在 GitHub 网站上，将每个公钥分别添加到对应的 GitHub 账户中。

打开终端并查看公钥内容：

cat ~/.ssh/id_rsa_account1.pub

将显示的内容复制，然后登录到第一个 GitHub 账号：
- 进入 Settings -> SSH and GPG keys。
- 点击 New SSH key，粘贴公钥并保存。
对第二个账号执行相同的操作，将 ~/.ssh/id_rsa_account2.pub 添加到 GitHub。

3. 配置 SSH 代理与 GitHub 账户的关联

为了让 Git 在克隆和操作时能够正确选择相应的 SSH 密钥，我们需要通过 SSH 配置文件（~/.ssh/config）来为每个 GitHub 账号设置特定的 Host。

编辑 ~/.ssh/config 文件，添加以下内容：

# Account 1
Host github-account1
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_rsa_account1

# Account 2
Host github-account2
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_rsa_account2

这样，Git 在访问 github-account1 或 github-account2 时，会使用相应的密钥进行身份验证。

3.1 为不同仓库设置不同的 GitHub 账号

在克隆仓库时，指定相应的 Host 名称。例如，克隆第一个账户下的仓库时：

git clone git@github-account1:username/repo.git

对于第二个账户：

git clone git@github-account2:username/repo.git

通过这种方式，你可以轻松管理多个 GitHub 账号，避免反复输入用户名和密码。

【注意⚠️】:

上述使用的是：git@github-account1 和 git@github-account2。而不是 github.com；
不能使用 github.com，要使用在 config 文件中 Host xxx.com 后面的 xxx.com进行拉取文件。

所以我在config文件中，把账户1设置为 github.com，账户2设置为 github_account2.com。

这样账户1在clone仓库时，可以直接clone。
账户2需要把url修改为git@github-account2才能clone文件。

下述是我配置的config文件：

# Account 1
Host github.com
    HostName ssh.github.com
    User git
    IdentityFile ~/.ssh/id_rsa
    Port 443


# Account 2
Host github_account2.com
    HostName ssh.github.com
    User git
    IdentityFile ~/.ssh/daiyu
    Port 443

4. SSH 连接 GitHub 时常见错误排查

4.1 问题 1：`Connection closed by 198.18.0.35 port 22`

当尝试通过 SSH 克隆仓库时，可能会遇到类似如下的错误信息：

Connection closed by 198.18.0.35 port 22
fatal: Could not read from remote repository.

原因分析：这个问题通常与网络配置或 SSH 配置不当有关。可能是由于网络环境阻止了端口 22 的 SSH 连接，或者密钥文件没有正确配置。

解决方法：

使用端口 443 进行 SSH 连接：在某些受限的网络环境中，端口 22 可能被防火墙阻止。GitHub 提供了备用的 ssh.github.com，可以通过端口 443 连接。

编辑 ~/.ssh/config，将 HostName 修改为 ssh.github.com 并指定使用端口 443：

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

保存后再尝试克隆：

git clone git@github.com:username/repo.git

检查 SSH 代理：确保 SSH 代理已正确启动，并且密钥已经加载：

ssh-add -l

如果没有密钥，执行：

ssh-add ~/.ssh/id_rsa

确认 GitHub 中是否添加了正确的公钥：确保你已经将正确的 SSH 公钥添加到 GitHub。

4.2 问题 2：`Permission denied (publickey)`

如果遇到 Permission denied (publickey) 错误，说明 SSH 密钥未被正确识别。这可能是由于密钥未添加到 SSH 代理，或是密钥没有添加到 GitHub 账户。

解决方法：

使用 ssh-add ~/.ssh/id_rsa 添加私钥。
检查是否正确添加了公钥到 GitHub 账户。

4.3 问题 3：`Host key verification failed`

当 Host key verification failed 错误出现时，可能是 GitHub 的主机密钥发生了变更。

解决方法：

使用以下命令清除缓存的 GitHub 主机密钥：

ssh-keygen -R github.com

然后重新尝试连接：

ssh -T git@github.com

5. 总结

通过正确配置 SSH，可以在同一台电脑上同时使用多个 GitHub 账号，无需反复切换或输入密码。关键在于为每个账号生成独立的 SSH 密钥，并通过 ~/.ssh/config 配置文件进行管理。此外，克隆仓库时遇到的常见连接问题大多可以通过修改 SSH 配置或使用备用端口（443）来解决。希望本文能帮助你更好地管理多个 GitHub 账号，并轻松解决 SSH 连接中的问题。