GitLab 公钥配置完整指南（含 Windows 实操）​

一、前置准备：确认本地 SSH 密钥已生成​

首先确保你已按照之前的修正步骤，在 Git Bash 中成功生成 SSH 密钥对（若未生成，先执行以下命令）：​

# 生成4096位RSA密钥，替换为你的GitLab绑定邮箱

ssh-keygen -t rsa -b 4096 -C "邮箱"

# 生成4096位RSA密钥，替换为你的GitLab绑定邮箱​

生成成功后，密钥文件默认存储在 C:\Users\你的用户名\.ssh\ 目录，关键文件包括：​

• id_rsa：私钥（不可泄露，权限需设为仅当前用户可读）​

• id_rsa.pub：公钥（需上传到 GitLab 的文件，以ssh-rsa开头）​

二、核心步骤：GitLab 平台添加公钥​

1. 复制本地公钥内容（两种方式任选）​

方式 1：通过 Git Bash 命令复制（推荐，避免格式错误）​

在 Git Bash 中执行以下命令，公钥内容会自动复制到系统剪贴板：​

​# 若使用默认密钥文件名

cat ~/.ssh/id_rsa.pub | clip

# 若自定义了密钥文件名（如id_rsa_sony），替换为实际文件名

# cat ~/.ssh/id_rsa_sony.pub | clip

# 若使用默认密钥文件名​

cat ~/.ssh/id_rsa.pub | clip​

# 若自定义了密钥文件名（如id_rsa_sony），替换为实际文件名​

# cat ~/.ssh/id_rsa_sony.pub | clip​

方式 2：手动打开文件复制​

1. 打开文件夹 C:\Users\你的用户名\.ssh\，找到 id_rsa.pub 文件​

1. 用记事本或 Notepad++ 打开（不要用 Word 或 WPS，避免格式错乱）​

1. 全选内容（从ssh-rsa开头到邮箱结尾），右键复制​

注意：复制时需确保无多余空格、换行或字符缺失，否则 GitLab 会提示 “公钥格式错误”。​

​

2. 登录 GitLab 并进入 SSH 密钥设置页​

1. 打开公司 GitLab 地址（如 https://gitlab.sony.com），输入账号密码登录​

1. 点击页面右上角 头像 → 选择 Settings（设置），进入个人配置页​

1. 在左侧菜单栏中找到并点击 SSH Keys（SSH 密钥），进入密钥管理页面​

3. 填写并提交公钥​

1. 点击页面右上角 Add SSH key（添加 SSH 密钥）按钮，打开添加表单​

1. 填写表单信息：​

• Title（标题）：自定义名称，便于区分设备（如 “Windows - 办公电脑 - 公司”）​

• Key（密钥）：粘贴步骤 1 中复制的公钥内容（确保完整覆盖 id_rsa.pub）​

• Expires at（过期时间，可选）：若公司有安全要求，可设置过期时间（如 3 个月后）​

1. 点击 Add key 按钮提交，部分 GitLab 实例会要求二次验证（如输入密码或验证码）​

提交后若出现 “Key is already in use” 提示，说明该公钥已绑定到其他 GitLab 账户，需联系管理员解绑或生成新密钥。