Git SSH 密钥配置
Git SSH 密钥配置,从基础生成、查看,到进阶多密钥管理、免密配置、密钥安全、故障排查,一站式解决所有 SSH 认证问题。
本文覆盖Windows/macOS/Linux 全系统通用的 Git SSH 密钥配置,从基础生成、查看,到进阶多密钥管理、免密配置、密钥安全、故障排查,一站式解决所有 SSH 认证问题。
一、核心概念
- SSH 密钥:分为公钥(id_rsa.pub)和私钥(id_rsa),是 Git 服务器(GitHub/GitLab/Gitee)的安全认证方式,替代密码登录,更安全、更便捷。
- 公钥:可以公开分享,需要配置到 Git 服务器上。
- 私钥:绝对不能泄露,仅保存在本地电脑,用于身份验证。
二、基础操作(新手必看)
1. 检查本地是否已有 SSH 密钥
SSH 密钥默认存储路径:
- macOS/Linux:
~/.ssh/ - Windows:
C:\Users\你的用户名\.ssh\
全系统通用命令(终端/Git Bash 执行)
# 进入密钥目录(不存在会提示,不影响)cd ~/.ssh # 查看公钥文件(存在则直接输出内容)cat id_rsa.pub
✅ 判断标准:
- 输出一段以
ssh-rsa开头的字符串 → 已有密钥,直接复制使用 - 提示
No such file or directory→ 无密钥,需要生成
2. 生成标准 SSH 密钥(RSA 算法,通用兼容)
# 生成 RSA 2048 位密钥,-C 备注建议填自己的邮箱ssh-keygen -t rsa -b 2048 -C "你的邮箱@xxx.com"
三步交互说明(直接回车默认即可)
- 提示
Enter file in which to save the key:确认存储位置,直接回车用默认路径 - 提示
Enter passphrase:设置密钥密码(进阶用,新手直接回车免密) - 提示
Enter same passphrase again:重复密码,直接回车
✅ 生成成功后,~/.ssh 目录会出现两个文件:
id_rsa:私钥(保密)id_rsa.pub:公钥(配置到 Git 服务器)
3. 复制公钥并配置到 Git 服务器
查看/复制公钥命令
# macOScat ~/.ssh/id_rsa.pub | pbcopy # Windows (Git Bash)cat ~/.ssh/id_rsa.pub | clip # Linuxcat ~/.ssh/id_rsa.pub | xclip -sel clip
手动复制:打开 .ssh/id_rsa.pub 文件,全选复制所有内容。
配置到 Git 服务器
- 登录 GitHub/GitLab/Gitee
- 进入:
设置 → SSH 公钥 → 新建 SSH 密钥 - 粘贴公钥内容,命名(如「办公电脑」),保存
- 测试连接:
ssh -T git@github.com(GitHub)/ssh -T git@gitee.com(Gitee) - 提示
Hi xxx! You've successfully authenticated→ 配置成功
三、进阶玩法(高效/安全/多场景必备)
进阶1:使用更安全的 ED25519 算法(推荐)
比传统 RSA 更安全、更快,现代 Git 服务器全支持:
# 生成 ED25519 密钥(首选方案)ssh-keygen -t ed25519 -C "你的邮箱@xxx.com"
生成的文件:id_ed25519(私钥)、id_ed25519.pub(公钥)
进阶2:多账户管理(同时用 GitHub + 公司 GitLab)
场景:你有个人 GitHub 和 公司 GitLab,需要两套独立密钥,自动区分。
步骤1:为不同账户生成专属密钥
# 生成个人 GitHub 密钥(自定义文件名)ssh-keygen -t ed25519 -C "personal@qq.com" -f ~/.ssh/id_ed25519_github # 生成公司 GitLab 密钥ssh-keygen -t ed25519 -C "work@company.com" -f ~/.ssh/id_ed25519_gitlab
步骤2:创建 SSH 配置文件
# 编辑配置文件(无则自动创建)vim ~/.ssh/config
粘贴以下配置(清晰区分不同服务器):
# GitHub 个人账户Host github.com HostName github.com User git IdentityFile ~/.ssh/id_ed25519_github IdentitiesOnly yes # 公司 GitLab 账户Host gitlab.company.com HostName gitlab.company.com User git IdentityFile ~/.ssh/id_ed25519_gitlab IdentitiesOnly yes
保存退出:ESC → :wq
步骤3:测试连接
ssh -T git@github.comssh -T git@gitlab.company.com
✅ 两个账户自动匹配对应密钥,无需手动切换。
进阶3:SSH 密钥免密自动加载(设置了密码必看)
如果你生成密钥时设置了密码,每次拉取/推送代码都会输密码,用以下方法免密:
macOS 系统
ssh-add --apple-use-keychain ~/.ssh/id_rsa
Windows/Linux 系统
# 临时加载(终端关闭失效)ssh-add ~/.ssh/id_rsa # 永久生效(开机自动加载)# 编辑 ~/.bashrc 或 ~/.zshrc,添加一行ssh-add ~/.ssh/id_rsa 2>/dev/null
进阶4:密钥安全最佳实践
- 私钥绝不泄露:不要上传到网盘、代码仓库、聊天软件
- 定期更换密钥:建议 6-12 个月更换一次
- 丢失立即作废:电脑丢失/更换,第一时间删除 Git 服务器上的旧公钥
- 禁用密码登录:服务器仅允许 SSH 密钥认证,禁止密码登录
- 权限加固:强制设置密钥文件权限(防止权限过高报错)
chmod 700 ~/.sshchmod 600 ~/.ssh/id_*chmod 644 ~/.ssh/*.pub
进阶5:一键排查 SSH 连接故障
连接失败时,用调试命令定位问题:
# 调试 GitHub 连接(输出详细日志)ssh -Tvvv git@github.com
常见问题解决方案
- Permission denied (publickey):密钥未配置/文件名错误/私钥权限异常
- Bad owner or permissions:执行「进阶4」的权限加固命令
- Host key verification failed:删除已知主机记录
rm ~/.ssh/known_hosts
进阶6:批量部署/服务器自动化(免交互生成密钥)
脚本自动化场景,一键生成密钥,无任何交互:
# 免交互生成 ED25519 密钥,无密码ssh-keygen -t ed25519 -C "auto@script.com" -f ~/.ssh/id_ed25519_auto -N ""
四、常用命令速查表
| 操作 | 命令 |
|---|---|
| 查看公钥 | cat ~/.ssh/id_rsa.pub |
| 生成 RSA 密钥 | ssh-keygen -t rsa -C "邮箱" |
| 生成 ED25519 密钥 | ssh-keygen -t ed25519 -C "邮箱" |
| 测试连接 | ssh -T git@github.com |
| 调试连接 | ssh -Tvvv git@github.com |
| 加载密钥 | ssh-add ~/.ssh/私钥文件名 |
| 修复权限 | chmod 600 ~/.ssh/id_* |
总结
- 基础:检查密钥→生成密钥→复制公钥→配置服务器→测试连接,5 分钟完成
- 进阶核心:ED25519 更安全、多密钥配置解决多账户、密钥加固提升安全性
- 全系统通用:macOS/Windows/Linux 命令、配置完全一致,无学习成本
- 故障无忧:调试命令+常见方案,快速解决所有 SSH 认证问题