Khắc phục triệt để lỗi “Permission Denied” khi dùng Git SSH: Hướng dẫn chi tiết

Bạn đang vật lộn với lỗi “Permission Denied” khi cố gắng sử dụng Git qua SSH? Đừng lo lắng, đây là một vấn đề phổ biến mà rất nhiều lập trình viên gặp phải. Lỗi này thường xuất hiện khi Git không được phép truy cập vào repository thông qua giao thức SSH. Bài viết này sẽ cung cấp một hướng dẫn chi tiết, dễ hiểu từng bước để bạn có thể khắc phục lỗi này một cách triệt để, giúp bạn tập trung vào công việc chính là code chứ không phải loay hoay với những vấn đề kỹ thuật.

Lỗi “Permission Denied” khi sử dụng Git SSH có thể khiến bạn mất rất nhiều thời gian để tìm ra nguyên nhân và cách khắc phục. Hiểu rõ các nguyên nhân tiềm ẩn và áp dụng các giải pháp phù hợp là chìa khóa để giải quyết vấn đề một cách hiệu quả.

Tại sao lại gặp lỗi “Permission Denied” khi dùng Git SSH?

Trước khi đi sâu vào các giải pháp, chúng ta cần hiểu rõ những nguyên nhân phổ biến gây ra lỗi này:

  • Sai cấu hình SSH Key: Đây là nguyên nhân phổ biến nhất. Có thể bạn chưa tạo SSH key, hoặc đã tạo nhưng chưa thêm vào tài khoản Git của bạn (GitHub, GitLab, Bitbucket, v.v.). Hoặc thậm chí, bạn đã thêm key nhưng lại dùng sai key (ví dụ, dùng private key thay vì public key).
  • Quyền truy cập bị hạn chế: Repository bạn muốn truy cập có thể được đặt ở chế độ private và bạn chưa được cấp quyền truy cập.
  • Vấn đề với file known_hosts: File này chứa thông tin về các máy chủ SSH mà bạn đã từng kết nối. Nếu file này bị hỏng hoặc chứa thông tin sai lệch, Git có thể từ chối kết nối.
  • Firewall hoặc Network: Firewall hoặc các quy tắc mạng có thể chặn kết nối SSH đến máy chủ Git.
  • Sai username hoặc hostname: Bạn có thể đang sử dụng sai username hoặc hostname khi kết nối đến repository.
  • Vấn đề với SSH Agent: SSH agent giúp bạn quản lý các SSH key. Nếu agent không hoạt động đúng cách, Git có thể không tìm thấy key cần thiết.
  • Phần mềm diệt virus: Đôi khi, phần mềm diệt virus có thể can thiệp vào quá trình SSH và gây ra lỗi.

Chuyên gia bảo mật mạng Nguyễn Văn A cho biết: “Lỗi ‘Permission Denied’ thường là do cấu hình SSH Key chưa chính xác. Việc kiểm tra kỹ lưỡng các bước tạo và thêm key là rất quan trọng.”

Các bước khắc phục lỗi “Permission Denied” khi dùng Git SSH

Bây giờ chúng ta sẽ đi vào chi tiết các bước để khắc phục lỗi “Permission Denied”. Hãy thực hiện tuần tự theo các bước sau:

1. Kiểm tra SSH Key

Đây là bước đầu tiên và quan trọng nhất. Hãy đảm bảo rằng bạn đã có SSH key và đã thêm public key vào tài khoản Git của bạn.

1.1. Kiểm tra xem đã có SSH Key chưa

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

ls -al ~/.ssh

Lệnh này sẽ liệt kê các file trong thư mục .ssh. Nếu bạn thấy các file id_rsa (private key) và id_rsa.pub (public key), nghĩa là bạn đã có SSH key. Nếu không thấy, hãy tạo một SSH key mới.

1.2. Tạo SSH Key mới

Nếu bạn chưa có SSH key, hãy tạo một key mới bằng lệnh sau:

ssh-keygen -t rsa -b 4096 -C "[email protected]"
  • -t rsa: Chỉ định loại key là RSA.
  • -b 4096: Chỉ định độ dài key là 4096 bit (mức độ bảo mật cao).
  • -C "[email protected]": Thêm comment vào key, thường là địa chỉ email của bạn.

Khi được hỏi “Enter file in which to save the key”, bạn có thể nhấn Enter để lưu key vào vị trí mặc định (~/.ssh/id_rsa).

Bạn cũng sẽ được hỏi “Enter passphrase (empty for no passphrase)”. Bạn có thể nhập một passphrase để bảo vệ key của mình, hoặc để trống nếu không muốn sử dụng passphrase.

1.3. Thêm SSH Key vào tài khoản Git

Sau khi tạo SSH key, bạn cần thêm public key (id_rsa.pub) vào tài khoản Git của bạn (GitHub, GitLab, Bitbucket, v.v.).

  • GitHub: Vào Settings -> SSH and GPG keys -> New SSH key.
  • GitLab: Vào User Settings -> SSH Keys -> Add SSH Key.
  • Bitbucket: Vào Settings -> SSH keys -> Add key.

Mở file id_rsa.pub bằng một trình soạn thảo văn bản và copy toàn bộ nội dung của file này vào trường “Key” hoặc “Public Key” trên trang web của Git.

2. Kiểm tra SSH Agent

SSH agent giúp bạn quản lý các SSH key và tự động cung cấp key cho Git khi cần thiết. Hãy đảm bảo rằng SSH agent đang chạy và đã được thêm key của bạn.

2.1. Kiểm tra trạng thái SSH Agent

Chạy lệnh sau để kiểm tra xem SSH agent có đang chạy hay không:

eval "$(ssh-agent -s)"

Nếu lệnh này trả về một PID (Process ID), nghĩa là SSH agent đang chạy. Nếu không, hãy khởi động SSH agent bằng lệnh trên.

2.2. Thêm SSH Key vào SSH Agent

Chạy lệnh sau để thêm SSH key vào SSH agent:

ssh-add ~/.ssh/id_rsa

Nếu bạn đã đặt passphrase cho key, bạn sẽ được yêu cầu nhập passphrase.

Nếu bạn gặp lỗi “Could not open a connection to your authentication agent”, hãy thử khởi động lại SSH agent.

3. Kiểm tra file known_hosts

File known_hosts chứa thông tin về các máy chủ SSH mà bạn đã từng kết nối. Nếu file này bị hỏng hoặc chứa thông tin sai lệch, Git có thể từ chối kết nối.

3.1. Xóa thông tin về máy chủ Git trong file known_hosts

Mở file ~/.ssh/known_hosts bằng một trình soạn thảo văn bản. Tìm dòng nào chứa hostname hoặc IP address của máy chủ Git (ví dụ, github.com hoặc gitlab.com) và xóa dòng đó.

3.2. Kết nối lại đến máy chủ Git

Sau khi xóa thông tin trong file known_hosts, hãy thử kết nối lại đến máy chủ Git. Git sẽ yêu cầu bạn xác nhận fingerprint của máy chủ. Hãy xác nhận và tiếp tục.

4. Kiểm tra quyền truy cập Repository

Repository bạn muốn truy cập có thể được đặt ở chế độ private và bạn chưa được cấp quyền truy cập. Hãy đảm bảo rằng bạn đã được thêm vào danh sách những người có quyền truy cập repository. Liên hệ với quản trị viên của repository để được cấp quyền.

5. Kiểm tra Firewall và Network

Firewall hoặc các quy tắc mạng có thể chặn kết nối SSH đến máy chủ Git. Hãy kiểm tra cấu hình firewall và đảm bảo rằng cổng 22 (cổng mặc định cho SSH) không bị chặn. Nếu bạn đang sử dụng VPN, hãy thử tắt VPN và kết nối lại.

6. Kiểm tra Username và Hostname

Hãy đảm bảo rằng bạn đang sử dụng đúng username và hostname khi kết nối đến repository. Username thường là username của bạn trên GitHub, GitLab, hoặc Bitbucket. Hostname là địa chỉ của máy chủ Git (ví dụ, github.com hoặc gitlab.com).

7. Vô hiệu hóa tạm thời phần mềm diệt virus

Đôi khi, phần mềm diệt virus có thể can thiệp vào quá trình SSH và gây ra lỗi. Hãy thử vô hiệu hóa tạm thời phần mềm diệt virus và kết nối lại. Nếu kết nối thành công, hãy thêm Git vào danh sách ngoại lệ của phần mềm diệt virus.

8. Cấu hình file .ssh/config

File .ssh/config cho phép bạn tùy chỉnh các cài đặt SSH. Bạn có thể sử dụng file này để chỉ định SSH key nào được sử dụng cho một máy chủ cụ thể.

8.1. Tạo hoặc chỉnh sửa file .ssh/config

Nếu bạn chưa có file .ssh/config, hãy tạo một file mới trong thư mục .ssh. Nếu đã có, hãy mở file này bằng một trình soạn thảo văn bản.

8.2. Thêm cấu hình cho máy chủ Git

Thêm đoạn cấu hình sau vào file .ssh/config, thay thế github.com bằng hostname của máy chủ Git bạn muốn kết nối:

Host github.com
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_rsa
  • Host: Chỉ định hostname mà cấu hình này áp dụng.
  • HostName: Chỉ định hostname thực tế của máy chủ.
  • User: Chỉ định username sử dụng để kết nối.
  • IdentityFile: Chỉ định đường dẫn đến private key.

Sau khi thêm cấu hình, hãy lưu file .ssh/config.

Kỹ sư DevOps Lê Thị B cho biết: “Việc cấu hình file .ssh/config giúp bạn quản lý SSH key một cách hiệu quả, đặc biệt khi bạn làm việc với nhiều tài khoản Git khác nhau.”

Ví dụ cụ thể cho từng nền tảng

Để giúp bạn dễ hình dung hơn, dưới đây là ví dụ cụ thể cho từng nền tảng Git phổ biến:

GitHub

  • Tạo SSH Key: ssh-keygen -t rsa -b 4096 -C "[email protected]"

  • Thêm SSH Key vào GitHub: Settings -> SSH and GPG keys -> New SSH key

  • Cấu hình .ssh/config:

    Host github.com
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_rsa

GitLab

  • Tạo SSH Key: ssh-keygen -t rsa -b 4096 -C "[email protected]"

  • Thêm SSH Key vào GitLab: User Settings -> SSH Keys -> Add SSH Key

  • Cấu hình .ssh/config:

    Host gitlab.com
  HostName gitlab.com
  User git
  IdentityFile ~/.ssh/id_rsa

Bạn có thể cài gitlab self-hosted để có thể tự mình quản lý git server riêng và dễ dàng kiểm soát quyền truy cập. Tương tự, hiện tượng lỗi “Permission Denied” khi dùng Git SSH cũng có thể xảy ra khi kết nối đến các git server tự quản lý này, đòi hỏi bạn phải kiểm tra cấu hình SSH key và quyền truy cập một cách cẩn thận.

Bitbucket

  • Tạo SSH Key: ssh-keygen -t rsa -b 4096 -C "[email protected]"

  • Thêm SSH Key vào Bitbucket: Settings -> SSH keys -> Add key

  • Cấu hình .ssh/config:

    Host bitbucket.org
  HostName bitbucket.org
  User git
  IdentityFile ~/.ssh/id_rsa

Kiểm tra kết nối SSH

Sau khi thực hiện các bước trên, hãy kiểm tra kết nối SSH bằng lệnh sau:

ssh -T [email protected]

(Thay github.com bằng hostname của máy chủ Git bạn muốn kết nối).

Nếu kết nối thành công, bạn sẽ thấy một thông báo chào mừng từ GitHub (hoặc GitLab, Bitbucket). Nếu vẫn gặp lỗi “Permission Denied”, hãy xem lại các bước trên và đảm bảo rằng bạn đã thực hiện đúng.

Việc git clone dự án lên server cũng sử dụng giao thức SSH, vì vậy, việc khắc phục lỗi “Permission Denied” là rất quan trọng để đảm bảo quá trình triển khai ứng dụng diễn ra suôn sẻ. Điều này có điểm tương đồng với việc cấu hình SSH key trên máy local để có thể clone dự án từ xa.

Các lỗi thường gặp và cách xử lý

Ngoài các nguyên nhân phổ biến đã nêu ở trên, bạn có thể gặp một số lỗi cụ thể khác khi sử dụng Git SSH. Dưới đây là một số lỗi thường gặp và cách xử lý:

  • “Received disconnect from … port 22:2: Too many authentication failures”: Lỗi này thường xảy ra khi bạn có quá nhiều SSH key trong SSH agent. Hãy thử xóa bớt các key không cần thiết khỏi SSH agent.
  • “Host key verification failed”: Lỗi này xảy ra khi fingerprint của máy chủ Git không khớp với thông tin trong file known_hosts. Hãy xóa thông tin về máy chủ Git trong file known_hosts và kết nối lại.
  • “Agent admitted failure to sign using the key”: Lỗi này có thể xảy ra khi bạn sử dụng passphrase cho SSH key và SSH agent không thể truy cập key. Hãy đảm bảo rằng SSH agent đang chạy và đã được thêm key của bạn.

Mẹo và Thủ thuật

Dưới đây là một số mẹo và thủ thuật giúp bạn tránh gặp lỗi “Permission Denied” khi sử dụng Git SSH:

  • Sử dụng SSH Key có độ dài đủ lớn: Nên sử dụng SSH Key có độ dài ít nhất 2048 bit, tốt nhất là 4096 bit.
  • Bảo vệ SSH Key cẩn thận: Không chia sẻ private key của bạn với bất kỳ ai. Lưu trữ private key ở một nơi an toàn và chỉ cấp quyền truy cập cho người dùng đáng tin cậy.
  • Sử dụng Passphrase cho SSH Key: Sử dụng passphrase để bảo vệ SSH Key của bạn. Nếu key bị đánh cắp, kẻ tấn công sẽ cần phải có passphrase để sử dụng key.
  • Cập nhật Git thường xuyên: Cập nhật Git lên phiên bản mới nhất để đảm bảo rằng bạn đang sử dụng các tính năng bảo mật mới nhất.
  • Sử dụng SSH Agent: Sử dụng SSH Agent để quản lý SSH Key của bạn một cách an toàn và tiện lợi.
  • Kiểm tra quyền truy cập Repository: Đảm bảo rằng bạn đã được cấp quyền truy cập repository trước khi cố gắng clone hoặc push code.

Kết luận

Lỗi “Permission Denied” khi dùng Git SSH có thể gây khó chịu, nhưng với hướng dẫn chi tiết này, bạn hoàn toàn có thể tự mình khắc phục. Hãy nhớ kiểm tra kỹ lưỡng các bước cấu hình SSH Key, đảm bảo quyền truy cập repository và kiểm tra kết nối mạng. Nếu bạn vẫn gặp khó khăn, hãy tìm kiếm sự giúp đỡ từ cộng đồng hoặc liên hệ với bộ phận hỗ trợ của nền tảng Git bạn đang sử dụng. Chúc bạn thành công và coding hiệu quả!

FAQ (Câu hỏi thường gặp)

1. Tại sao tôi vẫn gặp lỗi “Permission Denied” sau khi đã thêm SSH key vào GitHub?

Có thể bạn đã thêm sai public key (id_rsa.pub) vào GitHub. Hãy kiểm tra lại nội dung của file id_rsa.pub và đảm bảo rằng nó khớp với key bạn đã thêm vào GitHub.

2. Làm thế nào để biết SSH agent có đang chạy hay không?

Chạy lệnh eval "$(ssh-agent -s)". Nếu lệnh này trả về một PID (Process ID), nghĩa là SSH agent đang chạy.

3. Tôi quên passphrase cho SSH key của mình, làm thế nào để lấy lại?

Không có cách nào để lấy lại passphrase đã quên. Bạn cần phải tạo một SSH key mới và thêm key mới vào tài khoản Git của bạn.

4. File known_hosts nằm ở đâu?

File known_hosts nằm trong thư mục .ssh trong thư mục home của bạn (~/.ssh/known_hosts).

5. Tôi có thể sử dụng nhiều SSH key cho các tài khoản Git khác nhau không?

Có, bạn có thể sử dụng nhiều SSH key cho các tài khoản Git khác nhau. Bạn cần cấu hình file .ssh/config để chỉ định SSH key nào được sử dụng cho mỗi tài khoản.

6. Làm thế nào để kiểm tra kết nối SSH đến máy chủ Git?

Chạy lệnh ssh -T [email protected] (thay github.com bằng hostname của máy chủ Git bạn muốn kết nối).

7. Tôi nên sử dụng SSH Key có độ dài bao nhiêu bit?

Nên sử dụng SSH Key có độ dài ít nhất 2048 bit, tốt nhất là 4096 bit.