Windows 10 下 Gitee SSH 连接配置详解(附常见问题解决)

还在每次 git push 时输入账号密码?配置 SSH 密钥后,一键操作,安全又高效。本文手把手带你完成 Windows 10 上 Gitee 的 SSH 连接配置,并解决克隆时仍弹出登录框的典型问题。


一、为什么要使用 SSH?

  • 免密操作 :配置一次,后续 clone、push、pull 无需再输入用户名和密码。
  • 更安全:使用非对称加密,私钥本地保存,公钥托管在 Gitee,避免密码在网络中传输。
  • 提升效率:尤其适合频繁交互的开发场景。

二、准备工作

1. 安装 Git for Windows

  • 访问 Git 官网 下载 64 位安装包。
  • 安装时,在 "调整你的 PATH 环境" 步骤,务必选择 "Git from the command line and also from 3rd-party software",以便在 PowerShell 或 CMD 中调用 Git 命令。
  • 安装完成后,在桌面右键菜单中应出现 "Git Bash Here" 选项。

2. 检查 Windows 10 自带的 OpenSSH 客户端(可选)

  • Windows 10 1809 及以上版本已内置 OpenSSH 客户端,可通过 ssh -V 检查。
  • 若没有,Git for Windows 自带 SSH 工具,无需额外安装。

三、生成 SSH 密钥对

打开 PowerShell 或 Git Bash,执行以下命令:

bash 复制代码
ssh-keygen -t ed25519 -C "你的Gitee绑定邮箱"

推荐使用 ed25519 算法,性能与安全性均优于 RSA。-C 后的邮箱仅作为注释,方便识别。

按提示操作:

  • 密钥保存路径 :默认 ~/.ssh/id_ed25519,直接回车。
  • 密码短语(passphrase):可留空,直接回车三次(无密码)。

生成成功后会得到两个文件:

  • id_ed25519 ------ 私钥(妥善保管,勿泄露)
  • id_ed25519.pub ------ 公钥(待会上传到 Gitee)

四、将公钥添加到 Gitee

  1. 登录 Gitee,点击右上角头像 → 设置。
  2. 左侧菜单选择 "SSH公钥"。
  3. 点击 "添加公钥" :
    • 标题:任意描述,如 "我的 Windows 笔记本"。
    • 公钥 :将 ~/.ssh/id_ed25519.pub 的内容完整复制粘贴进去。
  4. 确认并完成身份验证。

获取公钥内容的命令:

bash 复制代码
cat ~/.ssh/id_ed25519.pub

复制输出内容(以 ssh-ed25519 开头)。


五、验证 SSH 连接

在终端执行:

bash 复制代码
ssh -T git@gitee.com
  • 首次连接 :会提示确认主机指纹,输入 yes 回车。

  • 成功标志 :返回类似以下信息:

    复制代码
    Hi 用户名! You've successfully authenticated, but GITEE.COM does not provide shell access.

    这说明 SSH 认证已通过,可以愉快地使用 Git 了。


六、克隆仓库(关键一步)

此处容易踩坑! 克隆时请务必使用 SSH 协议地址,而非 HTTPS。

在 Gitee 项目页,点击 "克隆/下载" ,切换到 SSH 标签 ,复制形如 git@gitee.com:用户名/仓库名.git 的地址。

正确克隆命令:

bash 复制代码
git clone git@gitee.com:你的用户名/仓库名.git

七、常见问题:克隆时仍弹出登录框要求输入用户名密码

现象

明明已配置 SSH,但执行 git clone https://gitee.com/... 时,依然弹出 Git 凭据管理器或要求输入账号密码。

原因

  • HTTPS 和 SSH 是两套独立认证机制。用 HTTPS 地址克隆,Git 自然要求提供 Gitee 账号密码,不会自动走 SSH。

解决方案

方案一:改用 SSH 地址重新克隆
bash 复制代码
# 先删除已存在的目录(若有)
rm -rf 仓库名
# 使用 SSH 地址
git clone git@gitee.com:用户名/仓库名.git
方案二:将已克隆的 HTTPS 仓库远程地址修改为 SSH

如果你已经用 HTTPS 克隆了,可以修改远程地址:

bash 复制代码
cd 仓库目录
git remote set-url origin git@gitee.com:用户名/仓库名.git

之后 git push、git pull 都会走 SSH。


八、进阶:多账号管理(可选)

若你需要在同一台电脑上管理多个 Gitee 账号(如个人和工作),可通过 ~/.ssh/config 文件配置不同 Host 别名。

示例配置:

复制代码
# 个人账号
Host gitee.com
  HostName gitee.com
  User git
  IdentityFile ~/.ssh/id_ed25519_personal

# 工作账号
Host work.gitee.com
  HostName gitee.com
  User git
  IdentityFile ~/.ssh/id_ed25519_work

克隆时使用:

bash 复制代码
git clone git@work.gitee.com:公司组织/仓库.git

九、总结

  1. 生成密钥 → ssh-keygen -t ed25519 -C "邮箱"
  2. 添加公钥 → Gitee 设置 → SSH 公钥
  3. 验证 → ssh -T git@gitee.com
  4. 克隆时务必使用 SSH 地址 (git@gitee.com:...),避免误用 HTTPS。

搞定以上步骤,从此告别 Git 操作时的密码输入,让开发流程更加丝滑。如果在配置过程中遇到其他问题,欢迎在评论区留言交流!


📌 本文首发于 CSDN,转载请注明出处。如果觉得有帮助,点个赞支持一下吧!

相关推荐
Vex2une20 小时前
JDK 8 下载安装与环境变量配置完整指南(Windows新手图文教程)
java·windows·环境配置·环境变量·jdk8·jdk下载安装·java入门教程
星空孤辰1 天前
【camera 008】android camera id 注册、状态监控等状态变化 全流程梳理
android·windows
全方位办公软件1 天前
Windows音频服务架构解析:AudioSrv与AudioEndpointBuilder排障
windows·命令行·powershell·音频服务·驱动修复·mmdevices·audiosrv
Vex2une2 天前
电脑装双系统怎么弄?Win+Win 与 Win+Linux 安装及启动菜单管理全攻略
linux·windows·电脑·uefi·双系统安装·bcdedit启动项
无情的西瓜皮2 天前
eMudhra 根证书自 11-16 起失去微软产品默认信任:4 步 PowerShell 自查你的 Windows 是否已收到变更(Win11 实测)
windows·powershell
布莱克6053 天前
Swift 循环与控制转移详解:从 for-in 到标签跳转
开发语言·ssh·swift·循环
Funlang3 天前
在 Windows NT 3.5 上跑 Fun
windows
xx z4 天前
directx修复工具下载(DirectX Repair 增强版 使用说明)
windows·系统·工具·软件
xx z4 天前
pcl2启动器下载(Minecraft PCL2 启动器 最新版 安装与使用说明)
windows·游戏·工具·软件
七维大脑4 天前
【开源自荐】7Shell:跨平台 SSH 运维客户端,把终端、SFTP、容器和 K8s 放进一个窗口
ssh·运维工具·开源工具·开源ssh