手把手教你配置GitHub SSH密钥，轻松克隆仓库

一、引言

简要介绍为何需要配置SSH密钥来安全地与GitHub交互，并说明本文将指导读者一步步完成整个过程。

---

二、环境准备

1. 安装Git：

   • 确保你的计算机上已经安装了最新版本的Git。可以通过终端或命令提示符运行 git --version 来检查是否已安装以及其版本号。
   • 如果未安装，请访问 Git官网 并根据操作系统下载安装包。

2. 创建或登录GitHub账户：

   • 如果你还没有GitHub账号，前往 GitHub官网 注册新用户。
   • 登录到现有的GitHub账户。

三、生成SSH密钥对

1. 打开终端/命令行工具：

   • Windows用户可使用Git Bash或PowerShell。
   • macOS/Linux用户直接打开终端应用。

2. 生成新的SSH密钥对（如果尚未生成）：

   • 在终端中输入以下命令，按提示操作。这里我们将为密钥指定一个标签（如邮箱），以便识别：

     ssh-keygen -t ed25519 -C "your_email@example.com"

   • 注意：如果你的系统不支持 ed25519，你可以使用更常见的RSA算法，只需将 -t ed25519 替换为 -t rsa。

3. 保存密钥文件：

   • 按回车接受默认路径（通常是 ~/.ssh/id_ed25519 或 ~/.ssh/id_rsa），或者选择其他位置。
   • 设置密码保护（可选但推荐），这将增加安全性。
   • 如果不设置，密码按回车即可

四、启动SSH代理并添加私钥

1. 启动SSH代理：

   • 对于大多数Linux和macOS系统，可以直接在终端中输入：

     eval "$(ssh-agent -s)"

   • Windows用户可以在Git Bash中执行相同命令，或在PowerShell中使用 Start-Service ssh-agent 启动服务。

2. 添加私钥到SSH代理：

   • 使用下面的命令添加刚生成的私钥：

     ssh-add ~/.ssh/id_ed25519

   • 如果你在不同的位置保存了私钥，请替换上述路径为实际路径。

---

五、添加SSH公钥到GitHub

1. 复制公钥内容：

   • 打开公钥文件（如 ~/.ssh/id_ed25519.pub），复制其中的所有文本。如打开Powershell，输入以下指令，查看公钥文件内容，内容全部复制

   • cat ~/.ssh/id_ed25519.pub

2. 登录GitHub并添加SSH密钥：

   • 访问 GitHub SSH and GPG keys页面。
   • 点击“New SSH key”按钮。
   • 在“Title”字段中给这个密钥起个名字，例如“Personal Laptop”。
   • 将之前复制的公钥粘贴到“Key”字段中。
   • 点击“Add SSH key”。

---

六、验证SSH连接

1. 测试连接：

   • 使用以下命令测试是否能成功通过SSH连接到GitHub：

     ssh -T git@github.com

   • 如果一切正常，你应该会看到一条欢迎信息，表明你已经成功地用SSH连接到了GitHub。

如果有问题，补充config文件，在.ssh/目录下创建config文件

Host github.com
Hostname ssh.github.com
Port 443
User git
IdentityFile ~/.ssh/id_rsa_github 

IdentityFile ~/.ssh/id rsa github
这里是私钥的路径

---

七、克隆GitHub仓库

1. 获取仓库的SSH URL：

   • 在GitHub项目页面，点击“Code”按钮，选择“SSH”，然后复制URL。

2. 克隆仓库：

   • 在本地终端中，导航到你想存放代码的位置，然后运行：

     git clone git@github.com:用户名/仓库名.git

   • 用实际的用户名和仓库名称替换占位符。