Git 配置SSH，多个 Github 账号配置不同的SSH KEY

女爷i 2023-09-30 21:51 23阅读 0赞

#### 文章目录 ####

*   *  前言
     *  Git 配置 SSH
     *   *  一、查看是否已经生成过/是否应存在了私钥公钥
         *  二、生成密钥对（私钥公钥）
         *   *  ssh key命名的第一种方式：
             *  ssh key命名的第二种方式：
         *  三、将SSH密钥添加到ssh代理中
     *  多个Github账号配置不同的 ssh
     *   *  一、将公钥粘贴到git服务器平台上，如GitHub
         *  二、测试连接
         *  三、常见问题处理

### 前言 ###

首先做个说明

1.  生成一对默认的私钥公钥，私钥自己客户端留着用，公钥可以给多个平台用。
2.  多对私钥公钥，主要是应对一个平台多个账号的情况。当然你想每个平台使用不同的私钥公钥也是可以的。
3.  多次生成私钥公钥需要自己重新命名，否则会覆盖之前的。

![在这里插入图片描述][0bd4488f22b942d49a1364981024faff.png]

### Git 配置 SSH ###

#### 一、查看是否已经生成过/是否应存在了私钥公钥 ####

进入 用户/.ssh 目录

$ cd ~/.ssh

如果找不到目录或者目录中没有东西，证明以前没有生成过。

或者直接使用命令来查看

$ ls -al ~/.ssh
    # Lists the files in your .ssh directory, if they exist

检查目录列表，看看您是否已经拥有公共SSH密钥。默认情况下，GitHub受支持的公钥的文件名如下之一。

id_rsa.pub
    id_ecdsa.pub
    id_ed25519.pub

提示：如果您收到~/.ssh不存在的错误，则在默认位置没有现有的SSH密钥对。您可以在下一步创建新的SSH密钥对。

#### 二、生成密钥对（私钥公钥） ####

两种方式，一种是生成的时候直接添加好路径；另一种是不带路径，需要第二步添加路径或使用默认路径。

##### ssh key命名的第一种方式： #####

$ ssh-keygen -t rsa -C "youremail@yourcompany.com" -f ~/.ssh/id_rsa_github

> 代码参数含义：  
> \-t 指定密钥类型，默认是 rsa ，可以省略。  
> \-C 设置注释文字，比如邮箱。  
> \-f 指定密钥文件存储文件名。

##### ssh key命名的第二种方式： #####

$ ssh-keygen -t rsa -C "youremail@xxx.com"

> 以上代码省略了 -f 参数，因此，运行上面那条命令后会让你输入一个文件名，用于保存刚才生成的 SSH key 代码。

按回车后：

Generating public/private rsa key pair.
    Enter file in which to save the key (/Users/xxx/.ssh/id_rsa): id_rsa_github(取个名字)
    Enter passphrase (empty for no passphrase): 
    Enter same passphrase again: 
    Your identification has been saved in 
    id_rsa_github.
    Your public key has been saved in 
    id_rsa_github.pub.

> 最好每次生成时都给SSH Key取个名字，这样后面在管理时自己也一目了然。我这里的格式是id\_rsa\_项目名\_git提供方，我生成的所有key都遵循这个规则命名。建议你也有你自己的一种命名方式，并且保持统一。如果不取名字，默认的是id\_rsa，如果后面生成时不命名，会把这个覆盖掉。密码可以不设置，免得每次提交时还要输入一次，安全性自己衡量吧。第一次生成key时，会在~目录下创建一个.ssh目录。

**附：**  
键入ssh-keygen -t，然后是键类型和可选注释。此注释包含在创建的.pub文件中。您可能想使用电子邮件地址进行注释区分。

例如，对于ED25519：

ssh-keygen -t ed25519 -C "<comment>"

对于2048位RSA：

ssh-keygen -t rsa -b 2048 -C "<comment>"
    https://docs.gitlab.com/ee/ssh/#add-an-ssh-key-to-your-gitlab-account

#### 三、将SSH密钥添加到ssh代理中 ####

ssh服务器默认是去找id\_rsa，现在需要把这个key添加到ssh-agent中，这样ssh服务器才能认识id\_rsa\_TestSSH\_github。

*  在后台启动ssh-agent。

$ eval $(ssh-agent -s)
    > Agent pid 59566

根据您的环境，您可能需要使用其他命令。例如，在启动ssh-agent之前，您可能需要通过运行`sudo -s -H`来使用root访问，或者您可能需要使用`exec ssh-agent bash`或`exec ssh-agent zsh`来运行ssh-agent。

*  如果您使用的是macOS Sierra 10.12.2或更高版本，则需要修改`~/.ssh/config`文件，以自动将密钥加载到ssh代理中，并将密码存储在钥匙串中。

### 多个Github账号配置不同的 ssh ###

1.  首先，检查您的~/.ssh/config文件是否存在于默认位置。

$ open ~/.ssh/config
    > The file /Users/you/.ssh/config does not exist.

1.  如果文件不存在，请创建文件。

$ touch ~/.ssh/config

打开您的`~/.ssh/config`文件，然后修改文件以包含以下行。如果您的SSH密钥文件的名称或路径与示例代码不同，请修改文件名或路径以匹配当前设置。

Host github.com
      AddKeysToAgent yes
      UseKeychain yes
      IdentityFile ~/.ssh/id_rsa_github

**注意：如果您选择不向密钥添加密码，则应省略`UseKeychain行。`**

> **注意：如果您看到这样的错误**  
> /Users/USER/.ssh/config: line 16: Bad configuration option: usekeychain  
> `Host *`部分添加额外的配置行：  
> Host \*  
> IgnoreUnknown UseKeychain

\*\*注意：\*\*关于config文件，同时参考下列文件

*将不同账号的工程图服务器与ssh-key关联*

# 添加config配置文件
    # 配置文件参数
    # Host : Host可以看作是一个你要识别的模式，对识别的模式，进行配置对应的的主机名和ssh文件
    # HostName : 要登录主机的主机名
    # User : 登录名
    # IdentityFile : 指明上面User对应的identityFile路径
    
    #thub user(first@email.com)
    Host github1
     HostName git.some.com/
     User git
     IdentityFile /Users/xxx/.ssh/id_rsa
    
    # second user(second@email.com)
     # 建一个github别名，新建的帐号使用这个别名做克隆和更新
    Host github2
     HostName github.com
     User git
     IdentityFile /Users/xxx/.ssh/id_ras_bill_github

另一个例子

#
    # Main gitlab.com server
    #
    Host gitlab.com
    RSAAuthentication yes
    IdentityFile ~/my-ssh-key-directory/my-gitlab-private-key-filename
    User mygitlabusername

另一个例子

#
    # Our company's internal GitLab server
    #
    Host my-gitlab.company.com
    RSAAuthentication yes
    IdentityFile ~/my-ssh-key-directory/company-com-private-key-filename

另一个例子

# GitLab.com
    Host gitlab.com
      PreferredAuthentications publickey
      IdentityFile ~/.ssh/gitlab_com_rsa
    
    # Private GitLab instance
    Host gitlab.company.com
      PreferredAuthentications publickey
      IdentityFile ~/.ssh/example_com_rsa

另一个例子

# gitee
    Host gitee.com
    HostName gitee.com
    PreferredAuthentications publickey
    IdentityFile ~/.ssh/gitee_id_rsa
    # github
    Host github.com
    HostName github.com
    PreferredAuthentications publickey
    IdentityFile ~/.ssh/github_id_rsa

首先，检查您的~/.ssh/config文件是否存在于默认位置。

$ open ~/.ssh/config
    > The file /Users/you/.ssh/config does not exist.

*  将您的SSH私钥添加到ssh代理中，并将密码存储在钥匙串中。如果您使用其他名称创建了密钥，或者如果您正在添加具有不同名称的现有密钥，请将命令中的id\_rsa\_github替换为私钥文件的名称。

$ ssh-add ~/.ssh/id_rsa_github

即`ssh-add <directory to private SSH key>`  
如果执行ssh-add时提示"Could not open a connection to your authentication agent"，可以现执行命令：

$ ssh-agent bash

然后再运行ssh-add命令。

*  查看添加结果

ssh-add -l

补充：

# 可以通过 ssh-add -l 来确私钥列表
    $ ssh-add -l
    # 可以通过 ssh-add -D 来清空私钥列表
    $ ssh-add -D

#### 一、将公钥粘贴到git服务器平台上，如GitHub ####

当然可以直接打开刚生成的公钥文件`id_rsa_github.pub`文件，复制全部内容去平台Add SSH Key；也可以使用命令复制公钥文件内容贴到平台 Add SSH Key。

*  附：使用命令复制  
    将SSH公钥复制到剪贴板上

$ pbcopy < ~/.ssh/id_rsa_github.pub
    # Copies the contents of the id_rsa_github.pub file to your clipboard

*提示：如果pbcopy不起作用，您可以找到隐藏的.ssh文件夹，在您最喜欢的文本编辑器中打开文件，并将其复制到剪贴板。*

其规则就是：从上至下读取config的内容，在每个Host下寻找对应的私钥。  
这里将GitHub SSH仓库地址中的`git@github.com`替换成新建的Host别名如`github2`，那么原地址是：`git@github.com:username/Mywork.git`，替换后应该是：`github2:username/Mywork.git`。

#### 二、测试连接 ####

测试一下

$ ssh -T github2
    Hi 0xJoker! You've successfully authenticated, but GitHub does not provide shell

*  输入以下命令测试

$ ssh -T git@github.com
    # Attempts to ssh to GitHub

您可能会看到这样的警告：

> The authenticity of host 'github.com (IP ADDRESS)' can't be established.
    > RSA key fingerprint is SHA256:nThbg6kXUpJWGl7E1IGOCspRomTxdCARLviKw6E5SY8.
    > Are you sure you want to continue connecting (yes/no)?

*  验证您看到的消息中的指纹是否与GitHub[的RSA公钥指纹匹配][RSA]。如果是这样，则键入`yes`：

> Hi username! You've successfully authenticated, but GitHub does not
    > provide shell access.

您可能会看到以下错误信息：

...
    Agent admitted failure to sign using the key.
    debug1: No more authentication methods to try.
    Permission denied (publickey).

这是某些Linux发行版的已知问题。有关更多信息，请参阅[“错误：代理承认未能签名”。][Link 1]

*  验证生成的消息是否包含您的用户名。如果您收到“permission denied【权限被拒绝】”消息，请参阅[“Error: Permission denied (publickey)【错误：权限被拒绝（公钥）”】。][Error_ Permission denied _publickey]

#### 三、常见问题处理 ####

经常与会遇到下面这种情况，我也很纳闷，每次都解析到不到域名和地址

ssh: Could not resolve hostname git.oschina.net: 
    nodename nor servname provided, or not known

> 查资料之后的解决办法是：  
> step1.  
> `ping address`  
> 获取到对于地址的ip  
> step2. 在/etc/hosts中添加一行如下:  
> ip address  
> `xxxxxxxxxx`  
> 这样就可以玩起来了。

[0bd4488f22b942d49a1364981024faff.png]: https://img-blog.csdnimg.cn/0bd4488f22b942d49a1364981024faff.png
[RSA]: https://links.jianshu.com/go?to=https%3A%2F%2Fdocs.github.com%2Fen%2Fgithub%2Fauthenticating-to-github%2Fgithubs-ssh-key-fingerprints
[Link 1]: https://links.jianshu.com/go?to=https%3A%2F%2Fdocs.github.com%2Fen%2Farticles%2Ferror-agent-admitted-failure-to-sign
[Error_ Permission denied _publickey]: https://links.jianshu.com/go?to=https%3A%2F%2Fdocs.github.com%2Fen%2Farticles%2Ferror-permission-denied-publickey