「Git」多账号多SSH-KEY使用教程

本文作者陈云峰，转载请注明。

Git多账号多SSH-KEY使用教程

问题背景

Github使用SSH与客户端连接。如果是单用户，生成密钥对后，将公钥保存至github，每次连接时SSH客户端发送本地私钥（默认~/.ssh/id_rsa）到服务端验证。单用户情况下，连接的服务器上保存的公钥和发送的私钥自然是配对的。

但是如果是多用户（user1，user2），我们在连接到user2的帐号时，user2保存的是自己的公钥，但是SSH客户端依然发送默认私钥，即user1的私钥，那么这个验证自然无法通过。不过，要实现多帐号下的SSH key切换在客户端做一些配置即可。

解决方法

生成和添加新的SSH Key

首先在终端中cd到~/.ssh目录下

cd ~/.ssh

生成新的SSH key：id_rsa_user2

ssh-keygen -t rsa -C 'user2@mail.com'

生成完后将新的SSH public key添加到网站github账号的SSH key设置中。

默认SSH只会读取id_rsa，所以为了让SSH识别新的私钥，需要将其添加到SSH agent

ssh-add ～/.ssh/id_rsa_user2

该命令如果报错：Could not open a connection to your authentication agent.无法连接到ssh agent，可执行ssh-agent bash命令后再执行ssh-add命令。

修改SSH config文件

完成以上步骤后在~/.ssh目录创建config文件，该文件用于配置私钥对应的服务器。内容如下：

# Default github user(`user1@mail.com`)
Host github.com
HostName github.com
User git
IdentityFile C:/Users/username/.ssh/id_rsa

# second user(`user2@mail.com`)
Host github-user2
HostName github.com
User git
IdentityFile C:/Users/username/.ssh/id_rsa_user2

Host随意即可，方便自己记忆，后续在添加remote是还需要用到。

修改Git项目为新地址

配置完成后，在连接非默认帐号的github仓库时，远程库的地址要对应地做一些修改，比如现在添加user2帐号下的一个仓库test，则需要这样添加：

git remote add test git@github-user2:user2/test.git 并非原来的git@github.com:user2/test.git

这样每次连接都会使用id_rsa_second与服务器进行连接。至此，大功告成！

修改邮箱地址(Author)

注意：github根据配置文件的user.email来获取github帐号显示author信息，所以对于多帐号用户一定要记得将user.email改为相应的email。

git config --global  user.email "user2@mail.com"

也可以不全局性修改，只修改某个Git下面的email邮箱。

cd test
git config user.email "user2@mail.com"

参考文档：

• http://help.github.com/win-set-up-git/
• http://help.github.com/multiple-ssh-keys/
• 如何管理git生成的多个ssh key秘钥

本文作者陈云峰，转载请注明。