使用多个 GitHub 账号的 SSH 配置与常见问题排查
文章目录
使用多个 GitHub 账号的 SSH 配置与常见问题排查
摘要
在开发过程中，可能会涉及到多个 GitHub 账号的使用。为了避免每次切换账号时手动输入用户名和密码，我们可以通过配置多个 SSH 密钥来管理这些账号。本文将详细介绍如何为每个 GitHub 账号生成独立的 SSH 密钥、如何配置 SSH 代理、以及在使用 SSH 连接克隆仓库时遇到的常见错误及其解决方案。
目录
- 使用多个 GitHub 账号的场景介绍
- 配置多个 SSH 密钥
- 配置 SSH 代理与 GitHub 账户的关联
- SSH 连接 GitHub 时常见错误排查
- 总结
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 连接中的问题。
原文地址：https://blog.csdn.net/sjxgghg/article/details/142312282
免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！