↑

Git SSH 密钥配置

adminadmin
访问 15点赞 0收藏 0

Git SSH 密钥配置,从基础生成、查看,到进阶多密钥管理、免密配置、密钥安全、故障排查,一站式解决所有 SSH 认证问题。

本文覆盖Windows/macOS/Linux 全系统通用的 Git SSH 密钥配置,从基础生成、查看,到进阶多密钥管理、免密配置、密钥安全、故障排查,一站式解决所有 SSH 认证问题。

一、核心概念

  1. SSH 密钥:分为公钥(id_rsa.pub)和私钥(id_rsa),是 Git 服务器(GitHub/GitLab/Gitee)的安全认证方式,替代密码登录,更安全、更便捷。
  2. 公钥:可以公开分享,需要配置到 Git 服务器上。
  3. 私钥:绝对不能泄露,仅保存在本地电脑,用于身份验证。

二、基础操作(新手必看)

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"

三步交互说明(直接回车默认即可)

  1. 提示 Enter file in which to save the key:确认存储位置,直接回车用默认路径
  2. 提示 Enter passphrase:设置密钥密码(进阶用,新手直接回车免密)
  3. 提示 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 服务器

  1. 登录 GitHub/GitLab/Gitee
  2. 进入:设置 → SSH 公钥 → 新建 SSH 密钥
  3. 粘贴公钥内容,命名(如「办公电脑」),保存
  4. 测试连接:ssh -T git@github.com(GitHub)/ ssh -T git@gitee.com(Gitee)
  5. 提示 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:密钥安全最佳实践

  1. 私钥绝不泄露:不要上传到网盘、代码仓库、聊天软件
  2. 定期更换密钥:建议 6-12 个月更换一次
  3. 丢失立即作废:电脑丢失/更换,第一时间删除 Git 服务器上的旧公钥
  4. 禁用密码登录:服务器仅允许 SSH 密钥认证,禁止密码登录
  5. 权限加固:强制设置密钥文件权限(防止权限过高报错)
    chmod 700 ~/.sshchmod 600 ~/.ssh/id_*chmod 644 ~/.ssh/*.pub

进阶5:一键排查 SSH 连接故障

连接失败时,用调试命令定位问题:

# 调试 GitHub 连接(输出详细日志)ssh -Tvvv git@github.com

常见问题解决方案

  1. Permission denied (publickey):密钥未配置/文件名错误/私钥权限异常
  2. Bad owner or permissions:执行「进阶4」的权限加固命令
  3. 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_*

总结

  1. 基础:检查密钥→生成密钥→复制公钥→配置服务器→测试连接,5 分钟完成
  2. 进阶核心:ED25519 更安全、多密钥配置解决多账户、密钥加固提升安全性
  3. 全系统通用:macOS/Windows/Linux 命令、配置完全一致,无学习成本
  4. 故障无忧:调试命令+常见方案,快速解决所有 SSH 认证问题