MAC/LINUX GIT/GITLAB SSH 配置

朱雀 2021-04-13 17:24 603阅读 0赞

## ssh公钥登录 ##

一般在管理远程主机时，都用ssh登录，`ssh user@host`，但是这样每次会使用密码。 使用`ssh-keygen`生成的密钥对，然后将公钥添加的目标主机的`~/.ssh/authorized_keys`文件中，当前主机就成为可信任的主机，下次使用ssh登录时，就不用输入密码了。

Gitlab，Github都支持这种方式的连接，具体操作步骤如下：

#### 第一步:生成密钥对 ####

进入主目录`cd ~/.ssh`, 如果不存在则在主目录`cd ~`下新建.ssh文件夹，然后使用`ssh-keygen`生成密钥对:`ssh-keygen -t rsa -C "你的邮箱"`，这样就在主目录下的`.ssh`目录中生成了两个文件`id_rsa`和`id_rsa.pub`。`id_rsa`中保存的是私钥，`id_rsa.pub`中保存的是公钥。如果你已经有了一套名为 `id_rsa` 的公秘钥，可以生成另外一对公私钥，比如 `id_rsa_xx` ，`id_rsa_xx.pub`，你也可以使用任何你喜欢的名字。

步骤如下：

#### 第二步:生成公私钥 ####

1、生成一个新的自定义名称的公私钥：

ssh-keygen -t rsa -C "你的邮箱地址" -f ~/.ssh/id_rsa_xx

三次回车，执行完成后，会在 ~/.ssh/目录下生成一个 `id_rsa_xx` 和 `id_rsa_xx.pub` 文件。

#### 第二步:添加公钥 ####

拷贝公钥到剪切板:mac下命令`pbcopy < id_rsa.pub`，Linux下命令`cat < id_rsa.pub` ，后在个人资料->SSH Keys->Add new 页面中粘贴公钥，就添加完成了。

#### 第三步:测试 ####

ssh加`-T`选项测试目标服务是否可用:

1.  `ssh -T git@"你的gitlab服务器地址"`

第一次连接时，会询问是否信任主机，确认后输入yes。如果看到`Welcome to GitLab, Rusher!`就算配置成功了，接下来就可以通过ssh来提交代码了。

> **Windows**
> 
> 1.  下载 [Git-Bash][]
> 2.  生成密钥对`ssh-keygen -t rsa -C "你的邮箱"`
> 3.  生成之后用 `notepad c:/User/Administrator/.ssh/id_rsa.pub` 打开文件，然后将公钥添加的Gitlab中.
> 4.  测试 `ssh -T git@"你的gitlab服务器地址"`

## 扩展：ssh多用户切换 ##

在配置Gitlab的时候一开始是用管理员账户做测试的，后来建了我自己的账号做开发。这样我的本地就有两个Gitlab账号，如果直接用ssh来提交代码有问题，因为ssh默认使用一开始生成id\_rsa那个密钥对，但不同的账号又不能对应到同一个公钥上。如果多个账户一起用，还需要做些配置。

假如有两个账号：root和rusher。

#### 第一步:为两个账户分别生成密钥对 ####

提示在哪里存储密钥文件的时候，对不同的账号填不同的路径，root放在`/Users/you/.ssh/id_rsa_gitlab_root`下，guest的放在`/Users/you/.ssh/id_rsa_gitlab_guest`

# 1、生成guest用户的公私钥
    ssh-keygen -t rsa -C "guest@you.com" -f ~/.ssh/id_rsa_gitlab_guest
    
    
    # Generating public/private rsa key pair.
    # Enter file in which to save the key (/Users/you/.ssh/id_rsa): /Users/you/.ssh/id_rsa_gitlab_guest
    # Enter passphrase (empty for no passphrase):
    # Enter same passphrase again:
    # Your identification has been saved in /Users/you/.ssh/id_rsa_gitlab_guest.
    # Your public key has been saved in /Users/you/.ssh/id_rsa_gitlab_guest.pub.
    
    
    # 2、生成root用户的公私钥
    ssh-keygen -t rsa -C "root@you.com" -f ~/.ssh/id_rsa_gitlab_root
    
    
    # Generating public/private rsa key pair.
    # Enter file in which to save the key (/Users/you/.ssh/id_rsa): /Users/you/.ssh/id_rsa_gitlab_root
    # Enter passphrase (empty for no passphrase):
    # Enter same passphrase again:
    # Your identification has been saved in /Users/you/.ssh/id_rsa_gitlab_root.
    # Your public key has been saved in /Users/you/.ssh/id_rsa_gitlab_root.pub.

#### 添加ssh代理: ####

查看系统ssh-key代理,执行如下命令

ssh-add -l

以上命令如果报错`Could not open a connection to your authentication agent.`则执行命令`ssh-agent bash`；如果输出 `The agent has no identities.` 则表示没有代理。如果系统有代理，可以执行下面的命令清除代理:

ssh-add -D

之后执行如下命令添加代理。

# 将guest用户添加到ssh代理
    ssh-add /Users/you/.ssh/id_rsa_gitlab_guest
    
    # 将root用户添加到ssh代理
    ssh-add /Users/you/.ssh/id_rsa_gitlab_root

执行以上命令将看到如下信息你会分别得到如下提示：

2048 8e:71:ad:88:78:80:b2:d9:e1:2d:1d:e4:be:6b:db:8e /Users/aysee/.ssh/id_rsa (RSA)

和

2048 8e:71:ad:88:78:80:b2:d9:e1:2d:1d:e4:be:6b:db:8e /Users/aysee/.ssh/id_rsa (RSA)
    
    2048 8e:71:ad:88:78:80:b2:d9:e1:2d:1d:e4:be:6b:db:8e /Users/aysee/.ssh/id_rsa (RSA)

#### 第二步:添加ssh配置文件 ####

在.ssh目录中添加`config`文件，此文件的为不同的账户添加别名(root: root\_gitlab 和 guest: guest\_gitlab)，连接还是同一个服务器，但是使用不同的密钥文件，所以才能将两个账号分开。

# for root
    Host root_gitlab
    HostName git.you.com
    User root
    IdentityFile /Users/you/.ssh/id_rsa_gitlab
    
    # for guest
    Host guest_gitlab
    HostName git.you.com
    User guest
    IdentityFile /Users/you/.ssh/id_rsa_gitlab_guest

配置完成后，使用别名测试，可以查看是否对应到了正确的账号上：

ssh -T git@root_gitlab
    
    ssh -T git@guest_gitlab

你会得到如下提示，表示这个ssh公钥已经获得了权限

The authenticity of host 'gitlab.com (192.168.16.189)' can't be established.
    ECDSA key fingerprint is SHA256:HbW3g8zUjNSksFbqTiUWPWg2Bq1x8xdGUrliXFzSnUw.
    ECDSA key fingerprint is MD5:f1:d0:fb:46:73:7a:70:92:5a:ab:5d:ef:43:e2:1c:35.
    Are you sure you want to continue connecting (yes/no)? yes
    Warning: Permanently added 'guest_gitlab,192.168.16.189' (ECDSA) to the list of known hosts.

如果报`Bad owner or permissions on /home/you/.ssh/config`错误，则执行命令`sudo chmod 600 /home/you/.ssh/config` 解决

#### 第三步:在git项目中使用别名 ####

正常的项目，我们clone下来之后，origin对应的URL假设为: `git@git.you.com:project/helloworld`，现在需要做个改动，将`git.you.com`要换成`guest_gitlab`,

git remote set-url origin git@guest_gitlab:project/helloworld

如果是root用户的项目:

git remote set-url origin git@root_gitlab:project/helloworld

## Gitlab服务端配置 ##

(只使用客户端可忽略这节内容)

在客户端提交时发现以下错误：

/usr/local/lib/ruby/1.9.1/net/http.rb:762:in `initialize': getaddrinfo: Name or service not known (SocketError)
    from /usr/local/lib/ruby/1.9.1/net/http.rb:762:in `open'
    from /usr/local/lib/ruby/1.9.1/net/http.rb:762:in `block in connect'
    from /usr/local/lib/ruby/1.9.1/timeout.rb:54:in `timeout'
    from /usr/local/lib/ruby/1.9.1/timeout.rb:99:in `timeout'
    from /usr/local/lib/ruby/1.9.1/net/http.rb:762:in `connect'
    from /usr/local/lib/ruby/1.9.1/net/http.rb:755:in `do_start'
    from /usr/local/lib/ruby/1.9.1/net/http.rb:744:in `start'
    from /home/git/gitlab-shell/lib/gitlab_net.rb:64:in `get'
    from /home/git/gitlab-shell/lib/gitlab_net.rb:30:in `check'
    from ./check:11:in `<main>'

在Github的issue里找到说先运行一下`/home/git/gitlab-shell/bin/check` 。先做检测，发现和上面一样的错误。看错误是找不到域名，所以在`/etc/hosts`中需要配置一个地址的映射。

127.0.0.1 YOUR_DOMIN # YOUR_DOMIN是在/home/git/gitlab-shell/config.yml中配置的gitlab_url

以上配置ssh的方法同样适用于Github,Bitbucket等网站。

## 参考文档 ##

*  [Github Help][]

UPDATE 2013-08-16: 为不同账号生成密钥对后，需要使用ssh-add将密钥添加进来，否则ssh不能使用正确的密钥

[Git-Bash]: https://code.google.com/p/msysgit/downloads/detail?name=Git-1.8.3-preview20130601.exe&can=2&q=full+installer+official+git
[Github Help]: https://help.github.com/articles/generating-ssh-keys