windows系统git使用ssh方式和gitee/github进行同步

前言

在从github/gitee远程仓库获取代码时，除了使用https方式，我们还可以使用ssh连接的方式与远程仓库服务器通信，其好处是有时会比https更方便、稳定、快速。

和与普通的linux服务器连接一样，为了免去每次远程操作都要输入用户名和密码的苦恼，我们可以选择使用 密钥对 的方式免密登录。

准备工作(win11)

使用git来clone项目有两种方式：HTTPS和SSH：

HTTPS：不管是谁，拿到url随便clone，但是在push的时候需要验证用户名和密码；
SSH：clone的项目你必须是拥有者或者管理员，而且需要在clone前添加SSH Key。SSH 在push的时候，是不需要输入用户名的，如果配置SSH key的时候设置了密码，则需要输入密码的，否则直接是不需要输入密码的。

https的方式比较好理解，本文以SSH为例来讲解Windows系统git使用ssh方式来gitee进行同步（github类似）。

Gitee 提供了基于SSH协议的Git服务，在使用SSH协议访问仓库之前，需要先配置好账户/仓库的SSH公钥。

1，如果是win10，则推荐本地安装windows terminal( https://learn.microsoft.com/zh-cn/windows/terminal/install )。
2，安装git。
3，有一个gitee账户并创建一个仓库。

步骤一，生成ssh私钥和公钥并配置gitee公钥

打开terminal，运行ssh-keygen
过程会提示文件保存路径、密码，不用输入，连续两次回车。

打开 C:\Users\当前用户.ssh 目录，会有两个文件id_rsa（私钥）id_rsa.pub（公钥）

这里千万注意，window自带的ssh客户端其配置目录位于C:\Users\当前用户.ssh，必须在这目录下。
id_rsa文件（私钥）
id_rsa.pub文件（公钥）

记事本打开id_rsa.pub公钥文件，复制内容到gitee公钥里(https://gitee.com/profile/sshkeys),标题随便写。点确定保存。

注意这里的指纹哈希sha256和上面命令行生成的指纹是一致的，证明复制正确

步骤二，配置ssh客户端（踩了很多坑）

window自带的ssh客户端其配置目录位于C:\Users\当前用户.ssh
确保该目录下的两个文件id_rsa（私钥），不能改名

测试ssh是否能连接成功，terminal运行：

ssh -T git@gitee.com

提示 You've successfully authenticated

另：遇到的其他情况的处理，

步骤三，复制ssh仓库url（非https）克隆代码

找到正确ssh地址

开始git clone仓库（clone完毕后git remote -v验证远程连接）

踩坑总结

主要是ssh客户端设置，window自带的ssh客户端，其config配置位于C:\Users\当前用户.ssh 目录，ssh命令执行的时候依赖.ssh目录的配置，ssh-keygen默认生成（rsa加密）私钥文件id_rsa，一定位于.ssh文件夹之下，且不能改名！
如果id_rsa位于其他文件夹,例如d:\sshconfig\，那么运行ssh命令需要加 -i参数，不过可能遭遇WARNING: UNPROTECTED PRIVATE KEY FILE!，具体解决方法可以搜索解决

ssh -T git@gitee.com -i d:\sshconfig\

i参数说明：
-i identity_file A file from which the identity key (private key) for public key authentication is read.

参考资料：

更多关于win10 ssh客户端的说明，参考： https://learn.microsoft.com/zh-cn/windows/terminal/tutorials/ssh
更多关于ssh命令的参考：https://www.ssh.com/academy/ssh/command
更多关于ssh-keygen命令的参考： https://www.ssh.com/academy/ssh/keygen
生成/添加SSH公钥：https://gitee.com/help/articles/4181

---

前往了解国思RDIF低代码开发平台：www.guosisoft.com