git 多SSH key配置以及常见问题

针对每个账户生成不同的 SSH Key

ssh-keygen -t rsa -C "<邮箱,如：xxx@qq.com>"
Generating public/private rsa key pair.
Enter file in which to save the key (/c/Users/Administrator/.ssh/id_rsa): <输入生成文件的名称，随意命名>
后面一路直接回车，不需要输入密码

例如：

生成第一个 SSH Key：javabk_test_rsa

$ ssh-keygen -t rsa -C "javabk@qq.com"
Generating public/private rsa key pair.
Enter file in which to save the key (/c/Users/Administrator/.ssh/id_rsa): javabk_test_rsa
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in javabk_test_rsa
Your public key has been saved in javabk_test_rsa.pub
...//省略

生成第二个 SSH Key: javabk2_test_rsa

$ ssh-keygen -t rsa -C "javabk2@qq.com"
Generating public/private rsa key pair.
Enter file in which to save the key (/c/Users/Administrator/.ssh/id_rsa): javabk2_test_rsa
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in javabk2_test_rsa
Your public key has been saved in javabk2_test_rsa.pub
...//省略

ssh-add 添加到高速缓存(可选)

通过 ssh-add 命令将专用私钥添加到ssh-agent的高速缓存中，提升性能

ssh-add ~/.ssh/javabk_test_rsa
ssh-add ~/.ssh/javabk2_test_rsa

添加 SSH 公钥到服务端

将上面每个生成的 .pub 里面的内容全部配置到仓库的SSH KEY，如上面的例子，将 javabk_test_rsa.pub 文件的内容输出，然后复制到服务端对应配置SSH KEY的地方。

配置 ~/.ssh/config 文件

如果 ~/.ssh/config 文件不存在，则创建一个。配置如下：

Host javabk_github.com
        HostName github.com
        PreferredAuthentications publickey
        IdentityFile ~/.ssh/javabk_test_rsa
        User javabk

Host javabk2_github.com
        HostName github.com
        PreferredAuthentications publickey
        IdentityFile ~/.ssh/javabk2_test_rsa
        User javabk2

参数说明:

Host: 随意命名，保证唯一，建议用户名 + 仓库域名地址

HostName: 仓库域名地址

PreferredAuthentications: 强制使用Public Key验证

IdentityFile: 密钥文件的路径

User: 指定用户名

常见问题

git push 提交时报权限拒绝错误，如下：

$ git push
ERROR: Permission to xxxx.git denied to xxx用户名.
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

解决思路：

检查报错的用户名是否是提交仓库应该用到的用户名，如果不是，检查 .ssh/config 里面对应的Host 有没有指定 User；同时如果是同个仓库多个用户名，检查提交代码工程的 .git/config 文件中，[remote "origin"] 下面的 url = git@xxxHost:yyy.git 中的 Host是否跟 .ssh/config 的Host配置对应，否则可以修改想要的Host，这样才会用到相关的配置进行提交。

错误案例：：

~/.ssh/config , 同个网站，多个用户名。其中第一个Host的用户名是javabk，第二个用户名是 javabk2

Host github.com
        HostName github.com
        PreferredAuthentications publickey
        IdentityFile ~/.ssh/javabk_test_rsa

Host javabk2_github.com
        HostName github.com
        PreferredAuthentications publickey
        IdentityFile ~/.ssh/javabk2_test_rsa

git clone 代码后，工程里面的 .git/config 如下。侧重看：url = git@github.com 中的 github.com，这个其实是对应到上面的 ~/.ssh/config 里面 Host 为

github.com 配置

[core]
        repositoryformatversion = 0
        filemode = false
        bare = false
        logallrefupdates = true
        symlinks = false
        ignorecase = true
[remote "origin"]
        url = git@github.com:javabk/javabk_demo.git
        fetch = +refs/heads/*:refs/remotes/origin/*
[branch "main"]
        remote = origin
        merge = refs/heads/main

javabk2用户的仓库代码进行git push 提交时报错，如下，发现用户名并不是 javabk2，而是javabk，应该是没指定时使用了默认账号
```
$ git push
ERROR: Permission to xxxx.git denied to javabk.
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.
```
解决：
1. 修改代码工程里面的 .git/config 中 [remote "origin"] 下的 url = git@github.com:javabk/javabk.demo.git 中的 github.com 改成 javabk2_github.com（对应 ~/.ssh/config 中对应第二个用户名的Host 配置）。如果这步还不行，尝试执行2
```
url = git@javabk2_github.com:javabk/javabk_demo.git
```
2. 在仓库代码里面指定对应的用户名和邮箱
```
git config user.name "javabk2"
git config user.email "javabk2@qq.com"
```
  或者直接编辑工程里面的 .git/config，添加下面这部分内容（其实上面的命令就是添加这部分内容）
```
[user]
        name = javabk2
        email = javabk2@qq.com
```