跳至主要內容

Git配置SSH Key(Git配置多个账户)

ycyin大约 5 分钟GitGit使用技巧

前言

一般地,都会安装好Git后直接设置一个全局的config信息,如下:

git config --global user.name "yyc" // 配置全局用户名,如 Github 上注册的用户名
git config --global user.email "34782655@qq.com" // 配置全局邮箱,如 Github 上配置的邮箱

但是有时候会遇到这样的问题:

场景一:将同一个项目托管在多个平台(Coding、GitHub、GitLab等)时,可能无法满足需求,因为这两个平台不仅仓库地址不一样,并且账户名和密码都是不同的。例如,我在github pages上面搭建的个人博客,在国内访问太慢,我需要将这个项目同时托管到Coding上,然后双线部署到coding和github pages上。

场景 二:本地有两个项目,分别使用不同的托管平台。比如项目一使用GitHub托管,项目二使用GitLab托管。

本文配置GitHub一个账户,多个账户的配置方法相同。

配置SSH Key

清除全局配置

在正式配置之前,我们先得把全局配置给清除掉(如果你配置过的话),执行以下命令可以列出所有已经配置的全局配置 :

git config --global --list

全局配置信息

发现其中有 user.nameuser.email 信息,请执行以下命令将其清除掉:

git config --global --unset user.name
git config --global --unset user.email

生成密钥对

钥对的保存位置默认在 ~/.ssh 目录(Windows 10系统在C盘User文件夹)下,我们先清理下这个目录中已存在的钥对信息,即删除其中的 id_rsaid_rsa.pub 之类的公钥和密钥文件。注意:windows应该切换到~/.ssh/目录下执行。

首先我们开始生成 github 上的仓库钥对,通过 -C 参数填写 github 的邮箱:

ssh-keygen -t rsa -C “34782655@qq.com”

回车后会提示Enter file in which to save the key ,在这里输入公钥的名字(默认为 id_rsa),这里输入 id_rsa_github。输入完毕后,一路回车,钥对就生成完毕了。注意:需要配置多个账户的话,一定要自己输入名字,以免被覆盖

回车后系统将提示您输入密码以保护您的新 SSH 密钥对。最好使用密码,但也可以不需要密码,一般就按两次回车来跳过创建密码。

添加 SSH Keys

id_rsa_github.pub 中的内容添加到 github的 SSH Keys 中,这个需要直接到网页上设置里面操作(点头像-->setting)。可以使用命令先将文件中的内容复制到粘贴板:

cat ~/.ssh/id_rsa_github.pub | clip

添加私钥

在上一步中,我们已经将公钥添加到了 github服务器上,我们还需要将私钥添加到本地中,不然无法使用。添加命令也十分简单,如下:

ssh-add ~/.ssh/id_rsa_github

添加完毕后,可以通过执行 ssh-add -l 命令验证下。

执行ssh-add时出现Could not open a connection to your authentication agent,则应先执行如下命令即可:

eval $(ssh-agent -s)

或者

ssh-agent bash

更多关于ssh-agent的细节,可以用 man ssh-agent 来查看 。

管理密钥

通过以上步骤,公钥、密钥分别被添加到 git 服务器和本地了。下面我们需要在本地创建一个密钥配置文件,通过该文件,实现根据仓库的 remote 链接地址自动选择合适的私钥。

编辑 ~/.ssh 目录下的 config 文件,如果没有,请创建。

配置内容如下:

Host github
HostName github.com
User yyc007
IdentityFile ~/.ssh/id_rsa_github

Host coding
HostName e.coding.net
User yyc007
IdentityFile ~/.ssh/id_rsa_coding

该文件分为多个用户配置,每个用户配置包含以下几个配置项:

  • Host:仓库网站的别名,随意取
  • HostName:仓库网站的域名(PS:IP 地址应该也可以)
  • User:仓库网站上的用户名
  • IdentityFile:私钥的绝对路径

可以用 ssh -T 命令检测下多个仓库配置的 Host或HostName 是否是连通的:

ssh -T git@github

或者

ssh -T git@github.com

完成以上配置后,已经基本完成了所有配置。分别进入附属于 github 和 coding的仓库,此时都可以进行 git 操作 (或者可以对同一个项目分别操作两个不同的远程Git仓库)。

为仓库单独配置用户名信息

完成以上配置后,其实已经基本完成了所有配置。但是如果你此时提交仓库修改后,你会发现提交的用户名变成了你的系统主机名。

这是因为 git 的配置分为三级别,System —> Global —>Local。System 即系统级别,Global 为配置的全局,Local 为仓库级别,优先级是 Local > Global > System。

因为我们并没有给仓库配置用户名,又在一开始清除了全局的用户名,因此此时你提交的话,就会使用 System 级别的用户名,也就是你的系统主机名了。

因此我们需要为每个仓库单独配置用户名信息,假设我们要配置 github 的某个仓库,进入该仓库后,执行:

git config --local user.name "yyc"
git config --local user.email "34782655@qq.com"

执行完毕后,通过以下命令查看本仓库的所有配置信息:

git config --local --list

至此你已经配置好了 Local 级别的配置了,此时提交该仓库的代码,提交用户名就是你设置的 Local 级别的用户名了。