應用場景
我們經常將代碼托管到github、gitlab這樣的網站上。為了避免每次push代碼時都要輸入用戶名和密碼,通常會選擇使用ssh協議,將公鑰保存到托管網站上。在實際開發中,往往要將代碼托管到多個不同的網站上。比如,公司的代碼需要托管到coding上,自己的開源代碼托管到GitHub上,私有代碼托管到gitlab上等等,每個托管網站都對應一個git賬戶。默認情況下,一臺電腦的Git只對應一個賬戶,只能往一個網站push代碼,非常不便。這篇博客將介紹如何在一個Git終端中配置多個賬戶,同時管理多個托管網站的代碼。
準備工作
首先,需要準備好對Git的全局用戶進行配置。在初次安裝Git時,往往會使用如下的命令配置全局用戶名和郵箱:
git config --global user.name "xxx" // 配置全局用戶名,如Github上注冊的用戶名
git config --global user.email "yyy@mail.com" // 配置全局郵箱,如Github上配置的郵箱
這個--global
選項,是指這里配置的user.name
和user.email
是相對于全局進行配置的,即不同的Git倉庫默認的用戶名和郵箱都是這個值。由于需要管理多個賬戶,所以僅僅使用這個全局值是不夠的,需要在每個倉庫中單獨配置。對此,有兩種處理方法:
如果之前已經使用該命令進行配置,則先使用如下命令清除
git config --global --unset user.name
git config --global --unset user.email
如果不確定是否已經配置過,可以使用下面的命令查看
git config --global user.name
git config --global user.email
配置步驟
1. 對每個賬戶生成一對密鑰
首先進入保存秘鑰的目錄:
cd ~/.ssh // 進入目錄,該目錄下保存生成的秘鑰
然后,根據賬戶郵箱生成秘鑰。例如我在GitHub上的郵箱是liugui@hust.edu.cn
,則命令為:
ssh-keygen -t rsa -C "liugui@hust.edu.cn"
輸入完成后,會有如下提示:
Generating public/private rsa key pair.
Enter file in which to save the key (/Users/liugui/.ssh/id_rsa):
這里要求對秘鑰進行命名,默認的文件名是id_rsa
。為了方便區分,我這里命名為id_rsa_github
。接下來的提示都直接進行回車,直到秘鑰生成。通過ls
命令,可以看到剛剛生成的密鑰對id_rsa_github
和id_rsa_github.pub
。其中id_rsa_github.pub
是公鑰。
同樣,對于GitLab上的賬戶,我是用另一個郵箱注冊的,按照同樣的步驟生成id_rsa_gitlab
的秘鑰對。接下來的步驟,除額外說明外,兩個賬戶的操作完全相同。
2. 私鑰添加到本地
SSH協議的原理,就是在托管網站上使用公鑰,在本地使用私鑰,這樣本地倉庫就可以和遠程倉庫進行通信。在上一步已經生成了秘鑰文件,接下來需要使用秘鑰文件,首先是在本地使用秘鑰文件:
ssh-add ~/.ssh/id_rsa_github // 將GitHub私鑰添加到本地
ssh-add ~/.ssh/id_rsa_gitlab // 將GitLab私鑰添加到本地
為了檢驗本地是否添加成功,可以使用ssh-add -l
命令進行查看
3. 對本地秘鑰進行配置
由于添加了多個密鑰文件,所以需要對這多個密鑰進行管理。在.ssh
目錄下新建一個config文件:
touch config
文件中的內容如下:
Host github // 網站的別名,隨意取
HostName github.com // 托管網站的域名
User liugui // 托管網站上的用戶名
IdentityFile ~/.ssh/id_rsa_github // 使用的密鑰文件
// GitLab的配置相同
Host gitlab
HostName gitlab.com
User liugui
IdentityFile ~/.ssh/id_rsa_gitlab
4. 公鑰添加到托管網站
以GitHub為例,先在本地復制公鑰。進入.ssh
目錄,使用vim id_rsa_github.pub
查看生成的GitHub公鑰,全選進行復制。
登錄GitHub,點擊右上角頭像選擇settings
,在打開的頁面中選擇SSH and GPG keys,
在打開的頁面的Key輸入框中粘貼剛剛復制的公鑰,title的名字自己隨便去,然后點擊下方的Add SSH key
按鈕:
至此,托管網站的公鑰添加完成。總結來說,就是針對每個托管網站分別生成一對密鑰,然后分別添加到本地和托管網站。
這時候,可以測試一下配置是否成功,測試命令使用別名。例如,對于GitHub,本來應該使用的測試命令是:
ssh -T git@github.com
在config文件中,給GitHub網站配置的別名就是github,所以直接使用別名,就是
ssh -T git@github
如何使用
使用有兩種情況,一種情況是從遠端拉取代碼到本地,一種是本地已有倉庫需要與遠程倉庫關聯。
1.如果是從遠端拉取代碼
選擇SSH協議的復制命令,如對于GitLab上代碼庫test,其復制命令為
git clone git@gitlab.com:liugui/test.git
由于使用了別名gitlab,所以實際使用的復制命令應當為:
git clone git@gitlab:liugui/test.git
這種方法較為簡單,修改后的代碼無需額外配置,可以直接push
2. 如果是本地已有的倉庫
這種情況適用于本地新建的倉庫需要與遠端進行關聯,或者之前已經使用sourceTree等圖形界面軟件拷貝的倉庫。進入本地倉庫文件夾,需要單獨配置該倉庫的用戶名和郵箱
git config user.name "liugui"
git config user.email "liugui@hust.edu.cn"
然后,進入本地倉庫的git目錄,打開config文件
cd .git // 該目錄是隱藏的,ls命令不可見,但是可以直接進入,如果是新建的文件夾需要先執行git init
vim config
在config文件中,修改(config文件中已有remote "origin"信息)或者添加(config文件中不包含remote "origin"信息)分支信息:
[remote "origin"]
url = git@gitlab:GuiLiu/test.git
fetch = +refs/heads/*:refs/remotes/origin/*
主要是URL部分,原生的信息一般是git@gitlab.com:GuiLiu/test.git
,需要將gitlab.com使用別名gitlab代替。
可以看到,倉庫中的關鍵是要配置好用戶名和郵箱,以及使用別名。使用別名的目的是為了通過別名,將本地倉庫與密鑰目錄.ssh
文件夾下的密鑰進行管理,這樣就完成了本地倉庫使用的私鑰與托管網站使用的公鑰的配對,而用戶名和郵箱是該倉庫使用SSH協議時需要用到的信息
補充一下Coding
在關聯coding上托管的代碼時,遇到了一點麻煩,主要是因為別名的修改不正確,以及20端口禁用的問題導致的,所以單獨記錄下,.ssh
目錄下的config文件中的密鑰信息應該為:
Host coding
HostName git-ssh.coding.net // 這個域名使用coding官網獲取的,不能寫coding.net
User liugui
IdentityFile ~/.ssh/id_rsa_coding
Port 443 // 20端口可能被禁用,需要使用443端口
個人博客地址:http://www.liugui.org