配置SSH密钥实现Git免密码操作

在使用Git进行代码版本控制时，频繁输入用户名和密码不仅繁琐，而且存在安全隐患。通过配置SSH密钥，我们可以实现免密码操作，提升工作效率和安全性。本文将以Gitee为例，详细介绍SSH密钥的配置过程，该方法同样适用于GitHub、GitLab等其他Git托管平台。

什么是SSH密钥

SSH（Secure Shell）是一种网络协议，用于在不安全的网络上安全地访问网络服务。SSH密钥是一对加密密钥，包含一个公钥和一个私钥：

• 私钥：保存在本地计算机上，必须严格保密
• 公钥：可以公开分享，需要添加到Git托管平台（如Gitee）的账户设置中

通过这种非对称加密方式，我们可以安全地进行身份验证，无需每次都输入密码。

生成SSH密钥对

Windows系统

1. 打开Git Bash（如果没有安装Git，请先安装）
2. 运行以下命令生成SSH密钥对：

1

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

将 your_email@example.com 替换为你在Gitee注册时使用的邮箱地址。

3. 按提示操作：
   • 选择密钥保存位置（直接回车使用默认位置）
   • 设置密码短语（可选，增加安全性，但每次使用都需要输入）

生成的密钥默认保存在 ~/.ssh/ 目录下：

• 私钥：id_rsa
• 公钥：id_rsa.pub

macOS系统

1. 打开终端
2. 运行相同的命令：

1

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

3. 按提示操作，与Windows系统相同

Linux系统

1. 打开终端
2. 运行相同的命令：

1

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

3. 按提示操作，与Windows系统相同

查看并复制公钥

生成密钥对后，需要将公钥添加到Gitee账户中。

查看公钥内容

在终端或Git Bash中运行以下命令：

1

cat ~/.ssh/id_rsa.pub

你会看到类似以下内容的输出：

1

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC6... your_email@example.com

复制公钥

选中并复制全部内容，包括开头的 ssh-rsa 和结尾的邮箱地址。

在Gitee中添加SSH公钥

1. 登录Gitee账户
2. 点击右上角头像，选择【个人设置】
3. 在左侧菜单中选择【SSH公钥】
4. 在【公钥内容】文本框中粘贴刚才复制的公钥内容
5. 在【公钥名称】中输入一个易于识别的名称（如：个人笔记本、工作电脑等）
6. 点击【确定】按钮

验证SSH密钥配置

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

1

ssh -T git@gitee.com

如果是第一次连接，系统会提示确认主机 authenticity，输入 yes 确认。

如果配置成功，你会看到类似以下的欢迎信息：

1

Hi YourUsername! You've successfully authenticated, but GITEE.COM does not provide shell access.

在Git中使用SSH协议

克隆仓库

使用SSH协议克隆仓库时，URL格式如下：

1

git clone git@gitee.com:username/repository.git

修改现有仓库的远程URL

如果已有使用HTTPS协议的仓库，可以修改为SSH协议：

1
2
3
4
5

# 查看当前远程URL
git remote -v

# 修改为SSH协议
git remote set-url origin git@gitee.com:username/repository.git

常见问题及解决方案

1. Permission denied (publickey) 错误

如果遇到此错误，请检查：

1. 公钥是否正确添加到Gitee账户中
2. 私钥文件权限是否正确（通常应为600）
3. SSH agent是否正在运行并加载了私钥：

1
2

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_rsa

2. Windows系统下的换行符问题

Windows系统生成的密钥可能包含换行符问题，可以尝试：

1. 使用文本编辑器打开公钥文件
2. 确保所有内容在一行内
3. 重新复制并添加到Gitee

3. 多个SSH密钥管理

如果有多个Git账户（如个人和工作），可以配置不同的密钥：

1. 生成不同名称的密钥：

1

ssh-keygen -t rsa -C "work@example.com" -f ~/.ssh/id_rsa_work

2. 创建或编辑 ~/.ssh/config 文件：

1
2
3
4
5
6
7
8
9
10
11

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

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

3. 使用时指定主机：

1

git clone git@gitee-work:username/repository.git

安全建议

1. 保护私钥：私钥文件应严格保密，不要分享给他人
2. 使用密码短语：为私钥设置密码短语增加安全性
3. 定期更换：定期更换SSH密钥对，特别是在怀疑泄露时
4. 及时删除：不再使用的公钥应及时从Git平台删除

总结

通过配置SSH密钥，我们可以：

• 避免每次操作时输入用户名和密码
• 提高代码推送和拉取的效率
• 增强账户安全性
• 实现自动化脚本的无缝运行

这一配置方法不仅适用于Gitee，也同样适用于GitHub、GitLab等其他Git托管平台。掌握SSH密钥的配置和使用，是每个Git用户都应该具备的基本技能。