1. 程式人生 > >Git 【基於SSH協議clone GitHub遠端倉庫到本地】

Git 【基於SSH協議clone GitHub遠端倉庫到本地】

經常逛 GitHub 的可能都知道,在 clone 遠端倉庫的時候,會有兩個選項,如下圖:



首先我們來說明一下兩種方式的區別

使用 HTTPS url 克隆對初學者來說會比較方便,複製HTTPS url 然後到 git Bash 裡面直接用 clone 命令克隆到本地就好了,但是每次 fetch 和 push 程式碼都需要輸入賬號和密碼,這也是HTTPS 方式的麻煩之處。而使用 SSH url 克隆卻需要在克隆之前先配置和新增好SSH key,因此,如果你想要使用SSH url克隆的話,你必須是這個專案的擁有者或管理員。否則你是無法新增 SSH key 的,另外 SSH 預設是每次 fetch 和 push 程式碼都不需要輸入賬號和密碼,如果你想要每次都輸入賬號密碼才能進行 fetch 和 push 也可以另外進行設定,但一般人不這麼做。

以下對如何配置 SSH key 和 使用 SSH url 克隆作詳細說明:(以下操作均在 Terminal 中進行)

① 檢視自己是否已經建立了 SSH key

$ cd ~/.ssh
$ ls

這兩個命令就是檢查是否已經存在 id_rsa.pub 或 id_dsa.pub 檔案,如果檔案已經存在,那麼你可以跳過步驟 2,直接進入步驟 3。

如果沒有 SSH key ,是不會存在該資料夾的。

如果不存在 SSH key,或是 SSH key 不可用,那麼備份並刪除該資料夾,重新生成 SSH key 。(進入步驟 2)

② 生成祕鑰

$ ssh-keygen -t rsa -C "[email protected]
"

-t 指定金鑰型別,預設是 rsa ,可以省略。

-C 設定註釋文字,比如郵箱。(一定要是關聯你 GitHub 的註冊郵箱,也就是使用者名稱)

-f 指定金鑰檔案儲存檔名。

在上面的命令列中我省略了 -f 引數,因此,執行上面那條命令後會讓你輸入一個檔名,用於儲存剛才生成的 SSH key 程式碼,如下:

Generating public/private rsa key pair.
Enter file in which to save the key (/Users/bpb/.ssh/id_rsa): 

當然,你也可以不輸入檔名,使用預設檔名(推薦),那麼就會生成 id_rsa 和 id_rsa.pub 兩個祕鑰檔案。

/Users/bpb/.ssh/id_rsa already exists.
Overwrite (y/n)? y

接著又會提示你輸入兩次密碼(該密碼是你 push 檔案的時候要輸入的密碼,而不是 GitHub 管理者的密碼),

當然,你也可以不輸入密碼,直接按回車。那麼push的時候就不需要輸入密碼,直接提交到GitHub 上了,如下:

Enter passphrase (empty for no passphrase): 
Enter same passphrase again: 

之後會顯示如下提示,表示 SSH key 已經建立成功。

Your identification has been saved in /Users/bpb/.ssh/id_rsa.
Your public key has been saved in /Users/bpb/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:rxneWu2eUcd6M5DKFt2J9aeDZhxpNczajN89HRoqZZg [email protected]
The key's randomart image is:
+---[RSA 4096]----+
|                 |
|             o   |
|              =. |
|          o .B=oo|
|        SE +**++=|
|         .+++=+==|
|        ..o=B.=+=|
|       . *o+ o o+|
|        =...+    |
+----[SHA256]-----+

③ 新增 SSH key 到 GitHub 上去

確保啟用 SSH 代理:

$ eval "$(ssh-agent -s)"

為 SSH key 啟用 SSH 代理

$ ssh-add ~/.ssh/id_rsa

如果你使用一個現有的SSH金鑰,而不是產生一個新的SSH金鑰,您需要與您現有的私鑰檔名命令取代 id_rsa。(當然使用舊金鑰就不需要執行上面一行命令列)

拷貝 id_rsa.pub 檔案的內容,你可以用編輯器開啟檔案複製,也可以用 git 命令複製該檔案的內容,如下:

Mac 端 copy 操作:

$ pbcopy < ~/.ssh/id_rsa.pub
# Copies the contents of the id_rsa.pub file to your clipboard

Windows 端 copy 操作:

$ clip < ~/.ssh/id_rsa.pub
# Copies the contents of the id_rsa.pub file to your clipboard

Linux 端操作:

sudo apt-get install xclip
# Downloads and installs xclip. If you don't have `apt-get`, you might need to use another installer (like `yum`)
xclip -sel clip < ~/.ssh/id_rsa.pub
# Copies the contents of the id_rsa.pub file to your clipboard

登入你的github賬號,從右上角的設定(Account Setting )進入,然後點選選單欄的 SSH key 進入頁面新增 SSH key。

點選 Add SSH key 按鈕新增一個 SSH key 。把你複製的 SSH key 程式碼貼上到 key 所對應的輸入框中,記得 SSH key 程式碼的前後不要留有空格或者回車。當然,上面的 Title 所對應的輸入框你也可以輸入一個該 SSH key 顯示在 github 上的一個別名。預設的會使用你的郵件名稱。如下圖:


④ 測試你的 SSH key 是否配置成功

$ ssh -T [email protected]

當你輸入以上程式碼時,會有一段警告程式碼,如:

The authenticity of host 'github.com (207.97.227.239)' can't be established.
# RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
# Are you sure you want to continue connecting (yes/no)?

這是正常的,你輸入 yes 回車既可。如果你建立 SSH key 的時候設定了密碼,接下來就會提示你輸入密碼,如:

Enter passphrase for key '/c/Users/Administrator/.ssh/id_rsa':

當然如果你密碼輸錯了,會再要求你輸入,知道對了為止。

注意:輸入密碼時如果輸錯一個字就會不正確,使用刪除鍵是無法更正的。

密碼正確後你會看到下面這段話,如下:

Enter passphrase for key '/c/Users/Administrator/.ssh/id_rsa':

⑤ clone 遠端倉庫到本地吧 ~

$ git clone [email protected]:kahowu/benpaobao_ios.git

然後看到如下命令列:

Cloning into 'XXXXXXX'...
remote: Counting objects: 5133, done.
remote: Compressing objects: 100% (24/24), done.
Receiving objects:  43% (2224/5133), 4.84 MiB | 1024 bytes/s
remote: Total 5133 (delta 0), reused 0 (delta 0), pack-reused 5109
Receiving objects: 100% (5133/5133), 26.98 MiB | 75.00 KiB/s, done.
Resolving deltas: 100% (2922/2922), done.
Checking connectivity... done.

然後切換到本地專案的根目錄下,拉取遠端倉庫的分支(Vayne):

$ git fetch origin Vayne

接著看到如下命令列:

remote: Counting objects: 29, done.
remote: Compressing objects: 100% (29/29), done.
remote: Total 29 (delta 1), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (29/29), done.
From github.com:kahowu/benpaobao_ios
 * branch            Vayne      -> FETCH_HEAD
   74b0c3f..40beaf1  Vayne      -> origin/Vayne

檢視本地已經存在的遠端分支:(發現只有一個 master 分支)

git branch
* master

新建本地 Vayne 分支,然後把拉取下來的遠端 Vayne 分支進行合併:

注意下列命令列,是相對於我們拉下來的 Vayne 遠端分支作為基準進行建立的 Vayne 本地分支,也就是說創建出來的本地 Vayne 分支是和遠端的 Vayne 分支的程式碼保持一致的。和普通建立本地分支有一些小小的差異。(一般我們建立的出來的本地分支是基於當前所在的本地分支進行建立的,在此處也就是 master。但是由於我們在後面拼接了 origin/Vayne ,所以說此處並不是基於 master 分支建立的 Vayne 分支)

git checkout -b Vayne origin/Vayne

上面一句程式碼可以直接執行,不用 fetch,但是 fetch 的好處是可以先暫時拉取並檢視。當然現在本地也沒有 Vayne 分支,所以直接拉取也是合適的。

合併成功:

Branch Vayne set up to track remote branch Vayne from origin.
Switched to a new branch 'Vayne'

最後推薦兩個官方連結給大家參考: