当前位置：首页 > 虚拟主机 > 正文

Git如何配置SSH Key，Git生成SSH Key详细步骤

admin
虚拟主机
2026-02-23
3281

配置Git SSH Key是提升代码托管安全性与操作效率的必经之路，通过非对称加密技术，SSH Key实现了开发环境与代码托管平台（如GitHub、GitLab、Gitee）之间的免密身份验证，彻底摒弃了不安全的HTTPS密码验证方式，这不仅保障了代码资产在传输过程中的绝对安全，更消除了每次推送或拉取代码时重复输入凭证的繁琐流程，是构建现代化、自动化DevOps工作流的基础设施。

SSH Key配置的核心价值与原理

在深入操作步骤之前，理解SSH Key的运作机制有助于排查后续可能出现的问题，SSH（Secure Shell）协议采用公钥和私钥配对的方式进行认证。私钥必须严格保存在本地开发环境中，如同个人的身份证件，绝不可泄露；而公钥则部署在远程服务器上，相当于门锁，当本地发起连接请求时，服务器会利用公钥挑战客户端，客户端使用私钥应答，匹配成功即建立信任，对于Git操作而言，这意味着无需明文传输密码，且密钥长度通常远高于传统密码,暴力免费难度呈指数级上升。

生成与配置SSH Key的标准化流程

配置过程主要分为检查现有环境、生成密钥对、托管公钥及验证连接四个阶段，以下操作以目前最推荐的Ed25519算法为例,该算法在安全性和性能上均优于传统的RSA算法。

第一步：检查现有密钥

在生成新密钥前，建议先检查本地是否已存在SSH密钥，避免不必要的覆盖，打开终端（Terminal、Git Bash或PowerShell），输入以下命令列出SSH目录下的文件：

ls -al ~/.ssh

如果输出结果中包含 id_ed25519.pub 或 id_rsa.pub，则表示已有密钥，可直接复用，若没有，或为了项目隔离需要新建密钥,则继续下一步。

第二步：生成新的SSH密钥

执行生成命令，并指定注释信息（通常为邮箱）以便识别：

ssh-keygen -t ed25519 -C "your_email@example.com"

系统提示输入保存文件路径时，直接回车使用默认路径；提示设置 passphrase（密钥密码）时，建议留空，虽然设置 passphrase 能增加一层物理安全，但在配置自动化CI/CD流程时，若未处理密码交互,会导致脚本执行失败。

第三步：将公钥添加到SSH代理

为了确保系统能够识别私钥，需要将私钥注册到SSH Agent中，首先启动代理：

eval "$(ssh-agent -s)"

然后添加私钥：

ssh-add ~/.ssh/id_ed25519

若遇到“Could not open a connection to your authentication agent”错误，通常是ssh-agent服务未启动，上述 eval 命令即可解决。

第四步：复制公钥至代码托管平台

公钥文件的后缀为 .pub，使用文本编辑器打开，或使用命令直接复制内容（以macOS为例）：

pbcopy < ~/.ssh/id_ed25519.pub

登录GitHub、GitLab或Gitee，进入“Settings” -> “SSH and GPG keys”或“SSH公钥”页面，点击“New SSH Key”或“添加公钥”，将复制的内容粘贴至Key输入框，Title可自定义为本机名称，保存后,即完成了授权绑定。

第五步：验证连接

配置的最后一步是验证，输入测试命令：

ssh -T git@github.com

若系统提示 “Hi username! You’ve successfully authenticated…”，则说明配置成功，如果出现“Permission denied (publickey)”，则需检查公钥是否正确粘贴，或本地私钥权限是否正确（应设置为600）。

西西云实战经验：云服务器上的自动化部署

在实际的企业级开发中，Git SSH Key的配置不仅限于本地电脑，更是云服务器自动化部署的关键。以西西云的云服务器产品为例，许多用户在搭建Web集群或CI/CD流水线时,需要服务器自动从Git仓库拉取最新代码。

Git如何配置SSH Key，Git生成SSH Key详细步骤第1张

经验案例：

某次协助一位在西西云上部署电商网站的用户解决自动化发布失败的问题，该用户编写了Shell脚本，利用 git pull 更新代码，但每次通过Crontab定时任务执行时都报错，经排查，是因为HTTPS链接在脚本中无法交互式输入密码,且Token有时效性限制。

解决方案：

我们在西西云的云服务器上为该应用创建了专属的Git用户（如 www-data），并按照上述流程生成了SSH Key，关键在于，我们将该服务器的公钥配置为了Git仓库中的“Deploy Key”（部署密钥），并开启了写入权限，这样，服务器上的脚本即可通过SSH协议免密拉取代码，结合西西云高性能计算实例的稳定性，该方案不仅解决了定时任务失败的问题，还将代码部署时间缩短了50%以上，真正实现了“提交即发布”的无缝体验，这一案例表明，在云端环境中，SSH Key是连接版本控制与生产环境最可靠的桥梁。

进阶管理：多平台与多账户配置

对于同时管理GitHub（公司账号）、Gitee（个人账号）和GitLab的开发者，单一的 id_ed25519 可能会导致权限冲突，需要利用SSH配置文件（~/.ssh/config）进行精细化管理。

在 ~/.ssh 目录下创建 config 文件,并写入以下内容：

Git如何配置SSH Key，Git生成SSH Key详细步骤第2张

Host github.com

HostName github.com

User git

IdentityFile ~/.ssh/id_ed25519_github

Host gitee.com

HostName gitee.com

User git

IdentityFile ~/.ssh/id_ed25519_gitee

通过这种方式，系统会根据连接的域名自动切换对应的私钥文件，在克隆仓库时，依然使用标准的 git clone git@github.com:user/repo.git 格式，SSH客户端会自动读取配置文件中的 IdentityFile，实现多账户的无缝切换，这是处理复杂开发环境的专业解决方案,能有效避免身份混淆带来的推送失败。