先说一句：这里配置的是“GitHub 用的 SSH key”#

这篇讲的是：

让 Git / GitHub 通过 SSH 认证来访问仓库。

所以它和“你用 SSH 远程登录服务器”那类场景相关，但不是同一件事。

• 远程登录服务器，通常是：ssh user@host
• GitHub SSH 配置，主要是为了：git@github.com

也就是说，这里重点是Git 仓库认证，不是服务器登录本身。

第一步：先检查本机有没有现成的 SSH key#

GitHub 官方也建议先看一下本机有没有已经能用的 key，不要一上来就重复生成。

直接看 ~/.ssh 目录：

1
ls -al ~/.ssh

常见会看到这些文件名：

• id_ed25519
• id_ed25519.pub
• id_rsa
• id_rsa.pub

其中：

• 没有后缀的，是私钥
• .pub 结尾的，是公钥

如果你已经有一对 SSH key，而且就是你准备继续用的那一对，那就不一定需要重新生成。

第二步：生成新的 SSH key#

如果你没有现成可用的 key，或者想专门为 GitHub 单独生成一套，那就可以新建一对。

GitHub 官方现在更推荐使用：

• ed25519

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

1
~/.ssh/id_ed25519

1
~/.ssh/id_ed25519_github

如果你的环境不支持 ed25519 怎么办#

GitHub 官方也给了兼容方案。

如果你的系统太旧，ed25519 不可用，也可以退回到 RSA：

1
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

不过如果环境支持，还是更建议优先用 ed25519。

第三步：启动 ssh-agent#

生成 key 之后，下一步通常是把私钥交给 ssh-agent 管理。

这样你后面用 Git 的时候，就不用每次都重新处理密钥。

先启动 agent：

1
eval "$(ssh-agent -s)"

如果正常，会看到类似：

1
Agent pid 12345

第四步：把私钥加到 ssh-agent#

如果你用的是默认文件名：

1
ssh-add ~/.ssh/id_ed25519

如果你刚才是自己起名的，例如：

1
ssh-add ~/.ssh/id_ed25519_github

这里加的是私钥文件，不是 .pub 公钥文件。

第五步：按需要配置 ~/.ssh/config#

如果你只有一把默认 key，有时甚至不配也能正常工作。

但如果你：

• 有多把 key
• 想明确指定 GitHub 走哪一把 key
• 想让 agent 行为更稳定

那最好还是写一下 ~/.ssh/config。

先确保文件存在：

1
touch ~/.ssh/config
2
chmod 600 ~/.ssh/config

然后写入类似内容：

1
Host github.com
2
  HostName github.com
3
  User git
4
  IdentityFile ~/.ssh/id_ed25519
5
  AddKeysToAgent yes

如果你使用的是自定义文件名，就把 IdentityFile 改成你自己的路径。

1
Host github.com
2
  HostName github.com
3
  User git
4
  IdentityFile ~/.ssh/id_ed25519
5
  AddKeysToAgent yes
6
  UseKeychain yes

第六步：复制公钥内容#

下一步就是把公钥添加到 GitHub 账号。

如果你用的是默认 key：

1
cat ~/.ssh/id_ed25519.pub

如果你用的是自定义文件名，就改成对应的 .pub 文件。

你会看到一整行类似这样的内容：

1
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI...... your_email@example.com

这一整行都要复制，不要只复制中间一段。

1
pbcopy < ~/.ssh/id_ed25519.pub

1
xclip -sel clip < ~/.ssh/id_ed25519.pub

1
cat ~/.ssh/id_ed25519.pub | clip

第七步：把公钥添加到 GitHub#

接下来去 GitHub 网页操作。

路径是：

• 右上角头像
• Settings
• SSH and GPG keys
• 点击 New SSH key 或 Add SSH key

然后：

第八步：测试 GitHub SSH 是否生效#

GitHub 官方推荐用这条命令测试：

1
ssh -T git@github.com

第一次连接时，通常会问你要不要信任 GitHub 主机指纹，输入：

1
yes

如果一切正常，你会看到类似：

1
Hi your-username! You've successfully authenticated, but GitHub does not provide shell access.

这里最后一句很重要：

• GitHub 允许你通过 SSH 做 Git 认证
• 但它不会给你真正的 shell

所以看到这句话其实就是成功了。

第九步：把仓库远程地址切到 SSH#

如果你现在的仓库还是 HTTPS 地址，需要改成 SSH 才能真正用上刚配置好的 key。

先看当前远程地址：

1
git remote -v

如果你看到的是这种：

1
https://github.com/owner/repo.git

那就说明现在还在走 HTTPS。

把它改成 SSH：

1
git remote set-url origin git@github.com:owner/repo.git

然后再看一遍：

1
git remote -v

如果变成：

1
git@github.com:owner/repo.git

就说明已经切过来了。

第十步：实际验证一次 Git push#

前面都配完以后，最好还是实际跑一次 Git 命令验证一下。

例如：

1
git pull
2
git push

如果不再要求你重新走 HTTPS 认证，而是直接通过 SSH 工作，那就说明这套配置已经真正接通了。

常见问题 1：为什么我明明加了 key，还是报 permission denied#

最常见的排查方向通常是这几个：

1
https://github.com/...

1
ssh-add -l

常见问题 2：我已经有服务器登录用的 SSH key，还要不要再建一把 GitHub 专用 key#

这取决于你自己的习惯。

常见问题 3：能不能用 GitHub CLI 来加 SSH key#

可以。GitHub 官方也支持通过 gh 来处理 SSH key。

如果你已经登录过 GitHub CLI，那么这一步其实会更方便一些。

1
gh auth status

1
gh auth login

1
gh ssh-key add ~/.ssh/id_ed25519.pub --title "My Laptop"

1
gh ssh-key add ~/.ssh/id_ed25519.pub --title "My Laptop"

1
This API operation needs the "admin:public_key" scope.
2
To request it, run: gh auth refresh -h github.com -s admin:public_key

1
gh auth refresh -h github.com -s admin:public_key

1
gh ssh-key add ~/.ssh/id_ed25519.pub --title "My Laptop"

1
ssh -T git@github.com

写在最后#

如果把这件事压缩成一句话，其实就是：

生成 SSH key，把公钥加到 GitHub，把本地仓库远程地址切到 SSH，然后测试是否认证成功。

真正容易卡人的地方通常不是步骤本身，而是：

• 分不清公钥和私钥
• 不知道 Git 远程地址还在走 HTTPS
• 机器上有多把 key，结果配混了

所以你如果想尽量少踩坑，我会建议按这个顺序来：

1. 先确认有没有现成 key
2. 没有就生成 ed25519
3. 启动 ssh-agent 并加私钥
4. 配 ~/.ssh/config
5. 把公钥加到 GitHub
6. 用 ssh -T git@github.com 测
7. 把仓库 remote 切到 SSH

这样一轮走下来，后面 GitHub 走 SSH 基本就稳了。