使用SSH密钥在Git服务器上免密码提交代码

在使用Git进行版本控制时，每次提交代码时都要求输入用户名和密码，这对于频繁提交的开发者来说会显得十分繁琐。通过配置SSH密钥，可以实现免密码提交代码，既提升了工作效率，也增强了安全性。本文将介绍如何在Git服务器上使用SSH密钥进行身份验证，替代每次输入账户密码的方式。

为什么选择SSH密钥？

相比于使用HTTP方式（每次提交都需要输入用户名和密码），SSH密钥提供了更高效和安全的验证机制。通过生成的公钥和私钥，SSH可以在不暴露密码的情况下实现加密通信，避免凭据泄露的风险。

配置SSH密钥的步骤

以下是配置SSH密钥的完整流程，以GitHub为例，其他Git服务平台（如GitLab、Bitbucket）过程类似。

1. 生成SSH密钥

首先，需要在本地机器上生成一对SSH密钥对。如果已经有现成的SSH密钥，可以跳过此步骤。

在终端中执行以下命令生成SSH密钥：

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

• -t rsa：指定生成的密钥类型为RSA。
• -b 4096：指定密钥长度为4096位，增加密钥的安全性。
• -C "your_email@example.com"：添加一段注释，通常是你的邮箱，便于标识该密钥的用途。

运行命令后，系统会提示你选择保存密钥的位置，按回车即可使用默认路径（~/.ssh/id_rsa）。接着，会询问是否为密钥设置密码保护，建议设置，但如果你希望避免每次使用SSH时输入密码，可以直接回车跳过。

2. 将公钥添加到Git平台

SSH密钥对生成后，公钥需要添加到Git服务平台的账户中。

查看生成的公钥

运行以下命令查看生成的公钥内容：

cat ~/.ssh/id_rsa.pub

复制终端输出的公钥内容。

添加公钥到GitHub

1. 登录 GitHub 账户。
2. 点击右上角头像，选择 Settings。
3. 在左侧栏中，选择 SSH and GPG keys。
4. 点击 New SSH key 按钮。
5. 在 Title 中为这把公钥起个名字，例如 “Ubuntu Server”。
6. 将复制的公钥内容粘贴到 Key 框中，然后点击 Add SSH key。

3. 配置SSH使用Git仓库

在本地的Git仓库中，使用SSH URL替换原来的HTTPS URL。可以通过以下命令更改远程仓库的URL：

先查看当前Git仓库的远程地址：

git remote -v

如果远程仓库URL使用的是https://，则需要将其修改为ssh://。

修改为SSH URL，例如：

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

这里将username替换为你的GitHub用户名，repo替换为你的仓库名。

4. 测试SSH连接

在完成配置后，可以通过以下命令测试SSH连接是否成功：

ssh -T git@github.com

如果SSH配置正确，会出现类似如下的提示：

Hi username! You've successfully authenticated, but GitHub does not provide shell access.

这表示SSH密钥已经成功配置，可以通过SSH免密码与GitHub进行交互了。

5. 提交代码

配置完成后，便可以像往常一样提交代码，但无需再输入用户名和密码。直接执行git push命令时，系统会自动使用SSH密钥进行身份验证。

git add .
git commit -m "commit message"
git push

如果为SSH密钥设置了密码保护，首次使用时可能会要求输入密钥的密码。

管理多账户和多密钥（可选）

如果在同一台机器上需要管理多个Git账户（例如工作账户和个人账户），可以通过配置SSH配置文件来管理多个SSH密钥。以下是配置方法：

打开或创建SSH配置文件：

nano ~/.ssh/config

在文件中添加类似以下内容：

# 个人账户
Host github.com-personal
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_rsa_personal

# 工作账户
Host github.com-work
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_rsa_work

将Git远程仓库的URL修改为配置文件中的别名，例如：

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

这样就可以通过不同的SSH密钥来管理不同的Git账户。

总结

通过SSH密钥配置，可以避免每次提交代码时输入用户名和密码，提升了开发体验。SSH密钥提供了更安全的身份验证机制，是连接Git服务器的最佳实践。通过简单的配置，即可轻松实现免密码提交代码，提高开发效率。

文章作者： Alan Zeng

原始链接： https://alanzeng.com/blogs/31461/

版权说明：本博客所有文章除特别声明外，均采用BY-NC-SA 4.0许可协议 。获得许可后，要求转载时注明文章出处和网站链接，谢谢！