Git qua SSH

Bạn có thể truy cập và ghi dữ liệu trong các kho lưu trữ trên huggingface.co bằng SSH (Secure Shell Protocol). Khi kết nối qua SSH, bạn xác thực bằng tệp khóa riêng tư trên máy cục bộ của mình.

Một số thao tác, chẳng hạn như đẩy thay đổi hoặc nhân bản các kho lưu trữ riêng tư, sẽ yêu cầu bạn tải lên khóa SSH công khai của bạn vào tài khoản trên huggingface.co.

Bạn có thể sử dụng một khóa SSH có sẵn, hoặc tạo một khóa mới dành riêng cho huggingface.co.

Kiểm tra các khóa SSH hiện có

Nếu bạn đã có sẵn một khóa SSH, bạn có thể sử dụng khóa đó để xác thực các thao tác Git qua SSH.

Khóa SSH thường nằm trong ~/.ssh trên Mac & Linux, và trong C:\\Users\\<username>\\.ssh trên Windows. Liệt kê các tệp trong thư mục đó và tìm các tệp có dạng:

• id_rsa.pub
• id_ecdsa.pub
• id_ed25519.pub

Các tệp đó chứa khóa SSH công khai của bạn.

Nếu bạn không có tệp như vậy trong ~/.ssh, bạn sẽ phải tạo một khóa mới. Ngược lại, bạn có thể thêm khóa công khai SSH hiện có của bạn vào tài khoản huggingface.co.

Tạo một cặp khóa SSH mới

Nếu máy của bạn chưa có khóa SSH nào, bạn có thể dùng ssh-keygen để tạo một cặp khóa SSH mới (khóa công khai + khóa riêng tư):

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

Chúng tôi khuyến nghị bạn nhập một mật khẩu (passphrase) khi được yêu cầu. Mật khẩu là một lớp bảo mật bổ sung: đây là mật khẩu sẽ được yêu cầu mỗi khi bạn sử dụng khóa SSH của mình.

Khi khóa mới của bạn được tạo, hãy thêm nó vào SSH agent của bạn bằng ssh-add:

$ ssh-add ~/.ssh/id_ed25519

Nếu bạn chọn một vị trí khác với vị trí mặc định để lưu trữ khóa SSH, bạn sẽ phải thay thế ~/.ssh/id_ed25519 bằng vị trí tệp mà bạn đã sử dụng.

Thêm một khóa SSH vào tài khoản của bạn

Để truy cập các kho lưu trữ riêng bằng SSH, hoặc để đẩy các thay đổi qua SSH, bạn cần thêm khóa công khai SSH của mình vào tài khoản huggingface.co. Bạn có thể quản lý các khóa SSH của mình trong cài đặt người dùng.

Để thêm một khóa SSH vào tài khoản của bạn, hãy nhấp vào nút “Add SSH key”.

Sau đó, nhập tên cho khóa này (ví dụ: “Máy tính cá nhân”), rồi sao chép và dán nội dung khóa SSH công khai của bạn vào khu vực bên dưới. Khóa công khai nằm trong tệp ~/.ssh/id_XXXX.pub mà bạn đã tìm thấy hoặc tạo ở các bước trước đó.

Nhấp vào “Add key”, và voilà! Bạn đã thêm một khóa SSH vào tài khoản huggingface.co của mình.

Kiểm tra xác thực SSH của bạn

Sau khi bạn đã thêm khóa SSH vào tài khoản huggingface.co của mình, bạn có thể kiểm tra xem kết nối có hoạt động như mong đợi hay không.

Trong một terminal, chạy:

$ ssh -T git@hf.co

Nếu bạn thấy một thông báo chứa tên người dùng của mình, chúc mừng! Mọi thứ đã diễn ra suôn sẻ, bạn đã sẵn sàng sử dụng git qua SSH.

Ngược lại, nếu thông báo hiển thị nội dung tương tự như sau, hãy đảm bảo rằng khóa SSH của bạn thực sự được sử dụng bởi tác nhân SSH của bạn.

Hi anonymous, welcome to Hugging Face.

Dấu vân tay khóa SSH của Hugging Face

Dấu vân tay khóa công khai có thể được sử dụng để xác thực kết nối với một máy chủ từ xa.

Đây là các dấu vân tay khóa công khai của Hugging Face:

SHA256:aBG5R7IomF4BSsx/h6tNAUVLhEkkaNGB8Sluyh/Q/qY (ECDSA) SHA256:skgQjK2+RuzvdmHr24IIAJ6uLWQs0TGtEUt3FtzqirQ (DSA - không còn được hỗ trợ) SHA256:dVjzGIdV7d6cwKIeZiCoRMa2gMvSKfGZAvHf4gMiMao (ED25519) SHA256:uqjYymysBGCXXiMVebB8L8RIuWbPSKGBxQQNhcT5a3Q (RSA)

Bạn có thể thêm các mục khóa ssh sau vào tệp ~/.ssh/known_hosts của bạn để tránh việc xác minh thủ công các host của 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