GitLab配置ssh key

转载自：https://www.cnblogs.com/hafiz/p/8146324.html

一、背景

　　当前很多公司都选择git作为代码版本控制工具，然后自己公司搭建私有的gitlab来管理代码，我们在clone代码的时候可以选择http协议，当然我们亦可以选择ssh协议来拉取代码。但是网上很少找到如何用git客户端生成ssh key，然后配置在gitlab，我当时在做的时候苦于摸索，后来终于找到了解决方案，那么本文，我们就来聊一聊如何本地git客户端生成ssh key，然后配置在gitlab里，而后使用ssh协议进行提交和拉取git远程仓库的代码。

二、解决方案

1. 打开本地git bash,使用如下命令生成ssh公钥和私钥对

   ssh-keygen -t rsa -C 'xxx@xxx.com' 然后一路回车(-C 参数是你的邮箱地址)

   

2. 然后打开~/.ssh/id_rsa.pub文件(~表示用户目录，比如我的windows就是C:\Users\Administrator)，复制其中的内容

3. 打开gitlab,找到Profile Settings-->SSH Keys--->Add SSH Key,并把上一步中复制的内容粘贴到Key所对应的文本框，在Title对应的文本框中给这个sshkey设置一个名字，点击Add key按钮

　　4. 到此就完成了gitlab配置ssh key的所有步骤，我们就可以愉快的使用ssh协议进行代码的拉取以及提交等操作了

　　5. 再试一下拉取代码和提交代码，应该就不需要输入密码了

三、本地配置多个ssh key

大多数时候，我们的机器上会有很多的git host,比如公司gitlab、github、oschina等，那我们就需要在本地配置多个ssh key，使得不同的host能使用不同的ssh key ,做法如下（以公司gitlab和github为例）：

1. 为公司生成一对秘钥ssh key

   ssh-keygen -t rsa -C 'yourEmail@xx.com' -f ~/.ssh/gitlab-rsa

2. 为github生成一对秘钥ssh key

   ssh-keygen -t rsa -C 'yourEmail2@xx.com' -f ~/.ssh/github-rsa

3. 在~/.ssh目录下新建名称为config的文件（无后缀名）。用于配置多个不同的host使用不同的ssh key，内容如下：

   # gitlab
   Host gitlab.com
       HostName gitlab.com
       PreferredAuthentications publickey
       IdentityFile ~/.ssh/gitlab_id-rsa
   # github
   Host github.com
       HostName github.com
       PreferredAuthentications publickey
       IdentityFile ~/.ssh/github_id-rsa
     ​
   # 配置文件参数
   # Host : Host可以看作是一个你要识别的模式，对识别的模式，进行配置对应的的主机名和ssh文件
   # HostName : 要登录主机的主机名
   # User : 登录名
   # IdentityFile : 指明上面User对应的identityFile路径

4. 按照上面的步骤分别往gitlab和github上添加生成的公钥gitlab_id-rsa.pub和github_id-rsa.pub

5. OK，大功告成，再次执行git命令验证是不是已经不需要再次验证权限了。

6. 再次查看~/..ssh目录下的文件,会有gitlab_id-rsa、gitlab_id-rsa.pub和github_id-rsa、github_id-rsa.pub四个文件

三、总结

　　我们为什么要使用ssh协议呢？因为ssh更加安全，然后更加方便，比如我们公司的gitlab由http协议换成了https协议，那么如果你是使用http协议管理代码，那么需要修改所有的项目中的git地址变成https，这会把我们给逼疯的！但是如果我们一开始就是用ssh协议，这不需要任何的修改，简直不能再爽一点了。

    为了方便大家在移动端也能看到我分享的博文，现已注册个人微信公众号，扫描下方二维码即可，欢迎大家关注，有时间会及时分享相关技术博文。
    感谢您花时间阅读此篇文章,如果您觉得这篇文章你学到了东西也是为了犒劳下博主的码字不易不妨打赏一下吧，让博主能喝上一杯咖啡，在此谢过了！
    如果您觉得阅读本文对您有帮助，请点一下左下角“推荐”按钮，您的“推荐”将是我最大的写作动力！另外您也可以选择【关注我】，可以很方便找到我！
    本文版权归作者和博客园共有，来源网址：http://www.cnblogs.com/hafiz 欢迎各位转载，但是未经作者本人同意，转载文章之后必须在文章页面明显位置给出作者和原文连接，否则保留追究法律责任的权利！

安装Git客户端：详见http://www.cnblogs.com/xiuxingzhe/p/9300905.html

安装git命令行 apt install git

开通gitlab(开通需要gitlab管理员)账号后，本地Git仓库和gitlab仓库仍然不能传输项目，原因是要通过SSH加密才能传输，所以需要让gitlab认证本地的SSH Key

认证之前，则先使用Git生成SSH Key。

1 Git生成秘钥

1.1 确认本地秘钥

SSH 秘钥默认储存在账户的主目录下的 ~/.ssh 目录

如：find -name .ssh

/root/.ssh
/home/www/.ssh

查看是否包含id_rsa和id_rsa.pub(或者是id_dsa和id_dsa.pub之类成对的文件)，有.pub 后缀的文件就是公钥，另一个文件则是密钥。

如果没有这两个文件，甚至.ssh目录也没有，则需要用ssh-keygen 来创建

1.2 生成秘钥信息

• 在.ssh 目录下右键打开Git Bash(.ssh目录不存在，则在任一目录下操作，或者手动创建该目录)

• 生成秘钥：ssh-keygen -t rsa -C "your_email@youremail.com" ，直接Enter就行。直接Enter,然后会提示输入密码(可输可不输),直接Enter

　　   说明：命令中的email，就是gitlab中的账号，需要保持一致

执行完成之后，在.ssh 目录下就会生成秘钥文件（没有.ssh目录的会自动生成，手动创建的则不会重复生成）

2 gitlab秘钥添加

笔者当前所在公司使用的gitlab作为代码管理仓库平台，所以下面是gitlab为例说明如何进行秘钥添加，

2.1登录gitlab

使用申请的gitlab账号登录；确保登录成功

2.2 添加秘钥

• 在搜索框中搜索：SSH Keys

点击 Add SSH Keys

拷贝公钥文件(即1.2中生成的id_rsa.pub)中的信息到key输入框中，title可以随便起，见名知意即可。然后点击Add Keys

至此，git及gitlab相关配置已经全部完成，接下来可以使用git从gitlab上克隆代码来测试相关安装和配置的正确性

3 Git示例

注意：克隆代码之前确保有相关的项目代码权限(master、developer、reporter)，如无权限，请求项目具有master权限的同事帮忙分配权限

输入命令：git clone git@gitlab.baofoo.net:clearing/verify-center.git

首次拉取代码时，需要确认秘钥信息，输入yes即可

项目应用：SSH key提供了一种与GitHub通信的方式，通过这种方式，能够在不输入密码的情况下，将GitHub作为自己的remote端服务器，进行版本控制。

一、检查是否存在SSH key

在控制台输入：

ls ~/.ssh

如果提示没有该目录，或者该目录下没有公私钥文件，说明还未生成过密钥。

如果有文件id_rsa.pub 或 id_dsa.pub，则直接进入步骤3将SSH key添加到GitHub中，否则进入第二步生成SSH key。

二、生成SSH key

在控制台输入：

git config --global  user.name "你的用户名"
git config --global user.email "你的邮箱"

查看已配置信息：

git config --global --list

执行下列命令生成密钥：

ssh-keygen -t rsa -C "你的邮箱"

中途需要进行3次或4次确认：

• 秘钥的保存路径，不更改则直接回车
• 是否覆盖上一次生成的密钥（若之前已经生成过）
• 密码（若不设置则直接回车）
• 确认密码

建议路径使用默认配置，密码不设置。这样每次git push等操作都不需要输入密码，比较方便。

若是用默认路径则在~/.ssh路径下将得到两个文件：id_rsa和id_rsa.pub。

打开~/.ssh/id_rsa.pub文件，复制其中的内容。

三、将ssh key添加到GitHub中

1、打开GitHub，点击右上角个人头像中的Settings

2、将ssh key添加到GitHub：

其中第三步输入框中粘贴刚刚复制的~/.ssh/id_rsa.pub文件中的内容。

配置好后点击Add key，这样SSH key就配置完成了。