通过 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 上更新