Git SSH配置怎么做？详细步骤，Git SSH配置教程

正确配置 Git SSH 是保障代码传输安全与效率的基石

对于开发者而言,配置 Git SSH 不仅是为了免去每次推送拉取时输入密码的繁琐，更是建立可信加密通道、防止代码泄露的关键步骤，只要完成密钥生成、代理添加、远程仓库地址切换三步，即可实现安全高效的版本控制工作流，以下从原理到实战，提供一套可复用的完整方案。

SSH 与 HTTPS 的本质区别

• HTTPS 每次操作都需要验证账号密码，且密码在网络传输中存在被截获的风险。
• SSH 使用公钥与私钥的非对称加密方式，私钥仅保存在本地，服务器只验证公钥签名，从机制上规避了密码泄露问题。
• SSH 协议支持连接复用，在频繁推送、拉取时延迟更低、吞吐更稳。

第一步：生成专属 SSH 密钥对

打开终端（Windows 用户使用 Git Bash 或 PowerShell），执行以下命令：

ssh-keygen -t ed25519 -C "your_email@example.com" -f ~/.ssh/id_ed25519

• 若你的系统或托管平台不支持 ed25519，可改用 rsa -b 4096。
• 生成的 id_ed25519 是私钥文件，绝不能泄露或提交到仓库；id_ed25519.pub 为公钥，可安全上传。
• 建议为私钥设置 passphrase（口令），即使设备丢失，攻击者也无法直接使用。

第二步：将公钥添加到 Git 托管平台

以 GitHub、GitLab、Gitee 为例，操作路径一致：

• 复制公钥内容：cat ~/.ssh/id_ed25519.pub
• 登录对应平台,进入 Settings -> SSH Keys 或 安全设置 -> SSH 公钥，粘贴并保存。
• 建议为公钥添加备注（如“公司笔记本”），方便日后管理。

第三步：本地仓库切换为 SSH 远程地址

查看当前远程地址：

git remote -v

若显示为 HTTPS 开头，则执行替换：

git remote set-url origin git@github.com:username/repo.git

替换后可通过以下命令验证连通性：

ssh -T git@github.com

出现 Hi username! You've successfully authenticated 即代表配置成功。

第四步：管理多账户与多主机密钥

当同时使用 GitHub 与 GitLab 时，需配置 ~/.ssh/config 文件：

Host github.com
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_ed25519_github
Host gitlab.com
  HostName gitlab.com
  User git
  IdentityFile ~/.ssh/id_ed25519_gitlab

• 不同主机的私钥严格隔离,互不影响。
• 每次连接时 SSH 客户端会自动匹配对应密钥，无需手动指定。

常见问题与专业解决方案

• Permission denied (publickey)

  • 检查是否执行 ssh-add ~/.ssh/id_ed25519 将私钥添加到 ssh-agent。
  • 查看当前代理列表：

    

    ssh-add -l

  • 确认远端仓库地址中主机名与 config 匹配，git remote -v 应显示 git@ 开头。

• SSH 连接超时（端口 22 被防火墙拦截）

  • 可尝试使用 SSH over HTTPS 端口，编辑 ~/.ssh/config：

    Host github.com
      HostName ssh.github.com
      Port 443

  • 对于自建 Git 服务器，需确保防火墙放行目标端口，否则改用内网穿透方案。

酷番云实战经验案例

我们在酷番云服务器上部署 Git 仓库服务时，遇到过多台开发机同时连接同一仓库的情况，如果每台机器独立生成密钥，无法统一撤销权限；若共享私钥，又面临泄露风险。

我们的解决方案是：在酷番云主机上配置一个专门的部署账户，并为其生成独立的 SSH 密钥对，该密钥仅赋予拉取代码的只读权限，且私钥只存于 CI/CD 构建机中，这样普通开发者的个人密钥即使泄露，也不会影响生产环境的部署链路，同时利用酷番云的安全组功能，将 SSH 端口限定在可信 IP 范围内，极大降低了暴力破解的风险，实际操作中，结合 ssh-keygen 生成的 ed25519 密钥与 force-command 限制，实现了最小权限原则下的安全自动化部署。

进阶建议：让 SSH 配置更健壮

• 使用 ssh-keyscan 预先获取主机公钥，并写入 ~/.ssh/known_hosts，避免首次连接交互。

• 

  定期轮换密钥：当成员离职或设备丢失时，立即删除对应公钥，并重新生成新密钥。

• 开启 SSH 代理复用（ControlMaster），加速批量操作场景：

  Host   ControlMaster auto  ControlPath ~/.ssh/controlmasters/%r@%h:%p  ControlPersist 10m

• 配置完成后,用 git log 确认提交者身份与 SSH 账户一致，避免权限错乱。

相关问答

问：Git SSH 配置后仍要求输入密码，是什么原因？

答：最常见原因是当前仓库的 remote 地址仍是 HTTPS 格式，请执行 git remote -v 查看，若输出为 https:// 开头，按上文第三步修改为 SSH 格式即可，若你使用的平台（如 Gitee）还要求设置“SSH 公钥标题”，请确保公钥已经完整粘贴且无多余空格；同时检查 ~/.ssh 目录权限，建议私钥文件权限为 600，目录权限为 700。

问：如何在不影响现有仓库的情况下，为同一托管平台添加第二个 SSH 密钥？

答：在同一平台（如 GitHub）绑定多个密钥是允许的平台会轮询所有已注册公钥，你只需要生成新密钥对（-f 参数指定不同文件名），再将新公钥添加到平台账户的 SSH Keys 列表即可，但注意：本地 ~/.ssh/config 中不要为同一主机绑定多个 IdentityFile，否则可能随机选择导致认证失败，推荐做法是：新密钥仅用于另一台电脑的独立用户，或在同一台电脑上使用不同的平台账号。