配置SSH连接Git教程
有了门，我们可以出去；有了窗，我们可以不必出去。——钱钟书《围城》
0 说在前面的话
Git 是个好东西，但是用起来有两个不方便之处：
- 操作时要频繁输密码；
- 连接 github 时由于网速问题经常失败。
使用 ssh 连接便可以解决这样的问题，但奈何本人记性不好，每次配置都要上网查半天教程，于是这次终于下定决心自己总结了。[1]
1 关于 ssh
SSH 是较可靠，专为远程登录会话和其他网络服务提供安全性的协议。[2]使用 SSH 协议可以连接远程服务器和服务并向它们验证。连接远程仓库时无需输入密码而且能实现对 github 的流畅访问。除此之外我还用 ssh 协议成功在 Windows Terminal 中连接上了自己的远程服务器。
2 检查现有的 ssh 密钥
Windows 打开 GitBash，Linux 下打开终端，输入：
$ ls -al ~/.ssh
如果你看到以下输出，那么说明你已经有 ssh 密钥（以 .pub 结尾的文件）：
$ ls -al ~/.ssh
total 26
drwxr-xr-x 1 197121 0 Mar 31 22:29 ./
drwxr-xr-x 1 197121 0 Apr 16 23:36 ../
-rw-r--r-- 1 197121 2610 Mar 31 22:27 id_rsa
-rw-r--r-- 1 197121 573 Mar 31 22:27 id_rsa.pub
-rw-r--r-- 1 197121 831 Apr 1 12:08 known_hosts
-rw-r--r-- 1 197121 92 Mar 31 22:26 known_hosts.old
如果你不想用原来的密钥或者没有密钥的话也不用着急，看下一步如何生成新的 ssh 密钥。
3 创建新的 ssh 密钥
3.1 生成新的 ssh 密钥
在 Windows 的 GitBash 或 Linux 终端输入：
$ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
# 你可以把引号里的替换为你自己的邮箱，不换的话问题不大
然后终端会让你输入一些东西，可以不用输入直接一路回车，看到：
Generating public/private rsa key pair.
Enter file in which to save the key (/root/.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /root/.ssh/id_rsa
Your public key has been saved in /root/.ssh/id_rsa.pub
The key fingerprint is:
SHA256:t3925EJgD4kcUp69dBv/nqkM85n0I5mFRW4BlZwaVeo your_email@example.com
The key's randomart image is:
+---[RSA 4096]----+
| .=o=|
| . . B |
| o + * .|
| . * =oo+ |
| So.B +A+ |
| .o.B.o.o|
| .o o+o.|
| .*+B.*|
| .OoBo|
+----[SHA256]-----+
代表密钥生成成功。
3.2 将SSH密钥添加到ssh-agent
3.2.1 确保 ssh 正在运行
终端输入：
$ eval
$ ssh-agent -s
看到如下输出：
SSH_AUTH_SOCK=/tmp/ssh-xkZRdf3bu6fW/agent.1075848; export SSH_AUTH_SOCK;
SSH_AGENT_PID=1075849; export SSH_AGENT_PID;
echo Agent pid 1075849;
代表 ssh 正常运行。
3.3.3 添加 ssh 到账户
执行以下两条命令：
$ ssh-agent bash
$ ssh-add ~/.ssh/id_rsa # 这里如果文件名被改过要写你自己定义的文件名
看到输出：
Identity added: id_rsa (your_email@example.com)
添加成功！
4 将密钥添加到 github 账户
4.1 复制你的公钥
在终端使用：
$ cat ~/.ssh/id_rsa.pub
看到：
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQDJ6c4cXmpyJr/anagkKz4K+RCFYSJlkFvdNY6JBmKeomrQYfChpDZFxjUkj72XfSAhGyJjPcn4pTHHLCHOS2jzstrvE0Cq19p/mbbvwsq5GGqmzsTYqOeqpTIeEKnXlv/PXkh/mXJVOWhui8esIQk4bU1Ss2wIEVMSRI+9n8RgyBcpbiq4m/SDrUy1HJNHO3pyjcf7k6XUjfxeTRWMVtj7IH3yQbgrZQo90VHsVhkmTeyvaCv8tJLi/j+t9E1/kOWPbpTFTmaAe190SuPVwpQjyRH/Z8UWVdCYxgeZ9l9JN3MTyHfRWz6FuDJdoQze94mU1NwEP8AftHNVTsMT2qvbAYK3Mcr6/j1R1vAeq4mbgn1dp79RGW0cKOSx336WuFsfebMV7QLZ1RnW5xF6VgghMd4x9Hk8kmLL6s8I7ZfbjNCgyAhL9d5N01lsz8hdMv1BHzaZp+yk0EXUy8fxFvaSYaUpQuKb8eL6DesBJJ8FH4GVb6+V7J7OsXhG8QiKdDsDbfGDJs/Aq0Ew14cuHlD9y/1A44b+Kt6WwmcISGG85SM+YUcPuay8gEFzNQ/Tzgw4bJznw0RHHVuvtpmjvlBUxXRTSICvrrAJ19/yXoHcZtiPncpDHVnyIy6IVAg23MCeUbrIPIPKQXVHG/5ouRk0YbkFbl6kSq/Yurb35N7tDQ== your_email@example.com
全给复制下来！
4.2 将公钥添加到 github 账户
然后去 gihub：
- 右上角下拉面板选择 Settings；
- 左侧选择 SSH and GPG keys；
- 点击 New SSH key；
- 随便起一个 title；
- 把公钥粘贴到下面。
可能会输入密码，添加完成！
5 测试 ssh 连接
在终端中输入：
$ ssh -T git@github.com
可能看到如下警告：
The authenticity of host 'github.com (20.205.243.166)' can't be established.
ECDSA key fingerprint is SHA256:p2QAMXNIC1TJYWeIOttrVc98/R1BUFWu3/LiyKgUfQM.
Are you sure you want to continue connecting (yes/no/[fingerprint])?
输入 yes：
Warning: Permanently added 'github.com,20.205.243.166' (ECDSA) to the list of known hosts.
Hi xxxxxx You've successfully authenticated, but GitHub does not provide shell access.
如果 xxxxxx 是你的 github 用户名，说明成功。
6 配置 git 使用 ssh 密钥登录
首先将你的仓库 clone 下来到一个位置。然后进入你的仓库。
6.1 检查当前的 remote url
在仓库下输入：
$ git remote -v
看到输出：
origin https://xxxxx.git (fetch)
origin https://xxxxx.git (push)
说明当前使用的还是 https 协议，如果以 git 开头表示 git 协议。
6.2 修改 remote url 为 git 协议
上 github 仓库，点 Code，选择 SSH，复制链接：
在终端输入：
$ git remote set-url origin git@github.com:xxxxx.git
再检查 git 协议：
$ git remote -v
出现：
origin git@xxxxx.git (fetch)
origin git@xxxxx.git (push)
成功！
接下来可以快乐 push&pull 了。
