GitHub 自动认证教程

## 简介

在使用 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 "[e-mail]"

```

  

按回车后：

1. 选择保存密钥的位置（直接回车使用默认位置）

2. 输入密码短语（可以直接回车不设置密码）

  

## 步骤三：启动 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

1. 登录 GitHub 账号

2. 点击右上角头像 -> Settings

3. 点击左侧菜单 "SSH and GPG keys"

4. 点击 "New SSH key"

5. 填写标题（如：My Laptop）

6. 粘贴刚才复制的公钥内容

7. 点击 "Add SSH key" 保存

  

## 步骤六：测试连接

```bash

ssh -T [e-mail]

```

  

如果看到 "Hi username! You've successfully authenticated..." 的消息，说明配置成功。

  

## 步骤七：更新仓库远程地址

如果之前使用 HTTPS 克隆的仓库，需要更新为 SSH 地址：

  

```bash

# 查看当前远程地址

git remote -v

  

# 更新为 SSH 地址

git remote set-url origin [e-mail]:username/repository.git

```

  

## 注意事项

1. 请妥善保管私钥（id_rsa），不要分享给他人

2. 如果使用多台电脑，需要在每台电脑上都配置 SSH 密钥

3. 建议为 SSH 密钥设置密码，增加安全性

  

## 常见问题

1. 如果遇到 "Permission denied" 错误，检查：

   - SSH 密钥是否正确添加到 GitHub

   - SSH-Agent 是否正在运行

   - 私钥权限是否正确

  

2. 如果遇到 "Connection refused" 错误，检查：

   - 网络连接是否正常

   - 是否能够访问 GitHub

   - 防火墙设置是否正确

  

## 总结

通过以上步骤，您就可以实现 GitHub 的自动认证，无需每次提交代码时都输入密码。这种方式不仅方便，而且比使用密码更安全。