SSH 公钥配置指南：同时访问 GitHub 和 Gitee

本文详细解释如何配置 SSH，让同一台机器可以同时向 GitHub 和 Gitee 推送代码。

一、SSH 公钥认证原理

1.1 核心概念

SSH 公钥认证是一种"锁和钥匙"的机制：

| 你的电脑 |
| ------ |

| GitHub 服务器 |
| ------ |

一个公钥可以同时添加到多个平台——因为公钥是用来"验证"你的，不是平台专属的。

1.2 为什么需要 SSH 而不是 HTTPS

方式	每次操作需要	适用场景
HTTPS URL	用户名 + 密码（或 Token）	临时访问、公共电脑
SSH URL	无需手动输入（自动用私钥认证）	日常开发、自动化脚本

我们的仓库用的是 SSH URL：

git@github.com:wuqing1982/hermes-skills.git
git@gitee.com:hqking22/hermes-skills.git

二、配置步骤

Step 1：检查是否已有 SSH 密钥

ls ~/.ssh/

情况 A：有密钥文件

id_ed25519      ← 私钥
id_ed25519.pub  ← 公钥
known_hosts

情况 B：没有任何 .ssh 目录或密钥文件

→ 跳到 Step 2 生成新密钥

Step 2：生成新的 SSH 密钥

ssh-keygen -t ed25519 -C "你的邮箱地址" -f ~/.ssh/id_ed25519

参数解释：

-t ed25519：使用 Ed25519 算法（目前最安全、兼容性最好的算法）
-C "邮箱"：给密钥加个注释，方便识别这个密钥是谁的
-f ~/.ssh/id_ed25519：指定密钥文件存放位置

执行后终端会显示：

Generating public/private ed25519 key pair.
Enter file in which to save key (/home/hqking/.ssh/id_ed25519):  ← 直接回车
Enter passphrase (empty for no passphrase):                       ← 输入密码（可以留空直接回车）
Enter same passphrase again:                                      ← 再输入一次

建议 passphrase 留空——否则每次 push 都要输入密码，反而麻烦。

生成结果：

Your identification has been saved in /home/hqking/.ssh/id_ed25519
Your public key has been saved in /home/hqking/.ssh/id_ed25519.pub

Step 3：查看并复制公钥

cat ~/.ssh/id_ed25519.pub

终端会输出一行类似这样的内容：

ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIL4jB4Z4Q5X8Y7K9L2M3N6P7Q8R9S0T1U2V3W4X5Y6Z7A8B9C0D1E2 你好@example.com

整个这一行就是公钥，全选复制。

Step 4：添加到 GitHub

登录 GitHub：

打开 https://github.com/settings/keys
点击 New SSH key

填写表单：

Title：随便起个名字，比如 WSL-home 或 我的工作电脑
Key type：保持默认
Key：粘贴刚才复制的公钥（以 ssh-ed25519 AAAAC3... 开头的那一行）
点击 Add SSH key

验证是否成功：

ssh -T git@github.com

看到这条消息说明成功：

Hi wuqing1982! You've successfully authenticated, but GitHub does not provide shell access.

Step 5：添加到 Gitee

登录 Gitee：

打开 https://gitee.com/profile/ssh_keys
点击 添加公钥

填写表单：

标题：随便填，比如 WSL-home
公钥：粘贴同样的公钥内容
点击确定

验证是否成功：

ssh -T git@gitee.com

看到这条消息说明成功：

Hi 何庆(@hqking22)! You've successfully authenticated, but GITEE.COM does not provide shell access.

三、known_hosts 是什么

SSH 第一次连接服务器时，会询问你是否信任这个服务器：

The authenticity of host 'github.com (140.82.114.4)' can't be established.
ECDSA key fingerprint is SHA256:xxxxxxx.
Are you sure you want to continue connecting (yes/no)?

输入 yes 后，计算机会把这个服务器的指纹记录到 ~/.ssh/known_hosts 文件里，下次就不再问了。

我们执行了 ssh-keyscan gitee.com >> ~/.ssh/known_hosts，就是手动把 Gitee 的服务器指纹提前写入，避免第一次 push 时卡住。

四、为什么 Gitee 报错 "Host key verification failed"

这是因为 known_hosts 里没有 Gitee 的指纹：

Host key verification failed.

解决方法（执行一次即可）：

ssh-keyscan gitee.com >> ~/.ssh/known_hosts

这行命令做了：

连接 Gitee 服务器，获取它的公钥指纹
追加到 ~/.ssh/known_hosts 文件

五、同一个密钥同时管 GitHub 和 Gitee 的原理

GitHub 服务器里存储了你的公钥
          ↕
    用公钥加密挑战
          ↕
只有持有对应私钥的人能解开
          ↕
    你的电脑用私钥解密
          ↕
GitHub 确认：这个人是我认识的

Gitee 服务器里也存储了同一个公钥（你的）
          ↕
    用公钥加密挑战
          ↕
只有持有对应私钥的人能解开
          ↕
    你的电脑用私钥解密
          ↕
Gitee 确认：这个人是我认识的

私钥只有一份，公钥可以复制多份。

这就是为什么一个 SSH 密钥可以同时访问 GitHub 和 Gitee——它们各自保存了你的公钥，你用同一把私钥来证明身份。

六、为什么用 `id_ed25519` 而不是 `id_rsa`

算法	安全性	兼容性	推荐度
`rsa` (2048-bit)	中	最好（老系统都支持）	一般
`rsa` (4096-bit)	高	好	可用
`ed25519`	最高	现代系统都支持	强烈推荐

Ed25519 的优势：

密钥更短（安全性却更高）
签名速度更快
没有实现上容易出错的边界条件

注意：如果你的系统很老（比如某些嵌入式设备），可能不支持 ed25519，那时候才用 rsa。

七、常见问题

Q1：我的密钥有密码（passphrase），每次 push 都要输入怎么办？

使用 SSH Agent 管理私钥，macOS/Linux 会自动缓存：

# 启动 SSH Agent
eval "$(ssh-agent -s)"

# 添加私钥（只需输入一次密码）
ssh-add ~/.ssh/id_ed25519

如果用的是 Windows WSL，WSL2 会自动代理到 Windows 的 ssh-agent，不需要手动启动。

Q2：能不能为 GitHub 和 Gitee 用不同的密钥？

可以，但没必要。同一把密钥同时管两个平台更简单。

如果非要分开：

# 生成 GitHub 专用密钥
ssh-keygen -t ed25519 -C "github@email.com" -f ~/.ssh/github_id_ed25519

# 生成 Gitee 专用密钥
ssh-keygen -t ed25519 -C "gitee@email.com" -f ~/.ssh/gitee_id_ed25519

然后在 ~/.ssh/config 里配置哪个密钥给哪个域名用（见下一节）。

Q3：怎么区分不同域名用不同的密钥？

编辑 ~/.ssh/config（如果没有就创建）：

# GitHub 用这把密钥
Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes

# Gitee 用这把密钥
Host gitee.com
    HostName gitee.com
    User git
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes

Q4：GitHub 的 Token 和 SSH 密钥有什么区别？

	SSH 密钥	Personal Access Token
用途	push/pull 代码	API 调用、Web 登录
有效期	永久（除非删除）	可设置过期时间
权限	只能是只读或读写	可以细粒度控制
使用方式	自动使用私钥认证	每次手动输入

对于日常 Git 操作，两者功能相同。Token 更多是给第三方应用授权用的。

Q5：公钥泄露了怎么办？

立即到 GitHub / Gitee 设置里删除那把公钥，然后重新生成新密钥。

任何人拿到你的公钥本身没有危险（公钥本来就是公开的），但如果有公钥就说明私钥也可能被拿到了——最安全的做法是换新密钥。

八、完整流程回顾

# 1. 生成密钥
ssh-keygen -t ed25519 -C "heqing@farsthink.com" -f ~/.ssh/id_ed25519

# 2. 查看公钥
cat ~/.ssh/id_ed25519.pub
# 复制这整行

# 3. 添加到 GitHub
# 浏览器打开 https://github.com/settings/keys → New SSH key → 粘贴

# 4. 添加到 Gitee
# 浏览器打开 https://gitee.com/profile/ssh_keys → 添加公钥 → 粘贴

# 5. 验证 GitHub
ssh -T git@github.com

# 6. 验证 Gitee（先获取指纹）
ssh-keyscan gitee.com >> ~/.ssh/known_hosts
ssh -T git@gitee.com

# 7. 开始使用
git clone git@github.com:wuqing1982/hermes-skills.git
git push origin main