多账号配置SSH


简书地址 : 多账号配置SSH

博客地址 : 多账号配置SSH

掘金地址 : 多账号配置SSH


快捷说明

熟练者忘记查询, 详细解析在下面模块

$ cd ~/.ssh                             // 进入文件夹
$ ssh-keygen -t rsa -C "邮箱地址"       // 配置密钥对
$ ssh-add rsa文件的路径/xxx_rsa          // 添加配置
$ git config --global(local) user.name "你的名字"
$ git config --global(local) user.email "你的邮箱"
$ vim ~/.ssh/config                     // 添加新的账号配置

背景介绍

为什么要配置SSH

作为一个正常上班搬砖程序猿,Git 应该是目前主流的代码管理工具,而Git在提交时有两种方式:Https 和 SH 两种验证方式。

  • Https : 输入账号密码,每次都要输入(麻烦,程序猿从来不做重复工作)
  • SSH : 提交代码时通过GIT服务器的公钥与本地私钥做验证。(配置一次,无须每次输入账号密码)

SSH(简单原理说明)

生成一对公钥-私钥,公钥添加到Git服务器,私钥放在本地。提交代码时通过GIT服务器的公钥与本地私钥做验证,如果验证通过则提交成功,简单说就是把账号和密码托管给SSH, 账号就像我们的QQ号码,是公开的可见的,密码只有我们自己知道,本地私钥就是代码我们输入密码的过程,切安全。

1. 生成SSH-KEY

1.1 打开命令行(终端),测试终端是否支持SSH

```
$ ssh -V
```
  • 如果支持,可能看到类似以下版本信息:

    OpenSSH_7.4p1, LibreSSL 2.5.0
    
  • 测试如果不识别SSH,则需要另行安装,Mac默认带有ssh,不需要安装

1.2 生成公钥私钥

  • 用命令行进入存放ssh的文件夹,然后输入指令,引号内输入你Git的的邮箱地址

    $ cd ~/.ssh
    $ ssh-keygen -t rsa -C "邮箱地址"
    

    接下来会提示:

    Generating public/private rsa key pair.
    Enter file in which to save the key (~/.ssh/id_rsa):
    Enter passphrase (empty for no passphrase):
    Enter same passphrase again: 
    
  • 生成ras的公钥私钥对

    输入保存这个Key的地址,一般直接输入文件名就好(也可以输入绝对路径),即在当前目录下的名字,为了区分一般可以按照用途起名,比如company_xx,之后会提示你输入管理该密钥对的密码,这里会输入两次校验,根据需要自己输入, 完成后即创建成功,会提示类似如下信息

    Your identification has been saved in xxxGitHub.
    Your public key has been saved in xxxGitHub.pub.
    The key fingerprint is:
    SHA256:7KVBN59ZHVBky18lBoBnBfhRQXY579Njn6JsYXHm1IA  xxx@qq.com
    The key's randomart image is:
    +---[RSA 2048]----+
    |        s oo*O+B*.|
    |        o + +=o+|
    |        .+o.  +=o|
    |       o ..+ B .+|
    |        S  .o|
    |       . + o . +|
    |        o . . . =|
    |          .. . ..|
    |          .o. .  |
    +----[SHA256]-----+
    
  • 此时在终端输入ls,则会看到当前目录已经有了我们生成好的公钥私钥文件xxxGitHub xxxGitHub.pub, .pub文件即是公钥

```
$ls
xxxGitHub     xxxGitHub.pub
```

2. 单个账号的配置 -- 全局Git配置

大部分人使用Git一般是一个账号

因为一般自己笔记本维护自己的github, 公司电脑维护公司的git, 所以先介绍单个git账号配置

2.1 将生成的SSH-KEY分别配置给服务器和本地。

  • 将第一步生成的xxx.pub 公钥中的内容添加到git的SSH中,即在网页上GitHub或Gitlib的设置(setting)中可以找到ssh这个菜单项。

  • 把SSH-KEY配置给SSH,让系统SSH知道这个KEY,如果你是在其他文件夹中生成的密钥对必须 拷贝到~/.ssh文件夹 中,然后输入如下指令,将当前rsa私钥(不带.pub文件) 添加到SSH-Agent.

    $ ssh-add rsa文件的路径/xxx_rsa
    

输入后会校验之前我们在上面 1.2 步骤中设置的密钥密码,校验成功后会提示 Identity added: xxx_rsa (xxx_rsa)

如果设置失败,首先检查当前目录是否为 **~/.ssh**, 然后如果提示如下,请执行`eval $(ssh-agent)` 后再重新添加,如果还不行,请执行`ssh-agent bash`再次尝试添加,如果还有问题请另行查阅,本文主要介绍配置多个ssh.

```
Could not open a connection to your authentication agent.
```

2.2 配置Git全局用户和邮箱:(邮箱为你git对应的邮箱)

$ git config --global user.name "你的名字"
$ git config --global user.email "你的邮箱"

配置完成后可打开 ~/.gitconfig查看配置

$ vim ./gitconfig

内容大致如下

[user]
    name = xxx
    email = xxx@foxmail.com

此时单个账号配置全部结束

3. 多个Git帐号的配置——局部Git配置

大部分人使用Git一般是一个账号, 所以步骤2中可以完成,但是如果你考虑到以后可能维护多个,或者像本人想在公司电脑里使用公司邮箱的gitlab与自己的github一起,这时就需要配置多个私钥对。

3.1 上面配置ssh密钥对 1.2 时提到起名防止冲突,所以这里不再介绍,反正原则就是一个账号对应一对密钥(xx, xx.pub).

3.2 接下来服务器添加公钥步骤同2.1中添加公钥的步骤,第二部为SSH配置私钥位置时和上面方法不同,我们需要在.ssh文件夹中新建一个config的文件(名字可以自己取,但是不要有冲突和当前目录下), touch config ,然后通过指令vim config进入config文件,键盘敲击小写字母a进入编辑模式,输入如下内容:

Host gitlib.com
    HostName gitlib.com
    User xxx@foxmail.com
    PreferredAuthentications publickey
    IdentityFile id_rsa_gitlib
Host oschina.com
    HostName oschina.com
    User xxx@foxmail.com
    PreferredAuthentications publickey
    IdentityFile /D/Workspace/ssh/id_rsa_oschina
Host 192.168.1.222
    HostName 192.168.1.222
    User xxx@foxmail.com
    PreferredAuthentications publickey
    IdentityFile /D/Workspace/ssh/id_rsa_oschina

注意:

  • HostName是服务器的地址,User是用户名,PreferredAuthentications照抄即可,这里主要说的是IdentityFile,上面我们看到了三种情况,所以它的书写原则是:

    • 填私钥文件的本地路径。
    • 不论是Linux还是Windows都可以写相对路径,比如把id_rsa_xxx私钥文件放在.ssh文件夹下。
    • 文件放在不同跟路径下时,需要写绝对路径
  • HostName 不可带http或https开头

3.3 将所有的id_rsa私钥文件添加到SSH-Agent

3.4 最后,配置局部邮箱
在上面步骤我们配置了全局的邮箱即如果是通过该邮箱的项目ssh的配对已经完成,如果是其他账户的项目则需要进入该仓库文件夹后配置,配置命令如下:

$git config --local user.name "你的名字"
$git config --local user.email "你的邮箱"

配置成功后,我们可以进入项目文件夹下的.git文件夹查看config文件内容,大概内容如下:

...
[user]
    name = xxx
    email = xxx@foxmail.com

此时配置全部结束,请查看下方测试SSH-KEY配置是否成功进行测试。如果配置成功,你就可以clone和commit了。

4. 测试SSH-KEY配置是否成功

  • 如果你是Github:
$ ssh -T git@github.com
  • 如果你是Gitlib:
$ ssh -T git@gitlib.com
  • 如果你是局域网10.12.22.201
$ ssh -T git@10.12.22.201
  • 其他自行递归解决
$ ssh-add rsa私钥文件的路径

推荐阅读更多精彩内容

  • 问题描述 公司要求项目的git账号必须使用公司邮箱,而我平时写的一些小demo肯定是用的自己的邮箱绑定的账号,这样...
    Tony_Yang阅读 557评论 0 2
  • 之所以写这篇文章是为了解决git 提交不成功,同时做个记录方便以后遇到同样的问题可以顺利解决。网上教程有很多,此处...
    ColaBean阅读 90评论 0 1
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 70,869评论 12 116
  • 今天第一天开始上班,没有任务,于是开始学习Git这一程序猿必须掌握之技能,希望今天的积累过后,对与Git或者...
    CoderTung阅读 5,060评论 2 91
  • 1. 安装 Github 查看是否安装git: $ git config --global user.name "...
    Albert_Sun阅读 7,626评论 7 154