GitHub 与 Gitee 多平台 SSH Key 配置指南

文章目录

• • [💡 引言：为何需要配置 SSH Key？](#💡 引言：为何需要配置 SSH Key？)
  • [🧩 第一步：为不同平台生成专属 SSH Key](#🧩 第一步：为不同平台生成专属 SSH Key)
  • • [1. 打开 Git Bash](#1. 打开 Git Bash)
    • [2. 检查并进入 `.ssh` 目录](#2. 检查并进入 .ssh 目录)
    • [3. 生成 SSH Key](#3. 生成 SSH Key)
  • [🔑 第二步：将公钥添加到对应平台](#🔑 第二步：将公钥添加到对应平台)
  • • [1. 获取公钥内容](#1. 获取公钥内容)
    • [2. 添加到 GitHub](#2. 添加到 GitHub)
    • [3. 添加到 Gitee](#3. 添加到 Gitee)
  • [⚙️ 第三步：创建 `config` 文件管理多平台密钥](#⚙️ 第三步：创建 config 文件管理多平台密钥)
  • • 创建并编辑配置文件
  • [🧪 第四步：测试 SSH 连接](#🧪 第四步：测试 SSH 连接)
  • • [1. 测试 Gitee 连接](#1. 测试 Gitee 连接)
    • [2. 测试 GitHub 连接](#2. 测试 GitHub 连接)
  • [✅ 总结](#✅ 总结)

关键词：Git、GitHub、Gitee、SSH、SSH Key、多平台配置、免密登录、版本控制

• git常用命令及仓库创建

---

💡 引言：为何需要配置 SSH Key？

在使用 Git 进行版本控制时，我们通常通过 HTTPS 或 SSH 协议与远程仓库（如 GitHub、Gitee）通信。

相比每次操作都要输入用户名和密码的 HTTPS 协议，SSH 协议 提供了更高的安全性与便利性。

通过在本地生成一对 公钥（Public Key） 和 私钥（Private Key） ，并将公钥添加到代码托管平台上，你可以实现 免密推送与拉取代码。

当你同时使用 GitHub 和 Gitee 等多个平台时，为每个平台创建独立的 SSH Key 并正确配置，可以有效管理不同平台的身份认证，避免潜在冲突。

本指南将详细介绍如何为 GitHub 和 Gitee 分别生成并配置 SSH Key。

---

🧩 第一步：为不同平台生成专属 SSH Key

1. 打开 Git Bash

在电脑桌面或任意文件夹中，右键点击并选择 "Git Bash Here" 打开终端。

2. 检查并进入 .ssh 目录

执行以下命令进入 SSH Key 存放目录：

cd ~/.ssh

若目录不存在，可手动创建：

mkdir ~/.ssh

3. 生成 SSH Key

使用以下命令分别为 GitHub 与 Gitee 生成独立的 RSA 密钥对：

# 为 GitHub 生成密钥
ssh-keygen -t rsa -C "your_email@example.com" -f "github_id_rsa"

# 为 Gitee 生成密钥
ssh-keygen -t rsa -C "your_email@example.com" -f "gitee_id_rsa"

参数说明：

• -t rsa：指定密钥类型为 RSA
• -C：添加注释（通常是邮箱）
• -f：指定密钥文件名（关键点，用于区分不同平台）

在生成过程中系统会提示输入密码（passphrase），为了方便可直接按 Enter 跳过。

生成成功后，~/.ssh 目录中会出现以下文件：

github_id_rsa        # GitHub 私钥
github_id_rsa.pub    # GitHub 公钥
gitee_id_rsa         # Gitee 私钥
gitee_id_rsa.pub     # Gitee 公钥

---

🔑 第二步：将公钥添加到对应平台

1. 获取公钥内容

使用 cat 命令查看公钥内容：

# 显示 GitHub 公钥
cat ~/.ssh/github_id_rsa.pub

# 显示 Gitee 公钥
cat ~/.ssh/gitee_id_rsa.pub

复制输出的内容（以 ssh-rsa 开头的一长串字符）。

---

2. 添加到 GitHub

1. 登录 GitHub SSH 设置页面(https://github.com/settings/keys)
2. 点击 "New SSH key"
3. 在 Title 中填写标题（如 My Work Laptop）
4. 将复制的公钥内容粘贴到 Key 文本框
5. 点击 "Add SSH key" 完成添加

---

3. 添加到 Gitee

1. 登录 Gitee SSH 公钥页面(https://gitee.com/profile/sshkeys)
2. 在 标题 一栏填写自定义标题
3. 将复制的 Gitee 公钥内容粘贴到 公钥 文本框
4. 点击 "确定" 完成添加

---

⚙️ 第三步：创建 config 文件管理多平台密钥

为了让 SSH 在连接不同主机时自动选择对应的私钥，需要在 ~/.ssh 目录下创建一个配置文件。

创建并编辑配置文件

执行以下命令：

vim ~/.ssh/config

然后添加如下内容：

# Gitee Configuration
Host gitee.com
HostName gitee.com
PreferredAuthentications publickey
IdentityFile ~/.ssh/gitee_id_rsa

# GitHub Configuration
Host github.com
HostName github.com
PreferredAuthentications publickey
IdentityFile ~/.ssh/github_id_rsa

配置说明：

• Host：主机别名
• HostName：实际连接的主机地址
• PreferredAuthentications：优先使用公钥认证
• IdentityFile：指定连接该主机时的私钥路径

这样，当你连接 gitee.com 时会使用 gitee_id_rsa，连接 github.com 时则使用 github_id_rsa。

---

🧪 第四步：测试 SSH 连接

1. 测试 Gitee 连接

ssh -T git@gitee.com

若首次连接提示主机真实性警告，输入 yes 。

若出现如下提示，说明连接成功：

Hi [Your Gitee Username]! You've successfully authenticated...

2. 测试 GitHub 连接

ssh -T git@github.com

同样输入 yes，若返回：

Hi [Your GitHub Username]! You've successfully authenticated...

即表示 GitHub SSH 配置成功。

---

✅ 总结

至此，你已成功在同一台电脑上为 GitHub 与 Gitee 分别配置独立的 SSH Key。

可以在多个平台之间安全、方便地进行免密操作