透過 SSH 使用 Git

你可以使用 SSH (安全外殼協議) 訪問和寫入 huggingface.co 上的倉庫資料。當你透過 SSH 連線時，你將使用本地計算機上的私鑰檔案進行身份驗證。

某些操作，例如推送更改或克隆私有倉庫，需要你將 SSH 公鑰上傳到 huggingface.co 上的賬戶中。

你可以使用已有的 SSH 金鑰，或者專門為 huggingface.co 生成一個新的。

檢查現有的 SSH 金鑰

如果你有現有的 SSH 金鑰，你可以使用該金鑰透過 SSH 對 Git 操作進行身份驗證。

在 Mac 和 Linux 上，SSH 金鑰通常位於 ~/.ssh 下，而在 Windows 上則位於 C:\\Users\\<username>\\.ssh 下。列出該目錄下的檔案，查詢格式如下的檔案：

id_rsa.pub
id_ecdsa.pub
id_ed25519.pub

這些檔案包含你的 SSH 公鑰。

如果你的 ~/.ssh 下沒有這樣的檔案，你需要生成一個新金鑰。否則，你可以將現有的 SSH 公鑰新增到你的 huggingface.co 賬戶。

生成新的 SSH 金鑰對

如果你的機器上沒有任何 SSH 金鑰，你可以使用 ssh-keygen 生成一個新的 SSH 金鑰對 (公鑰 + 私鑰)。

$ ssh-keygen -t ed25519 -C "your.email@example.co"

我們建議在提示時輸入一個密碼短語。密碼短語是額外的安全層：它是一個密碼，每當你使用 SSH 金鑰時都會被要求輸入。

生成新金鑰後，使用 ssh-add 將其新增到你的 SSH 代理中。

$ ssh-add ~/.ssh/id_ed25519

如果你選擇了與預設位置不同的位置來儲存 SSH 金鑰，你需要將 ~/.ssh/id_ed25519 替換為你使用的檔案位置。

向你的賬戶新增 SSH 金鑰

要透過 SSH 訪問私有倉庫，或透過 SSH 推送更改，你需要將你的 SSH 公鑰新增到你的 huggingface.co 賬戶。你可以在你的使用者設定中管理你的 SSH 金鑰。

要向你的賬戶新增 SSH 金鑰，請點選“新增 SSH 金鑰”按鈕。

然後，為此金鑰輸入一個名稱 (例如，“個人電腦”)，並將你的公鑰的內容複製並貼上到下方的區域。公鑰位於你在上一步中找到或生成的 ~/.ssh/id_XXXX.pub 檔案中。

點選“新增金鑰”，就完成了！你已經向你的 huggingface.co 賬戶添加了一個 SSH 金鑰。

測試你的 SSH 身份驗證

將 SSH 金鑰新增到你的 huggingface.co 賬戶後，你可以測試連線是否按預期工作。

在終端中，執行：

$ ssh -T git@hf.co

如果你看到一條包含你使用者名稱的訊息，恭喜！一切順利，你已經準備好透過 SSH 使用 Git 了。

否則，如果訊息顯示類似以下內容，請確保你的 SSH 代理確實在使用你的 SSH 金鑰。

Hi anonymous, welcome to Hugging Face.

Hugging Face 的 SSH 金鑰指紋

公鑰指紋可用於驗證與遠端伺服器的連線。

以下是 Hugging Face 的公鑰指紋：

SHA256:aBG5R7IomF4BSsx/h6tNAUVLhEkkaNGB8Sluyh/Q/qY (ECDSA) SHA256:skgQjK2+RuzvdmHr24IIAJ6uLWQs0TGtEUt3FtzqirQ (DSA - 已棄用) SHA256:dVjzGIdV7d6cwKIeZiCoRMa2gMvSKfGZAvHf4gMiMao (ED25519) SHA256:uqjYymysBGCXXiMVebB8L8RIuWbPSKGBxQQNhcT5a3Q (RSA)

你可以將以下 ssh 金鑰條目新增到你的 ~/.ssh/known_hosts 檔案中，以避免手動驗證 Hugging Face 主機。

hf.co ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDtPB+snz63eZvTrbMY2Qt39a6HYile89JOum55z3lhIqAqUHxLtXFd+q+ED8izQvyORFPSmFIaPw05rtXo37bm+ixL6wDmvWrHN74oUUWmtrv2MNCLHE5VDb3+Q6MJjjDVIoK5QZIuTStlq0cUbGGxQk7vFZZ2VXdTPqgPjw4hMV7MGp3RFY/+Wy8rIMRv+kRCIwSAOeuaLPT7FzL0zUMDwj/VRjlzC08+srTQHqfoh0RguZiXZQneZKmM75AFhoMbP5x4AW2bVoZam864DSGiEwL8R2jMiyXxL3OuicZteZqll0qfRlNopKnzoxS29eBbXTr++ILqYz1QFqaruUgqSi3MIC9sDYEqh2Q8UxP5+Hh97AnlgWDZC0IhojVmEPNAc7Y2d+ctQl4Bt91Ik4hVf9bU+tqMXgaTrTMXeTURSXRxJEm2zfKQVkqn3vS/zGVnkDS+2b2qlVtrgbGdU/we8Fux5uOAn/dq5GygW/DUlHFw412GtKYDFdWjt3nJCY8=
hf.co ssh-dss AAAAB3NzaC1kc3MAAACBAORXmoE8fn/UTweWy7tCYXZxigmODg71CIvs/haZQN6GYqg0scv8OFgeIQvBmIYMnKNJ7eoo5ZK+fk1yPv8aa9+8jfKXNJmMnObQVyObxFVzB51x8yvtHSSrL4J3z9EAGX9l9b+Fr2+VmVFZ7a90j2kYC+8WzQ9HaCYOlrALzz2VAAAAFQC0RGD5dE5Du2vKoyGsTaG/mO2E5QAAAIAHXRCMYdZij+BYGC9cYn5Oa6ZGW9rmGk98p1Xc4oW+O9E/kvu4pCimS9zZordLAwHHWwOUH6BBtPfdxZamYsBgO8KsXOWugqyXeFcFkEm3c1HK/ysllZ5kM36wI9CUWLedc2vj5JC+xb5CUzhVlGp+Xjn59rGSFiYzIGQC6pVkHgAAAIBve2DugKh3x8qq56sdOH4pVlEDe997ovEg3TUxPPIDMSCROSxSR85fa0aMpxqTndFMNPM81U/+ye4qQC/mr0dpFLBzGuum4u2dEpjQ7B2UyJL9qhs1Ubby5hJ8Z3bmHfOK9/hV8nhyN8gf5uGdrJw6yL0IXCOPr/VDWSUbFrsdeQ==
hf.co ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBL0wtM52yIjm8gRecBy2wRyEMqr8ulG0uewT/IQOGz5K0ZPTIy6GIGHsTi8UXBiEzEIznV3asIz2sS7SiQ311tU=
hf.co ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAINJjhgtT9FOQrsVSarIoPVI1jFMh3VSHdKfdqp/O776s

< > 在 GitHub 上更新