GitHub、oschina账号SSH Key配置

本篇文章所叙述的内容都是用mac实现的，若你是Windows则仅供参考

1、只有一个GitHub账号或oschina账号（以GitHub为例）

打开终端（terminal）输入如下命令生成SSH Key

$ ssh-keygen -t rsa -C "your_email@example.com"

• 1.1 默认生成SSH Key

如果你不想做过多设置，那你可以连着敲三下回车键就会生成一对公钥和私钥 ,SSH Key默认保存在.ssh文件夹中，可在terminal中查看

也可直接到文件中查看：进入到你电脑的根目录中，使用快键键command+shift+. 就可查看隐藏文件夹，找到并打开.ssh文件夹就能看到一对默认生成key（id_rsa 和id_rsa.pub）。

---

• 1.2 设置SSH Key（若只需用一个SSH Key,最好不要自己配置）

敲三次回车键terminal分别会出现如下提示

值得注意的是ssh命令默认只会读取 .ssh文件夹中id_rsa这个私钥，若你更改路径或名称，则需要配置（具体怎么配置下面会讲），否则上传SSH Key时会报错。

---

• 1.3 添加SSH Key

找到id_rsa.pub公钥后，用文本编辑器打开，复制里面的内容。然后打开你的GitHub,点击你的头像->Settings->SSH and GPG keys->New SSH Key，添加你刚刚生成的SSH Key。结果如下（oschina中的添加步骤和GitHub一样）:

---

• 1.4 查看你上传的SSH Key是否可用

在终端中输入: ssh -T git@github.com( ssh -T git@gitee.com)，若终端中输出，说明你配置成功了。

Hi YourGitHubName! You’ve successfully authenticated, but GitHub does not provide shell access

若终端中输出，则表示你配置出错。出错可能是你更改了key的路径，可能是你更改了key的默认名称导致的。

Agent admitted failure to sign using the key.

debug1: No more authentication methods to try.
Permission denied (publickey).

到此只有一个GitHub账号或oschina账号添加SSH Key已完成

---

2. 一台电脑多个GitHub账号

背景：若你到一家公司后，公司会给你一个内部使用的git账号，这时你就有两个git账号，同时使用两个账号push到GitHub就会出问题。这里讲解怎么在一台电脑下同时保存多个SSH Key并被GitHub识别。

• 2.1 生成多个SSH Key（ 也可用1.2方式中方法配置）

创建SSH Key时不能用器默认生成的名称，为了方便区别可自己重命名。生成自己账号的SSH Key，保存在根目录下的.ssh文件夹中（你可以保存在别的路径下，但是需要注意和config中的路径一致）。

$ ssh-keygen -t rsa -C "your_email@example.com" -f ~/.ssh/mygithub

生成公司账号的SSH Key，保存在根目录下的.ssh文件夹中

$ ssh-keygen -t rsa -C "your_company_email@example.com" -f ~/.ssh/companygithub

这样你就会得到你自己和公司两个SSH Key，可用1.1中方式查看（自定义路径注意切换对应路径）。

---

• 2.2 修改配置文件

在你生成SSH Key的路径中创建一个config文件（我的保存根目录先的.ssh文件夹下），在config中输入如下内容保存。

Host github.com 
HostName github.com 
User git 
IdentityFile ~/.ssh/mygithub

Host gitee.com 
HostName gitee.com 
User git 
IdentityFile ~/.ssh/id_rsa

然后将你获取的两个SSH Key按照1.3中的方法加入到你的GitHub中，使用1.4中方法验证。

！！！注意：你在config中输入的SSH Key路径一定要和你保存的SSH Key 的路径一直，否则会出错。

---

3、一个GitHub账号一个oschina账号

背景： 一般情况我们自己的代码基本上都会上传到GitHub中托管，但有时公司的代码会托管到oschina（码云）中，这样你也要配置多个SSH Key。创建的步骤基本和2中一样。

创建GitHub SSH Key

$ ssh-keygen -t rsa -C "your_email@example.com" -f ~/.ssh/mygithub

创建oschina SSH Key

$ ssh-keygen -t rsa -C "your_oschina_email@example.com" -f ~/.ssh/oschinagithub

修改配置文件:
同样在你保存SSH Key的路径下创建config文件，内容如下：

Host github.com 
HostName github.com 
User git 
IdentityFile ~/.ssh/mygithub

Host gitee.com 
HostName gitee.com 
User git 
IdentityFile ~/.ssh/oschinagithub

然后将获取的SSH Key分别加入GitHub和oschina中，并验证。

4、注意事项

用到多账号，那就不能全局user.email和user.name！可以用如下命令查看当前全局配置信息

$ git config --list

然后取消全局配置，在系统根目录下执行就可以

git config --global --unset user.name    
git config --global --unset user.email 

为每个工程设置对象的user.email和user.name，前提是cd 到当前工程目录下

git config user.name "yourname"
git config user.email "youremail"