Git服务器添加ssh key

## ssh key 是用来干嘛的

用来免输密码登录远程主机的。ssh key含私钥和公钥，私钥和公钥是相对应的，所以称密钥对。将公钥添加的目标主机的~/.ssh/authorized_keys文件中，当前主机就成为可信任的主机，下次使用ssh登录时，就不用输入密码了。

--------------------------------

# Mac系统

## Mac系统生成ssh key
生成单个ssh参考：
[【CSDN】Gitlab配置ssh连接](http://blog.csdn.net/black_ox/article/details/17753943)
需要生成多个不同的ssh参考：
[【简书】管理git生成的多个ssh key](http://www.jianshu.com/p/f7f4142a1556)

两篇对照着看，会更容易理解。以下内容是对这两篇文章的整理和补充。

扩展阅读：
[是否必须每次添加ssh-add](https://segmentfault.com/q/1010000000835302)
[ssh-add命令](http://man.linuxde.net/ssh-add)

生成ssh key操作是通过Mac的终端完成的。为避免歧义，下面的Mac终端命令行中，使用“【】”（中文方括号）标记需要用户自定义的内容，你需要用自己的内容将方括号及方括号里的示范内容替换掉。

### 用到的Mac终端命令
* 进入目录：cd 【目录名】
* 进入用户根目录：cd ~
* 返回上一个目录：cd ..
* 列出当前目录下的文件及文件夹，不包括隐藏的文件及文件夹：ls
* 列出当前目录下的所有文件及文件夹，包括隐藏得文件及文件夹：ls -al
* 删除空目录：rmdir 【目录名】
* 删除非空目录：rm -r 【目录名】
* 删除文件：rm 【文件名】
* 复制文件里的内容到剪切板：pbcopy < 【文件名】
* 创建空文件：touch 【文件名.扩展名】
* 打开文件或文件夹：open 【文件名.扩展名或文件夹名称】

### 查看ssh密钥
通常ssh密钥都保存在用~/.ssh目录中，如果你不确定之前是否生成过

### 生成ssh key

#### 1. 生成密钥对
在终端中输入：
```bash
ssh-keygen -t rsa -C "【邮箱】"
```
或者：
```bash
ssh-keygen -t rsa
```
#### 2. 给密钥对命名
回车，终端会显示以下文字：
```
Enter file in which to save the key (/Users/bmbm/.ssh/id_rsa): 
```
这是提示你输入保存的全路径（即：目录/文件名.扩展名），如果不输入直接回车，则默认以“id_rsa”命名密钥对文件，并保存在“.ssh”目录下。括号中即是默认保存的全路径。

如果原来已经有“id_rsa”密钥对，则会将其覆盖。如果没有，则“.ssh”目录下会产生两个文件，一个是私钥文件“id_rsa”，一个是公钥文件“id_rsa.pub”。你可以使用`ls`命令查看。

如果不想覆盖之前的密钥对，或者有多个账户要配置，可以输入你想要的文件名，如：
```
Enter file in which to save the key (/Users/bmbm/.ssh/id_rsa): /Users/bmbm/.ssh/id_rsa_github
```
回车，则“.ssh”目录下就会生成密钥对文件“id_rsa_github”和“id_rsa_github.pub”。

回车后终端会提示输入密码，一般不需要，否则每次使用ssh都要输密码。所以给密钥对命名步骤完成后，再两次回车，跳过输入密码的步骤。

#### 3. 将私钥添加到ssh-agent中
见扩展阅读
[ssh-add命令](http://man.linuxde.net/ssh-add)
[是否必须每次添加ssh-add](https://segmentfault.com/q/1010000000835302)

如果密钥对的文件名是默认的话可以忽略这一个步骤。（或者在“.ssh”目录中配置config文件也可以忽略这一步骤？）
```
ssh-add 【~/.ssh/id_rsa_github】
```

#### 4. 添加ssh配置文件
多个账户时使用，只有一个账户且使用默认文件名的话忽略这一步骤。
进入“.ssh”目录，使用`touch config`命令创建一个文件名为“config”的空文件，使用`open config`打开该文件，将类似于下方的配置内容写入其中。（Window系统是创建“config.config”文件）
```
# gitlab
Host 【hostAlias1//主机别名】
    HostName 【git.you.com //这里填你们公司的git网址即可】
    PreferredAuthentications publickey
    IdentityFile 【~/.ssh/id_rsa_gitlab//私钥全路径】
    User 【git//用户名】
# github
    Host 【hostAlias2//主机别名】
    HostName github.com
    PreferredAuthentications publickey
    IdentityFile 【~/.ssh/id_rsa_github//私钥全路径】
    User 【git//用户名】
```

### 5. 将公钥粘贴到git服务器中
打开公钥文件（扩展名为“.pub”的文件），复制里面的内容，复制到git服务器中。因为“.ssh”是隐藏文件夹，直接从Finder中可能不好找，可以使用终端执行`open ~/.ssh/id_rsa.pub`命令直接打开，或者用`pbcopy < ~/.ssh/id_rsa.pub`命令直接复制到剪切板。

### 6. 测试

使用以下命令验证：
```
ssh -T git@【主机别名，如果没配置主机别名，则输入主机地址，如“github.com”】
```

如果要显示日志，则使用以下命令：
```
ssh -vT git@【主机别名，如果没配置主机别名，则输入主机地址，如“github.com”】
```
第一次连接时，会询问是否信任主机，确认后输入yes。
根据返回的信息判断是否配置成功，类似于“Welcome to GitLab, xxx!”，则表明配置成功。

## 在不同本地仓库中使用不同账户
如果之前已经设置了全局的用户名和密码的话，需要重置以下：
```
git config --global --unset user.name
git config --global --unset user.email
```
再在不同的本地仓库下执行以下命令，设置局部用户名和邮箱：
```
git config user.name "【用户名】"
git config user.email "【邮箱】"
```
如果同一个git服务器的主机设置了不同别名，在项目的仓库中要将别名设置到项目的远程地址中：
```
git remote set-url origin git@【hostAlias1】:【root/helloworld】
```

## Mac配置ssh示例
```
banmabanmadeMacBook-Pro:~ bmbm$ ssh-keygen -t rsa -C "xxxx@xxxx.com"
Generating public/private rsa key pair.
Enter file in which to save the key (/Users/bmbm/.ssh/id_rsa): 
Created directory '/Users/bmbm/.ssh'.
Enter passphrase (empty for no passphrase): 
Enter same passphrase again: 
Your identification has been saved in /Users/bmbm/.ssh/id_rsa.
Your public key has been saved in /Users/bmbm/.ssh/id_rsa.pub.
The key fingerprint is:
。。。。。。
The key's randomart image is:
。。。。。。
banmabanmadeMacBook-Pro:~ bmbm$ cd ~/.ssh
banmabanmadeMacBook-Pro:.ssh bmbm$ ls
id_rsa    id_rsa.pub
banmabanmadeMacBook-Pro:.ssh bmbm$ pbcopy < ~/.ssh/id_rsa.pub
banmabanmadeMacBook-Pro:.ssh bmbm$ ssh -T git@xxxx.com
```

------------------------------------

# Windows系统
Windows系统生成ssh-key的步骤和Mac系统的思路是一样的，只是命令行有所差别，比如进入用户根目录不能用“cd ~”命令。Windows使用的是dos命令，Mac使用的是bash命令，Windows的目录是用“\”符号隔开，Mac的目录是用“/”符号隔开。具体过程不再赘述。

## ssh-add命令
一般远程仓库连接不上的原因是还没将密钥文件加载到缓冲中，特别是密钥文件名不是默认文件名的情况下，更需要使用ssh-add命令。我使用dos命令行执行“ssh-add”命令总是失败，于是用bash命令行执行。以下按照bash命令行的方式说明。

### 方式一
确保已经配置了git的环境变量（即将git安装目录下的bin文件夹路径——含bin本身，配置到环境变量中），打开cmd.exe程序，执行“bash”命令，或“bash --login -i”命令，即挂起了git hash 程序，然后执行以下bash命令行：
```bash
ssh-agent
ssh-add ~/.ssh/【id_rsa】
```

### 方式二
直接打开git bash程序，执行以下bash命令行：
```bash
ssh-agent
ssh-add ~/.ssh/【id_rsa】
```