在Git服务器添加公钥的核心步骤是：在本地生成SSH密钥对，将生成的公钥内容完整复制，并登录Git管理后台将其粘贴至账户的SSH Keys设置中，即可实现免密安全连接。
为什么必须配置SSH公钥而非密码
很多开发者在初次接触版本控制时，习惯使用HTTPS协议配合用户名和密码进行代码推送，这种方式虽然直观，但在实际工程实践中存在明显短板，业内专家指出，基于密码的身份验证不仅输入繁琐，且每次操作都需要人工干预，极大降低了CI/CD流水线的自动化效率，相比之下，SSH密钥对采用非对称加密技术,安全性远高于静态密码。
安全性与便捷性的双重优势
SSH公钥机制的本质是将身份验证从“你知道什么”（密码）转变为“你拥有什么”（私钥文件）,这种机制带来了几个关键优势：
- 免密登录：配置完成后，Git客户端会自动使用本地私钥与服务器公钥进行数学匹配,无需每次输入冗长的密码。
- 防暴力破解：私钥通常受密码短语保护，即使文件泄露,攻击者也无法轻易使用。
- 自动化友好：脚本和构建工具可以无缝集成,无需处理交互式密码输入。
常见误区：HTTPS与SSH的选择
许多团队在搭建私有Git仓库时，会在HTTPS和SSH之间犹豫，对于内部开发团队，SSH是绝对的主流选择，据行业共识认为，超过80%的企业级开发环境已全面转向SSH协议，主要原因在于其更严格的访问控制和更低的网络延迟，HTTPS虽然配置简单，但容易受到中间人攻击，且在频繁推送小文件时,网络开销较大。
本地环境生成SSH密钥对实操指南
配置公钥的第一步是在本地计算机上生成密钥对，这一步骤只需执行一次，后续所有操作都依赖于此，不同操作系统下的操作略有差异,但核心逻辑一致。
Windows用户操作步骤
Windows 10及更高版本已内置OpenSSH客户端，打开PowerShell或命令提示符,执行以下命令：
- 运行
ssh-keygen -t ed25519 -C "your_email@example.com"。 - 系统会提示输入文件保存路径,直接回车使用默认路径即可。
- 系统会提示设置密码短语（Passphrase），建议设置一个强密码以增强私钥安全性，若不想每次使用都输入,可留空直接回车。
- 生成成功后，终端会显示密钥指纹,用于验证密钥是否正确。
macOS/Linux用户操作步骤
macOS和Linux用户通常在终端中操作,步骤与Windows类似：
- 打开终端，输入
ssh-keygen -t ed25519 -C "your_email@example.com"。 - 同样按提示确认路径和设置密码短语。
- 生成完成后，使用
cat ~/.ssh/id_ed25519.pub查看并复制公钥内容。
密钥格式选择：ED25519 vs RSA
目前推荐使用ED25519算法，它比传统的RSA算法更安全且生成速度更快，如果服务器版本较老不支持ED25519，可降级使用 ssh-keygen -t rsa -b 4096。
如何将公钥添加到Git服务器
生成公钥后，下一步是将其添加到Git服务器，这一过程因平台而异,但核心逻辑都是将公钥文本粘贴到指定区域。
GitHub/GitLab添加流程
以主流的GitLab为例,添加流程如下：
- 登录GitLab账户，点击右上角头像，选择“Settings”。
- 在左侧菜单中找到“SSH Keys”。
- 在“Key”文本框中,粘贴之前复制的公钥内容。
- 在“Title”栏输入一个描述性名称，如“MacBook-Pro-2026”,以便日后管理。
- 点击“Add key”保存。
私有Git服务器（如Gitea/自托管GitLab）
对于企业自托管的Git服务器,操作路径类似：
- 进入用户个人中心。
- 寻找“SSH公钥管理”或“密钥管理”模块。
- 粘贴公钥并保存。
权限验证与测试
添加公钥后，务必进行连接测试，在本地终端执行 ssh -T git@your-git-server.com，若看到欢迎信息或权限提示，说明配置成功，若出现权限拒绝错误，请检查公钥是否完整复制,或确认服务器是否允许SSH访问。
常见问题排查与优化建议
尽管配置过程看似简单，但实际应用中常遇到各种问题,以下列出高频故障及解决方案。
权限被拒绝（Permission Denied）
这是最常见的错误,原因通常包括：
- 公钥未正确添加：检查服务器端是否已保存该公钥。
- 私钥权限过宽：Linux/macOS系统中，私钥文件权限必须为600，执行
chmod 600 ~/.ssh/id_ed25519修复。 - SSH代理未启动：确保SSH Agent正在运行，并添加了私钥，使用
ssh-add ~/.ssh/id_ed25519手动添加。
多账户冲突处理
对于同时使用GitHub和GitLab的用户,配置多个SSH密钥是常见需求。
- 在
~/.ssh/config文件中创建配置文件。 - 为不同主机指定不同的私钥路径。
-
Host github.com HostName github.com User git IdentityFile ~/.ssh/id_github Host gitlab.com HostName gitlab.com User git IdentityFile ~/.ssh/id_gitlab
密钥轮换与安全最佳实践
建议每6-12个月轮换一次SSH密钥，定期删除不再使用的公钥，减少潜在攻击面，务必为私钥设置强密码短语,防止本地设备丢失导致密钥泄露。
Git服务器添加公钥相关Q&A
Git服务器添加公钥失败怎么办
首先检查公钥内容是否包含完整的 ssh-ed25519 或 ssh-rsa 前缀及邮箱后缀，确认服务器端SSH服务正常运行，且用户权限正确，检查本地防火墙是否阻止了22端口连接，若问题依旧，查看服务器日志 /var/log/auth.log 获取详细错误信息。
SSH公钥和HTTPS密码哪个更安全
SSH公钥在安全性上显著优于HTTPS密码，密码易受暴力破解和键盘记录器攻击，而SSH密钥对基于非对称加密，私钥永不传输，仅通过数学挑战验证身份，私钥可设密码短语,提供双重保护。
更换电脑后如何迁移Git公钥
更换电脑后，需在新设备上重新生成SSH密钥对，并将新公钥添加到Git服务器，旧设备的私钥无需迁移，只需在新设备配置好新密钥后，即可正常推送代码，若需保留旧密钥，可将旧设备的私钥文件复制到新设备,并确保权限正确。
首发原创文章，作者：世雄 - 原生数据库架构专家，如若转载，请注明出处：https://idctop.com/article/426018.html
