來源：https://blog.csdn.net/2403_87969572/article/details/156694422

抓取時間（ISO本地）：2026-05-18 05:17:24

---

一、前言

最近在部署detectron2（Facebook開源的目標檢測框架）時，執行克隆命令：

git clone git@github.com:facebookresearch/detectron2.git

終端直接丟擲如下錯誤：

Cloning into 'detectron2'...
git@github.com: Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

起初以為是倉庫許可權問題，但detectron2是公開倉庫，任何人都可克隆，排查後發現核心是SSH身份驗證環節出了問題。本文將完整還原問題分析和解決過程，幫助遇到同類報錯的開發者少走彎路。

二、問題分析

要理解這個報錯，首先要明白Git透過SSH協議訪問GitHub的底層邏輯：

1. SSH驗證原理：GitHub透過SSH金鑰對（公鑰+私鑰）驗證使用者身份——本地生成金鑰對後，將公鑰配置到GitHub賬戶，克隆/推送程式碼時，GitHub伺服器會校驗本地私鑰與賬戶公鑰是否匹配，匹配成功才允許操作。
2. 報錯本質：Permission denied (publickey) 意味著GitHub伺服器未在你的賬戶中找到匹配的SSH公鑰，無法確認你的身份，因此拒絕了SSH連線請求。
3. 常見誘因：
   • 本地未生成SSH金鑰對；
   • 生成了金鑰對但未將公鑰新增到GitHub賬戶；
   • SSH agent未啟動，或未將私鑰新增到agent中；
   • 金鑰檔案路徑/許可權配置錯誤（如私鑰許可權過寬）。

三、解決方案

針對該問題，提供兩種解決方案：「快速臨時方案」（改用HTTPS克隆）和「長期根治方案」（配置SSH金鑰），可根據實際需求選擇。

方案1：快速解決——改用HTTPS協議克隆（無需配置SSH）

這是最便捷的臨時方案，跳過SSH驗證，直接使用HTTPS協議克隆倉庫，適合臨時克隆公開倉庫的場景。

執行如下命令即可：

git clone https://github.com/facebookresearch/detectron2.git

注意事項：

• 如果克隆時提示輸入GitHub賬號密碼：
  • 賬號填寫你的GitHub使用者名稱；
  • 若開啟了GitHub兩步驗證（2FA），密碼不能填登入密碼，需使用「個人訪問令牌（PAT）」代替。
• 生成PAT的步驟：GitHub首頁 → 右上角頭像 → Settings → Developer settings → Personal access tokens → Generate new token → 勾選repo許可權 → 生成後複製令牌（僅顯示一次，需妥善儲存）。

方案2：長期根治——配置SSH金鑰（推薦）

如果需要長期使用SSH協議操作GitHub（如頻繁推送程式碼、克隆私有倉庫），建議配置SSH金鑰，一勞永逸解決身份驗證問題，步驟如下：

步驟1：檢查本地是否已有SSH金鑰

首先檢視本地.ssh目錄下是否有現成的金鑰檔案（如id_rsa.pub/id_ed25519.pub，.pub字尾為公鑰，無字尾為私鑰）：

ls -al ~/.ssh

如果輸出中有id_ed25519.pub或id_rsa.pub，說明已有金鑰對，可跳過步驟2；若為空，需生成新金鑰。

步驟2：生成新的SSH金鑰（無金鑰時執行）

使用ssh-keygen生成金鑰對（推薦使用更安全的ed25519演算法），替換為你的GitHub註冊郵箱：

ssh-keygen -t ed25519 -C "your_email@example.com"

執行後按提示操作：

• 按回車預設儲存路徑（~/.ssh/id_ed25519），無需修改；

• 可選設定金鑰密碼（按回車跳過即可，設定後每次使用SSH需輸入密碼，更安全）。

  

步驟3：啟動SSH Agent並新增私鑰

SSH Agent用於管理私鑰，避免每次操作都輸入金鑰密碼，執行如下命令：

# 啟動ssh-agent
eval "$(ssh-agent -s)"
# 新增私鑰（若為rsa金鑰，替換為id_rsa）
ssh-add ~/.ssh/id_ed25519

步驟4：複製SSH公鑰內容

執行命令複製公鑰文字（後續需貼上到GitHub）：

cat ~/.ssh/id_ed25519.pub

複製輸出的全部內容（以ssh-ed25519開頭，你的郵箱結尾的完整字串）。

步驟5：將公鑰新增到GitHub賬戶

1. 開啟GitHub官網，登入後點選右上角頭像 → Settings（設定）；

   

2. 在左側選單找到SSH and GPG keys → 點選New SSH key；

   

3. Title欄填寫標識（如“工作機-2026”），Key欄貼上複製的公鑰內容；

   

4. 點選Add SSH key完成新增（若開啟2FA，需驗證身份）。

   

步驟6：驗證SSH連線

執行如下命令驗證配置是否成功：

ssh -T git@github.com

若終端輸出Hi [你的GitHub使用者名稱]! You've successfully authenticated, but GitHub does not provide shell access.，說明SSH配置成功。

步驟7：重新克隆倉庫

此時再執行原SSH克隆命令，即可正常克隆：

git clone git@github.com:facebookresearch/detectron2.git

四、總結

1. 報錯核心原因：本地SSH公鑰未配置到GitHub賬戶，導致GitHub無法驗證身份，拒絕SSH連線。
2. 方案選擇建議：臨時克隆公開倉庫選HTTPS方式（快速），長期開發/操作私有倉庫選SSH配置（便捷、安全）。
3. 額外注意點：配置SSH後若仍報錯，可檢查金鑰檔案許可權（私鑰需設為600）、SSH Agent是否正常執行，或更換RSA演算法重新生成金鑰。

希望本文能幫助大家快速解決git@github.com: Permission denied (publickey)問題，如果你有其他解決思路，歡迎在評論區交流～