一台电脑同时使用 GitHub 和公司 GitLab

一、生成两套 SSH 密钥#

现在推荐用 ed25519 算法，比 RSA 更短更安全：

1
ssh-keygen -t ed25519 -C "个人邮箱" -f ~/.ssh/id_ed25519_github
2
ssh-keygen -t ed25519 -C "公司邮箱" -f ~/.ssh/id_ed25519_gitlab

然后把两个 .pub 公钥分别添加到 GitHub 和 GitLab 的个人设置里。

二、用 ~/.ssh/config 按域名选择密钥#

1
# 个人 GitHub
2
Host github.com
3
    HostName github.com
4
    User git
5
    IdentityFile ~/.ssh/id_ed25519_github
6
    IdentitiesOnly yes
7

8
# 公司 GitLab
9
Host gitlab.example.com
10
    HostName gitlab.example.com
11
    User git
12
    IdentityFile ~/.ssh/id_ed25519_gitlab
13
    IdentitiesOnly yes

IdentitiesOnly yes 很重要：没有它，SSH 会先把 ssh-agent 里所有的密钥挨个试一遍，可能用错密钥，或者尝试次数过多被服务器断开。

配好后验证：

1
ssh -T git@github.com
2
ssh -T git@gitlab.example.com

三、按目录自动切换提交身份#

当年的做法是在每个公司仓库里手动执行 git config --local user.name/user.email，很容易忘。Git 2.13 之后可以用 includeIf，按仓库所在目录自动加载不同的配置。

~/.gitconfig：

1
[user]
2
    name = 个人用户名
3
    email = 个人邮箱
4

5
# work 目录下的仓库，自动使用公司身份
6
[includeIf "gitdir:~/work/"]
7
    path = ~/.gitconfig-work

~/.gitconfig-work：

1
[user]
2
    name = 公司用户名
3
    email = 公司邮箱

公司的项目都放在 ~/work/ 下面，提交时就会自动用公司身份。在仓库里执行 git config user.email 可以确认当前生效的是哪个。

四、遇到过的问题#

当时推送到公司 GitLab 时出现过这个报错：

1
ssh_exchange_identification: read: Connection reset by peer
2
fatal: Could not read from remote repository.

它的意思是 SSH 连接在握手阶段就被服务端断开了，还没轮到验证密钥，所以和密钥配置无关。常见原因是服务端限制了允许 SSH 的来源 IP（比如只放行公司内网或 VPN），或者短时间内连接次数过多被拦截。当时的临时办法是改用 HTTPS 地址推送；根本的解决办法是找管理员确认 SSH 访问策略。