Hub documentation

Git عبر SSH

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Git عبر SSH

يمكنك الوصول إلى البيانات في المستودعات على huggingface.co وكتابتها باستخدام SSH (بروتوكول shell الآمن). عند الاتصال عبر SSH، يتم المصادقة باستخدام ملف مفتاح خاص على جهازك المحلي.

تتطلب بعض الإجراءات، مثل دفع التغييرات أو استنساخ المستودعات الخاصة، رفع مفتاح SSH العام إلى حسابك على huggingface.co.

يمكنك استخدام مفتاح SSH موجود مسبقًا، أو توليد مفتاح جديد مخصص لموقع huggingface.co.

التحقق من مفاتيح SSH الموجودة

إذا كان لديك مفتاح SSH موجود مسبقًا، يمكنك استخدام ذلك المفتاح للمصادقة على عمليات Git عبر SSH.

تقع مفاتيح SSH عادةً تحت ~/.ssh على أنظمة ماك و Linux، وتحت 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 الخاص بك باستخدام ssh-add:

$ ssh-add ~/.ssh/id_ed25519

إذا اخترت موقعًا مختلفًا عن الموقع الافتراضي لتخزين مفتاح SSH الخاص بك، فستحتاج إلى استبدال ~/.ssh/id_ed25519 بموقع الملف الذي استخدمته.

إضافة مفتاح SSH إلى حسابك

للوصول إلى المستودعات الخاصة عبر SSH، أو لدفع التغييرات عبر SSH، ستحتاج إلى إضافة مفتاح SSH العام الخاص بك إلى حسابك على huggingface.co. يمكنك إدارة مفاتيح SSH الخاصة بك في إعدادات المستخدم.

لإضافة مفتاح SSH إلى حسابك، انقر على زر “Add SSH key”.

ثم، أدخل اسمًا لهذا المفتاح (على سبيل المثال، “حاسوب شخصي”)، وانسخ والصق محتوى مفتاح SSH العام الخاص بك في المنطقة أدناه. يقع المفتاح العام في الملف ~/.ssh/id_XXXX.pub الذي وجدته أو أنشأته في الخطوات السابقة.

انقر على إضافة مفتاح، وإليك! لقد أضفت مفتاح SSH إلى حسابك على huggingface.co.

اختبار مصادقة SSH الخاصة بك

بمجرد إضافة مفتاح SSH إلى حسابك على huggingface.co، يمكنك اختبار أن الاتصال يعمل كما هو متوقع.

في الطرفية، نفّذ:

$ ssh -T git@hf.co

إذا رأيت رسالة تحتوي على اسم المستخدم الخاص بك، فتهانينا! سارت الأمور على ما يرام، وأنت مستعد لاستخدام git عبر SSH.

وإلا، إذا كان النص يتضمن شيئًا مما يلي، فتأكد من أن مفتاح SSH الخاص بك يُستخدم فعليًا بواسطة وكيل SSH.

Hi anonymous, welcome to Hugging Face.

بصمات مفاتيح SSH الخاصة بـ Hugging Face

يمكن استخدام بصمات المفاتيح العامة للتحقق من الاتصال بخادم بعيد.

إليك بصمات المفاتيح العامة العامة لـ 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
Update on GitHub