SSH経由のGit

huggingface.co上のリポジトリに、SSH（Secure Shell Protocol）を使用してデータにアクセスし、書き込むことができます。SSH経由で接続すると、ローカルマシンの秘密鍵ファイルを使用して認証が行われます。

変更をプッシュしたり、プライベートリポジトリをクローンしたりする一部の操作では、huggingface.co のアカウントに SSH 公開鍵をアップロードする必要があります。

既存のSSHキーを使用するか、huggingface.co用に新しいキーを生成できます。

既存のSSHキーの確認

既存のSSHキーがある場合、そのキーを使用してSSH経由のGit操作を認証できます。

SSHキーは通常、MacおよびLinuxでは~/.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 経由で変更をプッシュしたりするには、huggingface.co アカウントに SSH 公開鍵を追加する必要があります。SSH 鍵はユーザー設定で管理できます。

アカウントにSSHキーを追加するには、「Add SSH key」ボタンをクリックしてください。

次に、このキーの名前を入力します（例: “Personal computer”）。その後、公開 SSH キーの内容をコピーして、以下の領域に貼り付けてください。公開キーは、前回のステップで見つけた、または生成した ~/.ssh/id_XXXX.pub ファイル内にあります。

「Add key」をクリックすると、ほら！huggingface.co アカウントに SSH キーが追加されました。

SSH認証のテスト

huggingface.coアカウントにSSHキーを追加した後、接続が期待通りに動作するかテストできます。

ターミナルで、次を実行します:

$ 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)

Hugging Faceのホストを手動で検証することを避けるために、~/.ssh/known_hostsファイルに以下のsshキーエントリを追加できます。

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