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

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

引用

CSDN

1.

https://blog.csdn.net/m0_74957207/article/details/144754914

在使用GitHub进行代码管理时，配置SSH密钥可以让你更安全、便捷地与GitHub仓库进行交互。本文将手把手教你完成SSH密钥的配置过程，包括环境准备、生成SSH密钥对、添加SSH公钥到GitHub账户，以及最终验证连接和克隆仓库。

一、引言

简要介绍为何需要配置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
  

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