GitLab SourceTree 使用SSH克隆仓库 - 以【Windows】为例（图文版）

使用 SourceTree 通过 SSH 克隆 GitLab 仓库核心是先配置好 SSH 密钥让 GitLab 信任你的本地电脑再用 SSH 地址在 SourceTree 中完成克隆。目录一、生成并配置 SSH 密钥关键前提1、生成 SSH 密钥1打开终端2执行以下命令替换为你的 GitLab 注册邮箱3按回车确认密钥保存路径默认路径Windows 是 C:\Users\你的用户名\.ssh\4按回车跳过 “输入密码”也可以设置密码每次拉取 / 推送时需要验证更安全5执行完成后会生成两个文件id_ed25519私钥不要泄露和 id_ed25519.pub公钥需要上传到 GitLab6查找密钥文件2、将公钥添加到 GitLab1打开 GitLab 官网登录你的账号2点击右上角头像 → 编辑个人资料→ 左侧菜单 SSH密钥3查找.ssh文件夹打开id_ed25519.pub文件并复制公钥内容4把复制的公钥内容粘贴到 GitLab 的【密钥】输入框中标题可以自定义比如 “我的电脑”点击【添加密钥】保存3、验证 SSH 连接确保配置成功问题一解决办法1、直接输入 yes注意是全小写不能输 y 或 Yes然后按回车2、警告已将“gitlab.com”ED25519永久添加至已知主机列表中二、在 SourceTree 中克隆 GitLab 仓库1、获取 GitLab 仓库的 SSH 地址1打开 GitLab 目标仓库页面2点击右上角的 克隆 → 复制完整的 SSH 地址格式ssh://gitgitlab.com:用户名/仓库名.git2、SourceTree 克隆操作1打开 SourceTree点击左上角 文件 → 克隆/新建或直接点击首页的 克隆2在弹出的窗口中填写信息提示一“接受服务器密钥”解决办法1、如下图所示点击是2、如下图所示点击确定提示二“启动SSH代理”解决办法场景 1如下图所示点击 “是”让 SourceTree 自动启动 Pageant 并重试场景 2手动配置 SourceTree避免后续重复弹窗推荐3点击 克隆等待完成即可三、常见问题解决1、SourceTree 提示 “SSH 认证失败”2、Windows 找不到 SSH 密钥四、总结1、核心前提2、克隆步骤3、排错关键欢迎关注VX公众号前端小知识营地一、生成并配置 SSH 密钥关键前提如果你的电脑还没有 SSH 密钥或者密钥未添加到 GitLab需要先完成这一步1、生成 SSH 密钥1打开终端2执行以下命令替换为你的 GitLab 注册邮箱ssh-keygen -t ed25519 -C 你的邮箱example.com3按回车确认密钥保存路径默认路径Windows 是C:\Users\你的用户名\.ssh\4按回车跳过 “输入密码”也可以设置密码每次拉取 / 推送时需要验证更安全5执行完成后会生成两个文件id_ed25519私钥不要泄露和id_ed25519.pub公钥需要上传到 GitLab6查找密钥文件注如果文件夹目录没有.ssh可参照下方图片进行操作2、将公钥添加到 GitLab1打开 GitLab 官网登录你的账号2点击右上角头像 → 编辑个人资料→ 左侧菜单SSH密钥3查找.ssh文件夹打开id_ed25519.pub文件并复制公钥内容type C:\Users\你的用户名\.ssh\id_ed25519.pub全选复制4把复制的公钥内容粘贴到 GitLab 的【密钥】输入框中标题可以自定义比如 “我的电脑”点击【添加密钥】保存3、验证 SSH 连接确保配置成功ssh -T gitgitlab.com如果出现Welcome to GitLab, 你的用户名!说明 SSH 配置成功。注SSH 首次连接 GitLab 服务器时本地没有信任该服务器的 SSH 主机密钥可能会出现的问题。问题一The authenticity of host gitlab.com (xxx.xxx.xxx.xxx) cant be established. ED25519 key fingerprint is XXXXXX:XXXXXXXXXXXXXXXXXXXXXXXXX. This key is not known by any other names. Are you sure you want to continue connecting (yes/no/[fingerprint])?解决办法1、直接输入yes注意是全小写不能输y或Yes然后按回车2、警告已将“gitlab.com”ED25519永久添加至已知主机列表中二、在 SourceTree 中克隆 GitLab 仓库1、获取 GitLab 仓库的 SSH 地址1打开 GitLab 目标仓库页面2点击右上角的 克隆 → 复制完整的 SSH 地址格式ssh://gitgitlab.com:用户名/仓库名.git2、SourceTree 克隆操作1打开 SourceTree点击左上角文件→克隆/新建或直接点击首页的克隆2在弹出的窗口中填写信息源路径 / URL粘贴刚才复制的 GitLab SSH 地址注可能会出现一些弹框提示提示一“接受服务器密钥”SourceTree 本质是 Git 图形界面工具克隆时会调用本地 SSH 客户端连接 GitLab 服务器首次连接时SSH 客户端会验证 GitLab 服务器的 “主机密钥”相当于服务器的身份证为了防止你连接到伪造的 GitLab 服务器必须由你手动确认信任。解决办法1、如下图所示点击是2、如下图所示点击确定提示二“启动SSH代理”SSH 密钥代理PageantWindows 下用来管理 SSH 私钥的工具SourceTree 依赖它加载私钥完成认证认证失败原因要么是私钥没被 Pageant 加载要么是 SourceTree 的 SSH 配置没指向系统密钥用了内置的 PuTTY 密钥格式。解决办法场景 1如下图所示点击 “是”让 SourceTree 自动启动 Pageant 并重试这是最简便的方式适合新手弹出 “启动 SSH 代理” 弹窗后点击“是”此时会弹出 Pageant 的密钥添加窗口标题是 “Select Private Key File”找到你生成的 SSH 私钥文件路径C:\Users\你的用户名\.ssh\id_ed25519选中后点击 “打开”如果私钥设置了密码生成时你输入了密码会提示输入密码输入后确认完成后 SourceTree 会自动重试克隆此时就能正常认证了。场景 2手动配置 SourceTree避免后续重复弹窗推荐如果点击 “是” 后仍失败或想彻底解决后续不弹需调整 SourceTree 的 SSH 配置关闭克隆弹窗打开 SourceTree → 点击顶部「工具」→「选项」切换到「SSH 客户端」选项卡把 “SSH 客户端” 从「PuTTY/Plink」改成「OpenSSH」确认 “OpenSSH 路径” 指向系统的 ssh.exe通常是C:\Windows\System32\OpenSSH\ssh.exeSourceTree 会自动识别点击「确定」重启 SourceTree重新走克隆流程粘贴 SSH 地址 → 克隆此时不会再弹 Pageant 提示因为用了系统 OpenSSH直接读取.ssh目录下的私钥。复制SSH 地址复制 GitLab SSH 地址克隆SourceTree的首页点击克隆源路径 / URL粘贴刚才复制的 GitLab SSH 地址比如gitgitlab.com:test/project.git目标路径选择本地要保存仓库的文件夹比如D:\project。名称自定义仓库在 SourceTree 中的显示名称。3点击克隆等待完成即可三、常见问题解决1、SourceTree 提示 “SSH 认证失败”检查 SSH 密钥是否正确添加到 GitLab公钥是否完整邮箱是否匹配。确认 SourceTree 使用的是系统 SSH而非内置SourceTree → 偏好设置 → 高级 → 取消勾选 “使用内置的 Git 库”重启 SourceTree。2、Windows 找不到 SSH 密钥确认密钥保存在C:\Users\你的用户名\.ssh\目录下且文件名是id_ed25519/id_ed25519.pub如果用 RSA 算法是id_rsa/id_rsa.pub。四、总结1、核心前提必须先生成 SSH 密钥并将公钥添加到 GitLab否则无法通过 SSH 克隆 / 操作仓库。2、克隆步骤复制 GitLab 仓库的 SSH 地址 → 在 SourceTree 中填写地址和本地路径 → 点击克隆即可。3、排错关键SSH 认证失败优先检查密钥配置和 SourceTree 的 SSH 环境设置。欢迎关注VX公众号前端小知识营地