5 分钟搞定 GitHub SSH 密钥（Win / macOS / Linux 全覆盖）

5 分钟搞定 GitHub SSH 密钥（Win / macOS / Linux 全覆盖）

> 关键词：GitHub、SSH、密钥、优快云、Git、Terminal
> 日期：2025-09-23
> 作者：web_code_yang
> 原创链接：https://blog.youkuaiyun.com/code_YangDi/article/details/152008757?spm=1001.2014.3001.5501

---

1. 为什么要配 SSH？

• HTTPS 每次 push 都要输用户名 + token，麻烦；
• SSH 只需第一次配置，之后「免密」推送，安全又高效。

---

2. 前置检查

# 如果已存在密钥，先看一下
ls -al ~/.ssh
# 若出现 id_ed25519 / id_rsa 之类，可跳过生成，直接看第 4 步。

3. 生成新密钥（推荐 Ed25519）

# 把邮箱换成你 GitHub 的注册邮箱
ssh-keygen -t ed25519 -C "your_email@example.com"

一路回车即可（想加密码可额外再输一次）。
生成后路径：~/.ssh/id_ed25519（私钥） 和 id_ed25519.pub（公钥）。

4. 把私钥托管给 ssh-agent（免密加载）

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

# 加入私钥（如改过文件名，请对应修改）
ssh-add ~/.ssh/id_ed25519

5. 复制公钥

# macOS 可直接复制到剪贴板
pbcopy < ~/.ssh/id_ed25519.pub
# Linux / Git Bash 用户
cat ~/.ssh/id_ed25519.pub
# 手动复制打印出来的全部内容

6. 添加到 GitHub

登录 GitHub → 右上角头像 → Settings
左侧 SSH and GPG keys → New SSH key
Title 随便写（例：MacBook-Pro-2025），Key 里粘贴公钥 → Add SSH key

7. 测试连通性

ssh -T git@github.com

首次问
Are you sure you want to continue connecting (yes/no/[fingerprint])? 输 yes
看到
Hi 你的GitHub用户名! You've successfully authenticated...
即成功！
⚠️ 如果报 Permission denied (publickey)，99% 是公钥没粘全或邮箱写错，回去检查。

8. 常见问题速查

现象	解决
ssh-add报 “Could not open a connection”	先执行 eval "$(ssh-agent -s)"
Windows 默认没有 ssh-keygen	安装 [Git for Windows]，用 Git Bash
公司电脑无法访问 22 端口	改用 443 端口：ssh -T -p 443 git@ssh.github.com

9. 步骤小结（思维导图）

10. 一键脚本（懒人福利）

把下面保存为 github_ssh.sh，chmod +x github_ssh.sh 后直接运行：

复制
#!/usr/bin/env bash
read -p "GitHub 邮箱: " email
ssh-keygen -t ed25519 -C "$email" -f ~/.ssh/id_ed25519 -N ""
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
echo "=== 公钥内容如下，已复制到剪贴板 ==="
cat ~/.ssh/id_ed25519.pub
# macOS
type pbcopy &>/dev/null && pbcopy < ~/.ssh/id_ed25519.pub

11. 参考

• GitHub仓库。
• 优快云 Markdown 帮助

如果本文帮到你，记得点个赞 + 收藏哦 💖
评论区欢迎提问，24h 内必回！