按以下步骤为你的 Git 账号配置 SSH 密钥:
1. 生成新的 SSH 密钥(若尚未拥有)
打开终端(Linux/macOS 直接用系统终端,Windows 推荐用 Git Bash 或 PowerShell),执行以下命令:
bash
ssh-keygen -t ed25519 -C "你的邮箱地址@示例.com"
- 按回车键接受默认的密钥存储路径(通常是
~/.ssh/id_ed25519
); - 可选:设置一个密码短语(passphrase),为密钥增加额外安全保护(后续使用 SSH 时需输入该密码)。
2. 查看你的公钥内容
执行以下命令,显示公钥文件的全部内容(公钥以 .pub
结尾,需复制完整内容):
bash
# Linux/macOS 系统
cat ~/.ssh/id_ed25519.pub
# Windows 系统(使用 Git Bash 或 PowerShell)
cat /c/Users/你的用户名/.ssh/id_ed25519.pub
复制输出结果的全部内容 (格式以 ssh-ed25519
开头,以你的邮箱地址结尾,不要遗漏任何字符)。
3. 将 SSH 密钥添加到 GitLab 个人资料
- 登录你的 GitLab 账号(如
http://gitlab.xach.lo
); - 点击右上角的个人头像 → 选择 Preferences(偏好设置);
- 在左侧导航栏中,找到并点击 SSH Keys(SSH 密钥);
- 在 Key(密钥) 输入框中,粘贴刚才复制的公钥内容;
- 在 Title(标题) 栏填写描述(如 "工作电脑""家用笔记本",方便区分不同设备的密钥);
- 点击 Add key(添加密钥) 完成操作。
4. 测试 SSH 连接是否正常
执行以下命令,验证密钥是否配置成功:
bash
ssh -T git@gitlab.aaa.lo
- 若首次连接,可能会提示 "是否继续连接",输入
yes
并回车; - 成功后会显示类似消息:
Welcome to GitLab, @你的GitLab用户名!
(表示连接已建立)。
完成以上步骤后,你就能通过 SSH 协议推送(git push
)或拉取(git pull
)GitLab 仓库了。注意后续操作仓库时,需使用 SSH 格式的仓库地址(例如 git@gitlab.aaa.lo:aa/project/2020/fibre.git
),而非 HTTPS 地址。