Git 安裝及配置SSH Key

Git 安裝及配置SSH Key

檢查SSH keys

到使用者資料夾C:\Users\<user>\中看是是否有.ssh資料夾（<user>為你的Windows用戶名稱，本範例為john），如果有的話點進去看是否有下表中任一SSH keys檔案。下表的第一欄為加密方式，第二欄為公鑰檔名，第三欄為私鑰檔名。若SSH keys已存則跳過「產生SSH keys」的步驟。

加密算法	Public key	Private key
ED25519 (preferred)	id_ed25519.pub	id_ed25519
RSA (at least 2048-bit key size)	id_rsa.pub	id_rsa
DSA (deprecated)	id_dsa.pub	id_dsa
ECDSA	id_ecdsa.pub	id_ecdsa

產生SSH keys

在Windows 10可使用Git Bash命令列產生SSH keys，預設會把產生的SSH keys存在C:\Users\<user>\.ssh目錄。下面示範產生RSA 2048位元的SSH keys的方式。

開啟Git Bash，輸入ssh-keygen - t rsa -b 2048 -C <email>，<email>輸入你的信箱。

$ ssh-keygen - t- rsa - b 2048 -C [e-mail]
Generating public/private rsa key pair.

然後出現要把產生的SSH keys黨要存在哪裡的提問，直接按Enter鍵使用預設位置/c/Users/<user>/.ssh/id_rsa。

Enter file in which to save the key (/c/Users/john/.ssh/id_rsa):

然後會出現提示要輸入passpharse的訊息按Enter鍵跳過。

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

最後會提示把產生的SSH keys放到指定的位置。

Your identification has been saved in /c/Users/john/.ssh/id_dsa.
Your public key has been saved in /c/Users/john/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:7jyDUHfNi/kNFLRXutR/.... [e-mail]
The key's randomart image is:
+---[RSA 2048]---+
|           ..   |
|          ..  + |
|         o..+ . |
|   .. . . +o o .|
|   .o.S. + .o o |
|  .o .  o.o. . .|
|.  oo.+ ..0=    |
| +.  +=+=o  ++. |
|E. . oB*.oo.oo..|
+----[SHA256]----+

在C:\Users\用戶名.ssh\文件夾中新建一個名稱為config的文件, 記事本打開 將下面內容複製貼上並保存, 最後一行記得換成你的id_rsa路徑

# Gitlab
Host gitlab.com
HostName gitlab.com
PreferredAuthentications publickey
AddKeysToAgent yes
IdentityFile C:\Users\用戶名\.ssh\id_rsa

# 設定檔參數
# Host : Host可以看作是一個你要識別的模式，對識別的模式，進行配置對應的的主機名稱和ssh文件
# HostName : 要登入主機的主機名
# User : 登入名
# IdentityFile : 指明上面User對應的identityFile路徑

本地設定多個SSH Key

建立 GitLab 的 SSH Key

ssh-keygen -t rsa -C '[e-mail]' -f ~/.ssh/gitlab-rsa

建立 Github 的 SSH Key

ssh-keygen -t rsa -C '[e-mail]' -f ~/.ssh/github-rsa

# Gitlab
Host gitlab.com
HostName gitlab.com
PreferredAuthentications publickey
IdentityFile ~/.ssh/gitlab_id-rsa

# Github
Host github.com
HostName github.com
PreferredAuthentications publickey
IdentityFile ~/.ssh/github_id-rsa

# 設定檔參數
# Host : Host可以看作是一個你要識別的模式，對識別的模式，進行配置對應的的主機名稱和ssh文件
# HostName : 要登入主機的主機名
# User : 登入名
# IdentityFile : 指明上面User對應的identityFile路徑

複製public key到GitLab

到SSH keys預設的存放位置C:\Users\<user>\.ssh找到產生的SSH keys。用記事本或Notepad++開啟public key檔id_rsa.pub，內容為ssh-rsa後接一長串亂碼如下，按Ctrl + A複製全部內容。

ssh-rsa
AAAAAB3NzaC1yc....................................................................
..................................................................................
......................................................................7QEO9eOoMtPd
[e-mail]

登入GitLab網頁，點選右上方的使用者頭像，點選[Preferences]，在左側選單找到[SSH Keys]。在[Key]欄位貼上剛剛從id_rsa.pub中複製的內容，然後點Add key

使用SSH Clone專案

在GitLab專案的Clone按鈕複製[Clone with SSH]欄位的內容例如[e-mail]:demos/demo.git，然後在Git Bash輸入 git clone [e-mail]:demos/demo.git 即可把專案clone到命令執行的所在目錄。

$ git clone [e-mail]:demos/demo.git
Cloning into 'demo'...
remote: Enumerating objects: ..., done.
...
Resolving deltas: 100% (...), done.

---

在 Mac 上使用可以按照以下步驟操作：

1. 生成 SSH Key

如果你尚未生成 SSH Key，請按以下步驟操作：

步驟

1. 打開終端機，執行以下命令生成新的 SSH Key：

   ssh-keygen -t rsa -b 4096 -C "[e-mail]"

   • -t rsa: 使用 RSA 演算法。

   • -b 4096: 生成 4096 位元的密鑰。

   • -C "[e-mail]": 填入你在 GitLab 使用的 Email。

2. 儲存路徑：

   • 系統會提示你輸入儲存路徑，預設是 ~/.ssh/id_rsa，直接按 Enter 即可。

3. 設定密碼短語（可選）：

   • 如果不需要設定密碼短語，直接按 Enter 跳過。

4. 確認生成成功：

   • 在終端機執行以下命令，確認密鑰已生成：

     ls ~/.ssh

     確認是否有id_rsa和`id_rsa.pub'這兩個檔案。