如何生成并配置多个ssh秘钥/添加 SSH Keys 报已存在怎么办？/MacOS多密钥配置

一、解决什么样的问题

当我们参加不同项目时，所使用的代码管理平台可能各不相同（GitHub/Gitee/云效…），或者记不得某个代码管理平台曾经使用过的账号。而当你在项目中添加个人目前电脑上唯一的ssh密钥时，可能会出现SSH Keys 已存在的错误，此时我们就可以对应各个平台生成多个ssh密钥来解决该问题。

本文将以GitHub和云效为例，以MacOS系统，分别对其生成不同的ssh密钥分开使用来解决冲突问题。

二、如何生成多个ssh密钥

1、使用如下命令生成密钥：

ssh-keygen -t rsa -f ~/.ssh/id_rsa.别名 -C "邮箱地址"

🌰：使用上述命令分别生成github和云效的ssh命令：

ssh-keygen -t rsa -f ~/.ssh/id_rsa.github -C "邮箱地址"
ssh-keygen -t rsa -f ~/.ssh/id_rsa.aliyun -C "邮箱地址"

2、使用如下命令可分别获取生成的ssh密钥：

cat id_rsa.别名.pub(如果报错未匹配到使用cat .ssh/id_rsa.github.pub)

3、将获取的密钥填入对应的平台：

• GitHub：
  
• 云效：
  

三、注册密钥到ssh-agent

需要这一步是因为ssh默认会去查找那个唯一的id_rsa秘钥，不会识别我们前文自定义生成的秘钥，所以需要将自定义的密钥注册到ssh-agent

1、注册密钥

ssh-add -K ~/.ssh/id_rsa.别名

2、查看注册结果（将看到设置的两条记录）

ssh-add -l

3、在ssh文件夹下创建config文件并进入编辑模式

cd ssh  #进入ssh文件夹
touch config  #创建config文件
vim config  #进入config文件

按下i键进入编辑模式

4、编辑如下内容（还是以Github和云效为例）：

Host git@github.com  #平台访问地址
HostName github #别名
User xxx #用户名随便起
IdentityFile ~/.ssh/id_rsa.github  #秘钥的地址

Host git@codeup.aliyun.com
HostName aliyun
User xxx
IdentityFile ~/.ssh/id_rsa.aliyun

编辑完成后按esc并输入:wq退出config文件

5、分别测试连通性

# 这里对应的是config文件中设置的HostName
ssh -T git@github.com

6、后续错误

当我们配置好多个ssh密钥后，可能在后续的使用过程中出现错误（例如：当你推送或拉取代码时报错：Permission denied (publickey).致命错误：无法读取远程仓库。）这时可以重复上述步骤1、2、5，这样就又可以使用了。

原文出处：Mac如何生成并配置多个ssh秘钥