简介
在使用 GitHub 时，为了避免每次提交代码都需要输入用户名和密码，我们可以使用 SSH 密钥进行自动认证。本教程将详细介绍如何设置 SSH 密钥并配置 GitHub 自动认证。
步骤一：检查现有 SSH 密钥
首先，检查您的电脑是否已经存在 SSH 密钥：
```bash
ls -al ~/.ssh
```
如果看到 `id_rsa` 和 `id_rsa.pub` 文件，说明已经存在 SSH 密钥。如果没有，需要生成新的密钥。
步骤二：生成新的 SSH 密钥
如果还没有 SSH 密钥，使用以下命令生成：
```bash
ssh-keygen -t rsa -b 4096 -C "[email protected]"
```
按回车后：
-
选择保存密钥的位置（直接回车使用默认位置）
-
输入密码短语（可以直接回车不设置密码）
步骤三：启动 SSH-Agent
```bash
启动 ssh-agent
eval "$(ssh-agent -s)"
将 SSH 密钥添加到 ssh-agent
ssh-add ~/.ssh/id_rsa
```
步骤四：复制公钥
```bash
Windows
clip < ~/.ssh/id_rsa.pub
macOS
pbcopy < ~/.ssh/id_rsa.pub
Linux
cat ~/.ssh/id_rsa.pub
```
步骤五：添加 SSH 密钥到 GitHub
-
登录 GitHub 账号
-
点击右上角头像 -> Settings
-
点击左侧菜单 "SSH and GPG keys"
-
点击 "New SSH key"
-
填写标题（如：My Laptop）
-
粘贴刚才复制的公钥内容
-
点击 "Add SSH key" 保存
步骤六：测试连接
```bash
ssh -T [email protected]
```
如果看到 "Hi username! You've successfully authenticated..." 的消息，说明配置成功。
步骤七：更新仓库远程地址
如果之前使用 HTTPS 克隆的仓库，需要更新为 SSH 地址：
```bash
查看当前远程地址
git remote -v
更新为 SSH 地址
git remote set-url origin [email protected]:username/repository.git
```
注意事项
-
请妥善保管私钥（id_rsa），不要分享给他人
-
如果使用多台电脑，需要在每台电脑上都配置 SSH 密钥
-
建议为 SSH 密钥设置密码，增加安全性
常见问题
- 如果遇到 "Permission denied" 错误，检查：
-
SSH 密钥是否正确添加到 GitHub
-
SSH-Agent 是否正在运行
-
私钥权限是否正确
- 如果遇到 "Connection refused" 错误，检查：
-
网络连接是否正常
-
是否能够访问 GitHub
-
防火墙设置是否正确
总结
通过以上步骤，您就可以实现 GitHub 的自动认证，无需每次提交代码时都输入密码。这种方式不仅方便，而且比使用密码更安全。