【工具】GitHub 多账号 SSH 配置完整指南

前言#

很多人电脑上会有两个及以上的 GitHub 账号，比如一个是工作号、一个是个人号。默认的 SSH 配置只有一个私钥，当你用账号 A 的密钥去访问账号 B 的仓库时，GitHub 会认为你是账号 A，而账号 A 没有 B 仓库的权限，直接报”仓库不存在”。

这个问题的根源是：两个仓库用了同一个 SSH 地址 [email protected]。解决方法很简单——给每个账号单独配一套密钥，再用 .ssh/config 起个别名，B 的仓库 remote 改成别名地址就完事了。

第一步：生成两套独立的 SSH 密钥#

打开 Git Bash 或 PowerShell，执行以下命令：

1
# A 账号密钥（如果已有可以跳过）
2
ssh-keygen -t ed25519 -C "账号A的github邮箱" -f ~/.ssh/id_gh_a
3

4
# B 账号密钥（重点，新建这个）
5
ssh-keygen -t ed25519 -C "账号B的github邮箱" -f ~/.ssh/id_gh_b

提示输入 passphrase 时，可以直接回车用空密码，也可以设置密码（推荐）。

生成完毕后，把两个公钥分别添加到对应账号：

1
# 查看公钥内容
2
cat ~/.ssh/id_gh_a.pub
3
cat ~/.ssh/id_gh_b.pub

然后分别登录 GitHub：

• 账号 A → Settings → SSH and GPG keys → New SSH key → 粘贴 id_gh_a.pub 内容
• 账号 B → Settings → SSH and GPG keys → New SSH key → 粘贴 id_gh_b.pub 内容

第二步：创建 / 修改 ~/.ssh/config#

Windows 路径：C:\Users\你的用户名\.ssh\config

⚠️ 注意：文件名叫 config，不要加任何后缀（比如 .txt），编码用 UTF-8。

写入以下内容：

1
# GitHub 账号A
2
Host gh-a
3
  HostName github.com
4
  IdentityFile ~/.ssh/id_gh_a
5
  User git
6

7
# GitHub 账号B
8
Host gh-b
9
  HostName github.com
10
  IdentityFile ~/.ssh/id_gh_b
11
  User git

含义解释：

• Host gh-a：给这个连接起个别名叫 gh-a，以后用这个别名代替 github.com
• HostName github.com：实际连接的服务器
• IdentityFile：使用哪个私钥
• User git：SSH 连接 GitHub 使用的用户名（固定写 git）

第三步：测试连通性#

1
# 测试账号 A
2
ssh -T gh-a
3

4
# 测试账号 B
5
ssh -T gh-b

成功的话会看到类似这样的输出：

1
Hi B用户名! You've successfully authenticated, but GitHub does not provide shell access.

第四步：修改 B 仓库的 remote 地址#

进入账号 B 的本地仓库目录，先把当前的 remote 地址看一下：

1
git remote -v

原来大概率是 [email protected]:Bname/repo.git，这个会默认读取 id_gh_a，必须改成别名 gh-b：

1
git remote set-url origin gh-b:B用户名/仓库名.git

改完后验证一下：

1
git remote -v
2
# 应该看到 origin 用的是 gh-b:...

第五步：设置本仓库独立的提交作者#

现在 B 仓库用的密钥对了，但 commit 的 author 还是全局配置的 A 账号信息。用 --local 只在本仓库生效，不影响其他仓库：

1
git config --local user.name "B的GitHub用户名"
2
git config --local user.email "B的GitHub邮箱"

✅ --local 只作用当前仓库，不会污染 A 仓库的配置！

验证配置：

1
git config --local --list

第六步：以后的使用规范#

养成习惯，克隆的时候直接带上别名：

1
# 克隆 A 账号的仓库
2
git clone gh-a:A用户名/repo.git
3

4
# 克隆 B 账号的仓库
5
git clone gh-b:B用户名/repo.git

快速自检命令#

遇到问题先跑这三个，基本能定位：

1
# 看当前仓库 git 配置
2
git config --local --list
3

4
# 看远程地址
5
git remote -v
6

7
# 测试 B 账号 SSH 连通
8
ssh -T gh-b

常见报错：Permission denied (publickey) 排查#

遇到这个报错的核心原因是：SSH 找到了私钥，但 GitHub 拒绝了该公钥身份。最常见的根因是 remote 地址写错了。

1
[email protected]:用户名/仓库名.git

1
gh-b:用户名/仓库名.git

1
git remote set-url origin gh-b:B的GitHub用户名/仓库名.git

1
git remote set-url origin gh-b:wangbin247/demo.git

1
ssh -T gh-b

1
ssh -T gh-b 失败 → 检查公钥是否添加到了 B 账号
2
ssh -T gh-b 成功 → 检查 git remote 地址格式是否正确

常见问题#

Q：已经 push 到远程的历史 commit 作者是 A，需要改吗？

不建议改。已 push 的历史 commit 重写作者会破坏协作，后续新提交用 B 就行。

Q：两个仓库能不能共用同一个 SSH 地址？

不能。这正是踩坑的根源，每个账号必须用不同的别名地址。

Q：ssh -T gh-b 返回权限被拒绝怎么办？

参考上面的【常见报错排查】，按顺序检查：公钥是否添加到 B 账号 → config 是否正确 → remote 地址格式是否正确。

总结#

整个流程其实就四步：生成密钥 → 配 config → 改 remote → 设 local 作者。记住核心原则：每个账号一套密钥，每个仓库一个别名，就不会再踩坑了。