Windows下Git配置ssh-key

1. 简介

Git 配置 ssh-key 是为了识别并区分不同的主机,所以一台主机要使用 Git 进行远程仓库托管代码,首先要在本机生成 ssh-key,并配置到对应远程仓库网站(Github、Gitee 等)。

2. 生成 ssh-key

在 Git 终端输入:

1
ssh-keygen -t rsa -C "youremail" 

然后 Git 终端会询问保存路径(建议直接 enter,按默认路径保存;否则可能会出现 Permission denied 问题,此解决办法见下文),以及密码设置(可设可不设)。

3. 配置远程仓库网站

在 Github 或 Gitee 上找到添加 ssh 公匙选项,到刚才保存的 ssh-key 的路径下找到对应的 .pub 文件(此为公匙可外传,另一个为私匙不可外传),打开后将内容粘贴到 Github 或 Gitee 网站添加 ssh 公匙栏中。

4. 测试连接远程仓库网站

在 Git 终端输入:

1
2
ssh -T git@github.com    # github 网站 
ssh -T git@gitee.com # gitee 网站
  • 如果是按默认路径保存 ssh-key,则 Git 终端应该会返回以下内容:Hi *** ! You've successfully authenticated ***;此时说明成功连接远程仓库,可以开始在远程仓库托管自己代码了。

  • 如果没有按照默认路径保存 ssh-key ,则可能会报错:Permission denied (publickey).

5. 暂时解决上述问题

在 Git 终端输入以下代码:

1
ssh-add <path>   		# <path> 为你保存公匙的绝对路径 

如果报错:Could not open a connect to your authentication agent,说明 ssh-agent 没有开启。输入以下代码中的任一条进行开启:

1
2
ssh-agent bash
eval $(ssh-agent -s)

但这样只能临时解决问题,重新打开 Git 终端后发现又不好使了。

6. 永久解决上述问题

将以下代码写到 Git 的启动配置文件末尾,默认路径为 C:\Program Files\Git\etc\bash.bashrc。以后每次打开 Git 终端就会自动执行以下代码找到对应的 .pub 公钥文件:

1
2
eval $(ssh-agent -s) 
ssh-add path # <path> 为你保存公匙的绝对路径

本博客所有文章除特别声明外,均采用 CC BY-SA 4.0 协议 ,转载请注明出处!