Git SSH配置全攻略：5分钟实现安全代码推送
在团队协作开发中，Git的SSH访问方式因其安全性和便捷性成为开发者的首选。本文将手把手教你完成从密钥生成到仓库配置的全流程，解决85%开发者在SSH配置过程中遇到的常见问题。
一、SSH密钥生成（Windows/Mac/Linux通用）
- 打开终端（Windows用户可使用Git Bash）
- 执行命令：
ssh-keygen -t ed25519 -C "[email protected]" - 提示保存路径时直接回车使用默认位置
- 设置密码短语（可选但推荐）
专业提示：Ed25519算法比传统RSA更安全高效，是新系统的首选
二、SSH代理配置（解决每次都要输密码的痛点）
启动ssh-agent：
eval "$(ssh-agent -s)"
添加密钥到代理：
ssh-add ~/.ssh/id_ed25519
在~/.ssh/config中添加以下内容实现自动加载：
Host * AddKeysToAgent yes UseKeychain yes IdentityFile ~/.ssh/id_ed25519
三、主流平台配置指南
GitHub配置流程
- 复制公钥内容：
cat ~/.ssh/id_ed25519.pub - 登录GitHub → Settings → SSH and GPG keys
- 点击"New SSH key"按钮
- 粘贴公钥并保存
GitLab配置差异点
- 需在User Settings → SSH Keys添加
- 企业版可能需要配置不同的主机名
四、常见问题排错手册
| 问题现象 | 解决方案 |
|---|---|
| Permission denied (publickey) | 1. 检查ssh-agent是否运行 2. 确认公钥已正确添加到远程仓库 |
| 端口22连接被拒 | 尝试修改config文件指定其他端口 |
五、高阶配置技巧
1. 多账号管理方案
Host work-github HostName github.com User git IdentityFile ~/.ssh/work_id_ed25519 Host personal-github HostName github.com User git IdentityFile ~/.ssh/personal_id_ed25519
2. 禁用严格主机检查（仅测试环境使用）
StrictHostKeyChecking no UserKnownHostsFile /dev/null
通过本文的详细指导，您应该已经成功配置了Git SSH访问。记住定期轮换密钥（建议每6-12个月）是保持代码库安全的最佳实践。如需进一步优化您的工作流程，可以考虑结合使用SSH证书认证等企业级方案。