跳到主內容

【GitLab】使用ssh clone 專案

以下是在 GitLab 使用 SSH 方式 clone 專案的完整步驟，假設你的 GitLab 伺服器是公司內部或自架的，也適用：

1️⃣ 產生並設定 SSH Key

  1. 建立 SSH Key

    ssh-keygen

    • 出現檔案路徑提示時直接按 Enter (預設~/.ssh/id_rsa.pub)

    • 登入 GitLab → 右上角 使用者頭像 → Preferences → SSH Keys。

    • 貼上 ~/.ssh/id_rsa.pub 內容。

2️⃣ 測試連線

確認 GitLab 可透過 SSH 連線：

ssh -T git@your.gitlab.host

  • 第一次會詢問 Are you sure you want to continue connecting (yes/no)? → 輸入 yes。

  • 成功訊息：Welcome to GitLab, @你的帳號!

3️⃣ 取得專案的 SSH URL

在 GitLab 專案頁面：

  • 點選 Code → Clone → 選 SSH。

  • 範例 URL：

    git@gitlab.example.com:group-name/project-name.git

4️⃣ 執行 Clone

git clone git@gitlab.example.com:group-name/project-name.git

  • 會將程式碼拉到目前目錄下的 project-name 資料夾。

5️⃣ 常見問題排查

問題 檢查方式
Permission denied (publickey) 確認 ssh-agent 有加入金鑰：ssh-add -l
找不到 Host 檢查網路、防火牆，或在 ~/.ssh/config 加入 Host 設定
公司內網 GitLab 需確保內部 DNS 或 VPN 正確

範例 .ssh/config（可簡化命令）

Host gitlab-company
    HostName gitlab.example.com
    User git
    IdentityFile ~/.ssh/id_ed25519

然後可用：

git clone git@gitlab-company:group-name/project-name.git

以上步驟完成後，你就能用 SSH 方式安全地 git clone GitLab 專案並進行後續開發。

回到頂端