🚀 Hướng Dẫn Cài Đặt SSH Keys cho GitLab (Bước Bước)

Khi làm việc với GitLab, việc sử dụng SSH là cách an toàn và thuận tiện nhất để tương tác với các kho lưu trữ của bạn. Thay vì phải nhập tên người dùng và mật khẩu mỗi lần, SSH keys cho phép bạn kết nối chỉ bằng một lệnh.

Trong hướng dẫn này, tôi sẽ chỉ cho bạn cách thiết lập SSH keys cho GitLab từ đầu.

🔑 Bước 1: Kiểm tra xem bạn đã có SSH keys chưa

Mở terminal và chạy lệnh:

ls -al ~/.ssh

Nếu bạn thấy các tệp như id_rsa.pub hoặc id_ed25519.pub, có thể bạn đã có một khóa. Nếu không, hãy tạo một cái mới.

🛠️ Bước 2: Tạo một SSH key mới

Chạy lệnh sau (thay thế email bằng của bạn):

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

• Nhấn Enter để chấp nhận đường dẫn tệp mặc định.
• Tùy chọn đặt một mật khẩu cho thêm bảo mật.

Điều này tạo ra hai tệp:

• id_ed25519 → khóa riêng tư của bạn (giữ bí mật!)
• id_ed25519.pub → khóa công khai của bạn (cái này sẽ được đưa lên GitLab).

⚙️ Bước 3: Thêm SSH key vào ssh-agent

Khởi động agent:

eval "$(ssh-agent -s)"

Sau đó thêm khóa của bạn:

ssh-add ~/.ssh/id_ed25519

📋 Bước 4: Sao chép khóa công khai của bạn

Chạy lệnh:

cat ~/.ssh/id_ed25519.pub

Sao chép đầu ra (toàn bộ dòng bắt đầu bằng ssh-ed25519).

🔗 Bước 5: Thêm khóa vào GitLab

1. Đăng nhập vào GitLab.
2. Đi đến Cài đặt người dùng → SSH Keys.
3. Dán khóa công khai của bạn vào.
4. Thêm tiêu đề và nhấn Thêm khóa.

✅ Bước 6: Kiểm tra kết nối

Chạy lệnh:

ssh -T git@gitlab.com

Nếu thành công, bạn sẽ thấy:

Welcome to GitLab, @yourusername!

📥 Bước 7: Nhân bản kho lưu trữ bằng SSH

Bây giờ bạn có thể nhân bản bất kỳ kho nào mà không cần nhập mật khẩu:

git clone git@gitlab.com:groupname/reponame.git

🎯 Lưu ý cuối cùng

• Luôn giữ khóa riêng tư của bạn an toàn và không bao giờ chia sẻ nó.
• Nếu bạn làm việc trên nhiều máy, bạn sẽ cần thêm một khóa cho mỗi máy.
• Bạn có thể sử dụng SSH cho cả GitLab.com và các phiên bản GitLab tự lưu trữ.

💡 Thực Hành Tốt Nhất

• Bảo mật khóa riêng tư của bạn: Sử dụng mật khẩu cho SSH key để tăng cường bảo mật.
• Sao lưu: Đảm bảo bạn có bản sao lưu cho các khóa của mình phòng trường hợp bạn mất máy tính.

⚠️ Cạm Bẫy Thường Gặp

• Quên mật khẩu: Nếu bạn quên mật khẩu của SSH key, bạn sẽ cần tạo một SSH key mới.
• Khóa không được chấp nhận: Đảm bảo sao chép chính xác khóa công khai vào GitLab.

⚡ Mẹo Hiệu Suất

• Sử dụng Ed25519: Định dạng khóa Ed25519 được khuyên dùng vì tính bảo mật và hiệu suất cao hơn.
• Quản lý nhiều khóa: Sử dụng ~/.ssh/config để quản lý nhiều SSH keys cho các tài khoản khác nhau.

❓ Câu Hỏi Thường Gặp

1. Tôi có thể sử dụng SSH cho các kho Git khác không?
Có, bạn có thể sử dụng SSH cho bất kỳ kho Git nào hỗ trợ nó, không chỉ GitLab.

2. Làm thế nào để xóa một SSH key?
Bạn có thể xóa khóa trong phần cài đặt SSH Keys trên GitLab.

🔥 Đó là tất cả! Bạn đã sẵn sàng sử dụng SSH với GitLab.
Tôi rất mong được nghe ý kiến của bạn—hãy để lại một bình luận nếu bạn đã thử hoặc gặp bất kỳ vấn đề gì.