在使用 GitLab 或其他 Git 服務時,SSH Key 是確保安全且快速認證的必備工具。如果尚未設定 SSH Key,本文將帶你一步步完成檢查和建立過程,並將 SSH Key 新增至 GitLab 帳戶,讓你的操作更加順暢。
1. 檢查是否已存在 SSH Key#
首先,讓我們檢查系統中是否已經存在 SSH Key。如果已有,則可以直接跳到下一步;如果沒有,我們將進行創建。
打開終端機並執行以下命令:
cd ~/.ssh
ls
如果看到 id_rsa 和 id_rsa.pub 兩個檔案,那就說明你的 SSH Key 已經存在,可以直接進行 GitLab 的配置。
如果沒有 id_rsa.pub,則需要建立新的 SSH Key。
2. 建立 SSH Key#
若你的系統中尚未建立 SSH Key,可以透過以下步驟來創建一個新的 SSH Key:
ssh-keygen -t rsa -b 2048 -C "user@example.com"
這裡,-t rsa 表示創建 RSA 類型的金鑰,-b 2048 表示設置金鑰長度為 2048 位,-C 用來設置一個註解(通常是你的電子郵件)。
接下來,你會看到提示:
- 指定金鑰保存位置:
- 設置密碼:
完成後,終端機會顯示一個圖形,代表 SSH Key 已經成功建立。
3. 新增 SSH Key 到 GitLab#
接下來,我們需要將剛剛建立的公鑰(id_rsa.pub)加入 GitLab,讓 GitLab 允許你的本地端進行安全連線。
複製公鑰內容:這會顯示一串以 ssh-rsa 開頭的長字符串,請將這整段文字複製起來。
cat ~/.ssh/id_rsa.pub
- 登入 GitLab,點擊頁面右上角的「個人設定」。
- 在側邊欄選擇 SSH Keys,然後將複製的公鑰貼到「Key」欄位。
- 在 Title 欄位,GitLab 通常會自動填入你在建立金鑰時的註解(如 user@example.com),如果沒有填寫,你也可以自行設置。
- 設定 失效日期(expires at)可選,若不需要設置,則留空即可。
- 點擊 Add key 按鈕完成新增。
4. 測試 SSH 連線#
完成上述步驟後,你可以進行測試,確認 SSH Key 是否配置成功,並能正常與 GitLab 連線。
在終端機中輸入以下命令來測試:
ssh -T username@gitlab.com
如果是第一次連接 GitLab,系統會詢問你是否確定要繼續連線:
Are you sure you want to continue connecting (yes/no)? yes
輸入 yes 並按下 ENTER,接著如果你在建立 SSH Key 時設置了密碼,系統會提示你輸入密碼。
若一切設置正確,你將看到類似如下的提示訊息:
Welcome to GitLab, @username!
這表示你已經成功配置 SSH 連線,可以開始順利地進行 Git 操作。
結論#
透過 SSH Key 配置,我們可以確保與 GitLab 的連線更加安全且便捷。設定好後,你將能夠輕鬆地進行版本控制和協作開發,而不再需要每次操作時都輸入帳號和密碼。這不僅能提高工作效率,還能確保資料傳輸的安全性。
