如何配置GitLab的SSH密钥

如何配置GitLab的SSH密钥
SSH密钥是GitLab实现安全身份验证的核心方式，替代传统密码认证，提升代码托管与协作的安全性。以下是详细的配置步骤：

1. 检查现有SSH密钥（可选但推荐）

在生成新密钥前，建议先检查本地是否已有可用密钥，避免重复创建。打开终端（Linux/macOS为系统终端，Windows推荐使用Git Bash），执行以下命令：

ls -al ~/.ssh

若输出中包含id_rsa.pub（公钥）或id_ed25519.pub（Ed25519密钥），说明已有密钥，可直接跳至步骤3；若未找到，则需生成新密钥。

2. 生成SSH密钥对

SSH密钥对由私钥（id_rsa/id_ed25519，需严格保密）和公钥（id_rsa.pub/id_ed25519.pub，需上传至GitLab）组成。推荐使用Ed25519算法（安全性更高），命令如下：

ssh-keygen -t ed25519 -C "你的邮箱地址@example.com"

若需使用RSA算法（兼容旧系统），可替换为：

ssh-keygen -t rsa -b 4096 -C "你的邮箱地址@example.com"

交互提示说明：

• 保存路径：直接按Enter键接受默认路径（~/.ssh/id_ed25519或~/.ssh/id_rsa）；
• 密码短语：可选设置（增强私钥安全性，每次使用私钥时需输入），若不想设置则直接按Enter键跳过。

3. 获取SSH公钥内容

生成密钥后，需复制公钥内容至GitLab。执行以下命令查看公钥（以id_ed25519.pub为例）：

cat ~/.ssh/id_ed25519.pub

或使用clip命令（Windows Git Bash）直接复制到剪贴板：

clip <
     ~/.ssh/id_ed25519.pub

注意：公钥内容以ssh-ed25519（Ed25519）或ssh-rsa（RSA）开头，以你的邮箱地址结尾，需完整复制（勿遗漏换行符或空格）。

4. 将公钥添加至GitLab账户

登录GitLab官网，进入个人设置：

1. 点击右上角头像→选择Preferences（偏好设置）；
2. 在左侧导航栏找到SSH Keys（SSH密钥）；
3. 在Key文本框中粘贴复制的公钥内容；
4. 在Title栏输入描述性名称（如“工作电脑-联想ThinkPad”“家用笔记本-MacBook Air”），便于区分不同设备的密钥；
5. 点击**Add key（添加密钥）**按钮完成保存。

5. 测试SSH连接

配置完成后，需验证密钥是否生效。执行以下命令（将gitlab.example.com替换为你的GitLab服务器域名或IP）：

ssh -T git@gitlab.example.com

首次连接提示：若出现“Are you sure you want to continue connecting (yes/no)?”，输入yes并回车；
成功标志：若显示“Welcome to GitLab, @你的GitLab用户名!”，说明SSH密钥配置成功。

6. （可选）配置多个SSH密钥

若需管理多个GitLab账户或服务器，可通过修改~/.ssh/config文件（不存在则创建）指定不同密钥：

nano ~/.ssh/config

添加以下内容（示例）：

# 默认GitLab服务器
Host gitlab.com
    HostName gitlab.com
    User git
    IdentityFile ~/.ssh/id_ed25519

# 公司内部GitLab服务器
Host gitlab.company.com
    HostName gitlab.company.com
    User git
    IdentityFile ~/.ssh/id_ed25519_company

保存后，使用对应Host别名即可连接不同服务器（如ssh -T git@gitlab.company.com）。

7. （可选）保护SSH密钥

• 私钥权限：确保私钥文件的权限为600（仅所有者可读写），执行以下命令修改：

  chmod 600 ~/.ssh/id_ed25519
  

• 密码短语：若生成密钥时设置了密码短语，可使用ssh-agent缓存密码（避免每次使用都输入），命令如下：

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

• 定期更换：建议每6-12个月更换一次SSH密钥，提升安全性。

完成以上步骤后，你即可通过SSH协议克隆、推送或拉取GitLab仓库，无需每次输入用户名和密码（需使用SSH格式的仓库地址，如git@gitlab.example.com:group/project.git）。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！