1. 检查是否已有 SSH 密钥
打开终端,输入以下命令检查是否存在密钥:
ls ~/.ssh
如果看到 id_rsa 和 id_rsa.pub 文件,则表示已有密钥,可直接使用。如果没有,继续下一步生成密钥。
2. 生成新的 SSH 密钥
在终端中运行以下命令生成密钥:
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
替换 your_email@example.com 为你的邮箱地址。 按提示按回车键保存到默认路径(~/.ssh/id_rsa),并可选择设置密码短语(可留空)。
3. 查看并复制公钥
使用以下命令查看生成的公钥:
cat ~/.ssh/id_rsa.pub
将输出的内容复制到剪贴板。
4. 添加公钥到 GitLab
登录 GitLab。点击右上角头像,选择 Settings(设置)。在左侧菜单中找到 SSH Keys,点击进入。将复制的公钥粘贴到 Key 输入框中,并为密钥设置一个描述性标题(如"工作电脑")。点击 Add Key 完成添加。
5. 验证配置是否成功
在终端中运行以下命令测试连接:
ssh -T git@gitlab.com
如果配置成功,会显示类似以下信息:
Welcome to GitLab, @your_username!
常见问题及解决方法
无法连接 GitLab:检查网络连接和防火墙设置,确保 SSH 服务未被阻止。