Sửa lỗi SSH Permission denied (publickey)
Lỗi “Permission denied (publickey)” có 5 nguyên nhân. Đọc output ssh -v để xác định đúng lỗi và sửa mà không tự khóa quyền truy cập SSH.
Ý nghĩa thực sự của “Permission denied (publickey)”
“Permission denied (publickey)” nghĩa là client của bạn đã gửi một hoặc nhiều public key nhưng server không chấp nhận key nào. Network vẫn hoạt động và sshd vẫn đang chạy: việc từ chối xảy ra ở bước cuối của quá trình xác thực. Nếu session bị ngắt trước bước đó, bạn đang gặp connection refused hoặc connection timed out, đây là một chẩn đoán khác với các bước kiểm tra khác. Không cần đoán cách sửa, vì ssh -v cho biết bạn đang gặp một trong năm nguyên nhân.
Các phương thức trong dấu ngoặc là những phương thức server chấp nhận. Permission denied (publickey) tự nó có nghĩa là đăng nhập bằng password đã bị tắt trên server đó, nên không có password để chuyển sang dùng. Permission denied (publickey,password) có nghĩa là password được cho phép nhưng bạn cũng xác thực bằng password không thành công.
Một thông báo này bao quát năm lỗi riêng biệt và cố ý không nêu rõ nguyên nhân. Nếu server trả lời “không có user đó” hoặc “key đó chưa được cài đặt”, thông tin này sẽ giúp bất kỳ ai đang quét các account hợp lệ. Vì vậy, đừng bắt đầu thay key và sửa các file cấu hình. Chạy một command, đọc ba dòng output, rồi thu hẹp năm nguyên nhân có thể xuống còn một.
Chạy ssh -v trước và đọc 3 dòng
Lặp lại lệnh đã lỗi, thêm -v:
ssh -v deploy@203.0.113.10Kết quả đã rút gọn nhưng vẫn thực tế sẽ trông như sau:
OpenSSH_9.6p1 Ubuntu-3ubuntu13, OpenSSL 3.0.13 30 Jan 2024
debug1: Connecting to 203.0.113.10 [203.0.113.10] port 22.
debug1: Connection established.
debug1: Authenticating to 203.0.113.10:22 as 'deploy'
debug1: Authentications that can continue: publickey
debug1: Next authentication method: publickey
debug1: Will attempt key: /home/you/.ssh/id_ed25519 ED25519 SHA256:0eL/8sBw... agent
debug1: Offering public key: /home/you/.ssh/id_ed25519 ED25519 SHA256:0eL/8sBw... agent
debug1: Authentications that can continue: publickey
debug1: No more authentication methods to try.
deploy@203.0.113.10: Permission denied (publickey).3 dòng này chứa mọi thông tin bạn cần.
Authenticating to 203.0.113.10:22 as 'deploy' là username thực tế sẽ được dùng. Không phải username bạn định dùng, mà là username được ssh xác định từ dòng lệnh, từ ~/.ssh/config hoặc từ tên đăng nhập local của bạn.
Authentications that can continue: publickey là danh sách các phương thức server chấp nhận, được gửi trước khi thử bất kỳ key nào. Nếu publickey không có trong danh sách đầu tiên đó, server đã tắt đăng nhập bằng public key, nên không key nào có thể hoạt động.
Offering public key: ... được in cho từng key mà ssh đã có public half, ngay trước khi ssh gửi key đó, sau đó là loại key và fingerprint SHA256 của key. Key được đọc từ file sẽ hiển thị tên file đó. Key chỉ tồn tại trong ssh-agent sẽ hiển thị comment mà agent đã lưu thay cho đường dẫn, còn từ agent ở cuối dòng cho biết key do agent cung cấp. ssh in dòng này ngay trước khi kiểm tra xem hai đầu kết nối có dùng chung signature algorithm cho key hay không. Vì vậy, nếu dòng tiếp theo là send_pubkey_test: no mutual signature algorithm, key đó thực tế chưa được gửi (cause 5 bao quát trường hợp này). Với key mà ssh không thể đọc public half từ trước, sẽ không có dòng Offering: ssh ghi log Trying private key: ... chỉ kèm tên file, load private key rồi gửi ngay một request đã ký. Key không có dòng nào trong 2 dòng trên thì chưa từng được gửi đến server.
Bây giờ hãy chia vấn đề thành 2 trường hợp:
- Không có dòng
Offering public keyhoặcTrying private keycho key bạn mong đợi. Lỗi nằm trên máy của bạn, vì server chưa hề thấy key đó. - Key được offer và
Authentications that can continue: publickeyxuất hiện lại. Server đã nhận key đó nhưng từ chối, nên lỗi nằm trên server.
Các nguyên nhân bên dưới được sắp xếp theo tần suất chúng thực sự là nguyên nhân gây lỗi.
Nguyên nhân 1: bạn đang kết nối bằng sai username
Đây cũng là nguyên nhân phổ biến nhất nhưng ít đáng chú ý nhất. sshd, daemon SSH (secure shell) server, không bao giờ cho biết một account không tồn tại. Nó vẫn thực hiện toàn bộ quá trình kết nối với username không có thật rồi từ chối ở cuối bằng cùng một thông báo, vì để lộ tên account hợp lệ sẽ giúp attacker. Gõ sai username trông giống hệt như key bị lỗi.
Trước tiên, hãy kiểm tra dòng Authenticating to ... as. Nếu dòng này ghi login trên laptop của bạn thay vì account trên server, bạn đã bỏ username khỏi command.
ssh -v deploy@203.0.113.10
ssh -v root@203.0.113.10Account mặc định phụ thuộc vào image mà provider build. Tính đến tháng 08 năm 2026, Ubuntu cloud image thường có account ubuntu, Debian image có debian hoặc admin, Rocky Linux và AlmaLinux có rocky và almalinux, còn nhiều VPS provider cài key trực tiếp vào root. Control panel của provider ghi lại account mà họ đã tạo. Không có command nào chạy từ bên ngoài server có thể hỏi thông tin này.
Một block Host trong ~/.ssh/config cũng đặt username và được ưu tiên hơn login name trên máy local của bạn:
Host vps-prod
HostName 203.0.113.10
User deployNếu bạn tự tạo account rồi không thể đăng nhập bằng account đó, có thể key chỉ được cài cho user mặc định của image và chưa được sao chép sang account mới. Đây là một bước trong 10 phút đầu tiên khi thiết lập VPS mới, nhưng rất dễ bị bỏ qua.
Nguyên nhân 2: key bạn nghĩ mình đang gửi không phải là key thực sự được gửi
Theo mặc định, ssh chỉ offer các key được ssh-agent giữ, cùng một tập tên file cố định trong ~/.ssh: id_rsa, id_ecdsa, id_ed25519, các biến thể hardware key id_ecdsa_sk và id_ed25519_sk, và key hybrid hậu lượng tử id_mldsa44_ed25519. OpenSSH hiện không còn hỗ trợ DSA (OpenSSH 10.0 đã loại bỏ tính năng này vào tháng 4 năm 2025), nên file id_dsa cũ sẽ không bao giờ được thử. Key được lưu dưới tên ~/.ssh/vps-prod sẽ không được ssh thấy cho đến khi bạn chỉ định tên file. Vì vậy output verbose không có dòng Offering public key cho key đó.
Chỉ định tên file và ngăn các key của agent được dùng thay thế:
ssh -i ~/.ssh/vps-prod -o IdentitiesOnly=yes deploy@203.0.113.10Chỉ dùng -i là chưa đủ khi agent đang giữ các key, vì ssh vẫn offer các key của agent trước rồi mới offer file được chỉ định. Điều này quan trọng vì server chạy OpenSSH cũ hơn 10.6 sẽ tính mọi key bị từ chối vào MaxAuthTries, có giá trị mặc định là 6. Agent giữ 7 key có thể dùng hết giới hạn trước khi ssh đến đúng key của bạn. OpenSSH 10.6, phát hành ngày 6 tháng 10 năm 2026, thêm keyword max-pk-ok vào tùy chọn sshd hiện có là PubkeyAuthOptions, viết dưới dạng PubkeyAuthOptions max-pk-ok:6. Tùy chọn này cho phép server kiểm tra tối đa số key được offer đó, mặc định là 6, trước khi các key tiếp theo bắt đầu bị tính vào MaxAuthTries. Nó tăng giới hạn nhưng không loại bỏ giới hạn. Khi đạt đến giới hạn, thông báo sẽ đổi thành:
Received disconnect from 203.0.113.10 port 22:2: Too many authentication failuresNếu bạn thấy thông báo này thay vì thông báo trước, server đã ngắt session trước khi đến đúng key của bạn. Đây là nội dung được đề cập trong quá nhiều lần thử xác thực. IdentitiesOnly=yes giới hạn lần thử ở file bạn đã truyền vào. Dùng ssh-add -l để liệt kê các key agent đang giữ, và dùng ssh-add -D để xóa chúng nếu agent đã tích lũy nhiều key cũ qua nhiều năm. Sau đó ghi các thiết lập này vào cấu hình để lần đăng nhập sau không phụ thuộc vào việc nhớ các flag:
Host vps-prod
HostName 203.0.113.10
User deploy
IdentityFile ~/.ssh/vps-prod
IdentitiesOnly yesCòn một lỗi dễ gặp ở phía client. ssh từ chối dùng private key mà các account khác trên chính máy của bạn có thể đọc. ssh sẽ in cảnh báo và từ chối load key, nên key đó không thể được dùng để đăng nhập. Tuy nhiên, đừng nghĩ rằng dòng Offering sẽ không xuất hiện: khi ssh đã có public key, chẳng hạn từ file .pub nằm cạnh nó, ssh sẽ offer public key đó. Server có thể trả về Server accepts key, sau đó ssh mới load private key để ký, gặp cảnh báo này và bỏ qua key đó:
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@ WARNING: UNPROTECTED PRIVATE KEY FILE! @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Permissions 0644 for '/home/you/.ssh/vps-prod' are too open.chmod 600 ~/.ssh/vps-prod sẽ khắc phục lỗi này. Việc chuyển key qua USB stick hoặc Windows share là nguyên nhân thường gặp khiến mode bị thay đổi. Nội dung về nơi lưu key và cách đặt tên key có trong kiến thức cơ bản về quản lý SSH key.
Nguyên nhân 3: public key không được ghi vào authorized_keys
Nếu ssh -v cho thấy key đã được gửi đi nhưng server vẫn từ chối, câu hỏi tiếp theo là key đó có nằm trong file authorized_keys của account hay không. Hãy mở console của nhà cung cấp để kiểm tra, vì bạn không thể đăng nhập qua SSH để xem file này.
sudo ls -l /home/deploy/.ssh/
sudo ssh-keygen -lf /home/deploy/.ssh/authorized_keysssh-keygen -lf trên file authorized_keys sẽ in một fingerprint cho mỗi entry:
256 SHA256:0eL/8sBw... you@laptop (ED25519)
3072 SHA256:9Tq2yZk... old-laptop (RSA)So sánh các fingerprint đó với fingerprint trên dòng Offering public key của bạn. Nếu key được gửi đi trên dòng Trying private key, dòng đó chỉ chứa tên file. Khi đó, hãy dùng ssh-keygen -lf trên file .pub tương ứng để lấy fingerprint. Nếu key không có trong danh sách, key chưa được cài cho account đó, bất kể bạn nhớ mình đã làm gì.
Có 4 lỗi thường gặp:
- Bạn đã dán private key thay vì file
.pub. Một dòng public key chứa loại key nhưssh-ed25519,ecdsa-sha2-nistp256hoặcssh-rsa, sau đó là một chuỗi base64 dài và một comment tùy chọn. Các option nhưrestrictcó thể nằm trước loại key. Private key bắt đầu bằng-----BEGIN OPENSSH PRIVATE KEY-----. - Nội dung dán bị xuống dòng thành nhiều dòng. Mỗi entry phải nằm trên đúng một dòng. Vì vậy, key bị xuống dòng sẽ bị đọc thành nhiều entry hỏng và không khớp với gì cả.
- Key được ghi vào
/root/.ssh/authorized_keysnhưng bạn đăng nhập bằngdeploy, hoặc ngược lại. File này thuộc riêng từng account; không có file dùng chung. - Ô "add my key" của nhà cung cấp chỉ ghi key vào user mặc định của image. Vì vậy, account bạn tạo sau đó có thư mục
.sshtrống.
Cách an toàn để thêm key từ console, với quyền root:
sudo install -d -m 700 -o deploy -g deploy /home/deploy/.ssh
sudo tee -a /home/deploy/.ssh/authorized_keys >/dev/null <<'EOF'
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExampleKeyDataHere you@laptop
EOF
sudo chown deploy:deploy /home/deploy/.ssh/authorized_keys
sudo chmod 600 /home/deploy/.ssh/authorized_keysSau đó chạy lại sudo ssh-keygen -lf /home/deploy/.ssh/authorized_keys. Fingerprint mới phải xuất hiện trong danh sách. Từ một máy vẫn có thể đăng nhập bằng password, ssh-copy-id -i ~/.ssh/vps-prod.pub deploy@203.0.113.10 sẽ nối thêm key cho bạn và tạo .ssh cùng authorized_keys với mode riêng tư nếu chúng chưa tồn tại. Lệnh này không thay đổi mode của thư mục .ssh hoặc file authorized_keys đã tồn tại, nên hãy kiểm tra chúng như mô tả trong nguyên nhân 4.
Nguyên nhân 4: vì sao sshd bỏ qua authorized_keys khi quyền truy cập quá rộng
StrictModes yes là giá trị mặc định của sshd. Với giá trị này, sshd từ chối đọc authorized_keys nếu file đó, thư mục .ssh hoặc thư mục home của account có thể bị bất kỳ ai ngoài owner ghi vào, hoặc thuộc về sai account. Lý do rất rõ: nếu group hoặc mọi account khác có quyền ghi vào thư mục home, bất kỳ account nào có quyền đó cũng có thể thay thế authorized_keys và chiếm quyền đăng nhập. sshd xem một đường dẫn không đáng tin cậy như thể không tồn tại key.
Client chỉ nhận thông báo Permission denied chung chung. Server log ghi lại nguyên nhân thực tế:
Authentication refused: bad ownership or modes for directory /home/deploy/.sshHoặc, nếu vấn đề nằm ở chính file:
Authentication refused: bad ownership or modes for file /home/deploy/.ssh/authorized_keysNhững điều kiện sshd chấp nhận:
- Thư mục home: không được cho group ghi và không được cho mọi account ghi.
755,750và700đều đạt.775và777không đạt. ~/.ssh: áp dụng cùng quy tắc. Manual của sshd khuyến nghị chỉ owner được truy cập, tương ứng với mode700.~/.ssh/authorized_keys: áp dụng cùng quy tắc và phải là regular file. Nếu không phải, log sẽ ghi đường dẫnis not a regular file. Manual khuyến nghị chỉ owner có quyền đọc và ghi, tương ứng với mode600.- Ownership: mỗi mục phải thuộc về account dùng để đăng nhập hoặc root. Owner khác đều không đạt kiểm tra.
Ownership quan trọng không kém mode. sshd đọc authorized_keys với tư cách login account, vì vậy file bạn tạo bằng sudo nano rồi quên chuyển quyền sở hữu lại sẽ vẫn thuộc về root với mode 600. File này vượt qua kiểm tra ownership, nhưng sshd không thể mở nó, và log sẽ báo không thể mở file. Sửa cả hai cùng lúc:
sudo chown -R deploy:deploy /home/deploy/.ssh
sudo chmod 700 /home/deploy/.ssh
sudo chmod 600 /home/deploy/.ssh/authorized_keys
sudo chmod go-w /home/deploy
ls -ld /home/deploy /home/deploy/.sshLệnh cuối hiển thị kết quả. Bạn cần drwxr-xr-x hoặc chặt hơn trên thư mục home, và drwx------ trên .ssh. Nếu các chuỗi này vẫn chưa rõ, hãy đọc cách đọc chuỗi quyền như drwxr-xr-x trước khi đổi mode trên server đang chạy.
Trên Rocky Linux và AlmaLinux, hãy thêm SELinux (security-enhanced Linux) vào danh sách nguyên nhân cần kiểm tra. Thư mục .ssh được tạo bằng một cách bất thường có thể mang sai file label, khiến sshd bị từ chối quyền đọc dù mode trông đúng. sudo restorecon -Rv /home/deploy/.ssh khôi phục các label, còn sudo ausearch -m avc -ts recent cho biết SELinux có phải thành phần từ chối hay không.
Nguyên nhân 5: sshd được cấu hình để từ chối bạn
Chỉ đọc /etc/ssh/sshd_config là chưa đủ trên hệ thống Ubuntu hoặc Debian hiện tại. File đó bắt đầu bằng Include /etc/ssh/sshd_config.d/*.conf, và OpenSSH luôn dùng giá trị đầu tiên mà nó tìm thấy cho mỗi setting. Vì vậy, file drop-in như 50-cloud-init.conf được đọc trước phần còn lại của file chính và có hiệu lực cao hơn mọi setting toàn cục mà bạn chỉnh ở bên dưới. Ngoại lệ là block Match: manual của sshd_config cho biết các setting bên trong block này ghi đè setting trong phần toàn cục. Vì thế, block Match khớp điều kiện, kể cả khi nằm ở cuối file chính, sẽ có hiệu lực cao hơn file drop-in đối với các connection phù hợp. Các file drop-in được đọc theo thứ tự từ điển. Do đó, file tên 00-something.conf được đọc trước 50-cloud-init.conf, và file nào đặt giá trị trước thì giá trị đó được dùng. Đây là lý do một chỉnh sửa có vẻ đúng nhưng hoàn toàn không thay đổi hành vi.
Hãy yêu cầu sshd hiển thị cấu hình có hiệu lực được ghép từ tất cả các file đó:
sudo sshd -T | grep -Ei 'pubkeyauth|authorizedkeysfile|permitrootlogin|allowusers|allowgroups|denyusers'sshd -T khởi chạy một tiến trình test mới và đọc các file đúng như chúng đang tồn tại trên disk. Lệnh này không hỏi tiến trình sshd đang chạy, nên chỉnh sửa chưa được áp dụng bằng restart vẫn được hiển thị ở đây trước khi server đang chạy sử dụng nó.
Kết quả bình thường có dạng như sau:
permitrootlogin prohibit-password
pubkeyauthentication yes
authorizedkeysfile .ssh/authorized_keys .ssh/authorized_keys2Các giá trị cần kiểm tra trong output của bạn:
pubkeyauthentication no. Không có key nào được chấp nhận. Giá trị này cũng xuất hiện trongssh -vdưới dạng danh sáchAuthentications that can continue:đầu tiên nhưng không cópublickey.authorizedkeysfiletrỏ đến nơi khác, ví dụ/etc/ssh/authorized_keys/%u. Khi đó file trong home directory bị bỏ qua hoàn toàn, và các quy tắc về mode từ nguyên nhân 4 được áp dụng cho đường dẫn mới.- Có
allowusershoặcallowgroups. Mọi account không nằm trong danh sách đều bị từ chối với đúng lỗi này và không có giải thích.denyusersvàdenygroupshoạt động ngược lại. - Có
permitrootlogin nokhi bạn đang đăng nhập bằng root.prohibit-passwordlà setting trung gian phù hợp: root có thể dùng key nhưng không được dùng password.
Các block Match không xuất hiện trong sshd -T thông thường vì kết quả của chúng phụ thuộc vào người đang kết nối. Hãy kiểm tra một connection cụ thể:
sudo sshd -T -C user=deploy,host=vps.example.com,addr=198.51.100.7Một setting khác ảnh hưởng đến các key cũ. OpenSSH 8.8 mặc định ngừng chấp nhận chữ ký SHA-1 (ssh-rsa), vì vậy một RSA key đã hoạt động nhiều năm có thể ngừng hoạt động sau khi một đầu được upgrade, nếu đầu còn lại quá cũ để dùng RSA với SHA-256. Client hiện tại khi kết nối đến server cũ như vậy sẽ báo rõ nguyên nhân:
debug1: send_pubkey_test: no mutual signature algorithmBản thân key thường không có vấn đề. Release notes của OpenSSH 8.8 cho biết không cần thay thế các key ssh-rsa, vì chúng sẽ chuyển sang RSA/SHA-256 hoặc RSA/SHA-512 khi cả hai đầu đều hỗ trợ. Vì vậy, upgrade đầu cũ là cách khắc phục lâu dài. Nếu không thể upgrade đầu đó, key mới cũng hoạt động miễn là đầu cũ chạy OpenSSH 6.5 trở lên, là bản đã bổ sung Ed25519 (RSA với SHA-256 chỉ xuất hiện từ bản 7.2): ssh-keygen -t ed25519 -C "deploy@vps-prod", sau đó cài file .pub như đã trình bày ở trên. Đầu cũ hơn 6.5 không hỗ trợ Ed25519 hoặc RSA với SHA-256, nên tạo key Ed25519 mới cũng không giúp được. Đặt PubkeyAcceptedAlgorithms +ssh-rsa ở phía đã upgrade (trong block Host của ~/.ssh/config phía client hoặc trong cấu hình sshd của server) sẽ bật lại các chữ ký cũ và giúp bạn đăng nhập ngay hôm nay. Hãy xem đây là cách tạm thời để truy cập server, không phải bước hoàn tất. Các setting phía server còn đáng kiểm tra nằm trong hardening SSH server trên VPS.
Cách xác minh private key khớp với public key đã cài đặt
Phần lớn việc phỏng đoán trong lỗi này xuất phát từ việc không biết hai file có phải là một cặp hay không. Một lệnh sẽ trả lời câu hỏi đó:
ssh-keygen -y -f ~/.ssh/vps-prodLệnh này in ra public key được suy ra từ private key. Lệnh không đọc file .pub nằm cạnh nó, nên cho biết private key thực sự chứa gì thay vì nội dung mà file .pub cũ khẳng định. Nếu key có passphrase, lệnh sẽ yêu cầu nhập passphrase. Điều này cũng xác nhận bạn vẫn biết passphrase đó.
ssh-keygen -lf ~/.ssh/vps-prod.pub
ssh-add -lLệnh đầu tiên in fingerprint của một file public key. Lệnh thứ hai in các fingerprint mà agent đang giữ. Bây giờ hãy đối chiếu 4 cách hiển thị của cùng một chuỗi: fingerprint trên dòng Offering public key từ ssh -v, fingerprint của file .pub, các fingerprint trong ssh-keygen -lf trên authorized_keys của server, và fingerprint trong log của server. Vị trí đầu tiên các giá trị không còn khớp chính là nguyên nhân gây lỗi.
Xem log của server khi đăng nhập thất bại
Client được cố ý không nhận thông tin hữu ích nào. Server ghi lại nguyên nhân thực tế. Bắt đầu theo dõi log trong phiên console, rồi chạy lệnh ssh đang lỗi từ laptop của bạn.
sudo journalctl -u ssh -fUbuntu 24.04 server cloud image tiêu chuẩn cài rsyslog theo mặc định (manifest của package vẫn liệt kê package này vào ngày 3 November 2026), nên các bản ghi tương tự cũng được ghi vào /var/log/auth.log trên đó. Ubuntu 24.04 minimal cloud image không có rsyslog, nên mặc định không có auth.log và journal là nơi cần kiểm tra. Trên Rocky Linux và AlmaLinux, unit có tên sshd và các bản ghi tương tự cũng được ghi vào /var/log/secure.
Đặt LogLevel VERBOSE trong cấu hình sshd rồi reload service. Sau đó, mỗi lần thử sẽ ghi lại fingerprint mà server thực tế nhận được:
Failed publickey for deploy from 198.51.100.7 port 49812 ssh2: ED25519 SHA256:0eL/8sBw...Dòng này cho biết lỗi nằm ở phía nào. Fingerprint bạn nhận ra nghĩa là key của bạn đã đến server nhưng bị server từ chối, nên kiểm tra nguyên nhân 3, 4 và 5. Fingerprint bạn không nhận ra nghĩa là client đã gửi một key khác với key bạn định dùng, nên quay lại nguyên nhân 2.
Nếu log vẫn chưa rõ, hãy chạy một sshd thứ hai trên cổng khác ở chế độ debug. Process này chạy ở foreground, phục vụ một kết nối, in ra quá trình xử lý, rồi thoát:
sudo /usr/sbin/sshd -ddd -p 2222Từ phiên console trên chính server đó, kết nối đến process này qua địa chỉ loopback:
ssh -p 2222 -i ~/.ssh/vps-prod -o IdentitiesOnly=yes deploy@127.0.0.1Kết nối qua 127.0.0.1 giúp loại mạng giữa bạn và server khỏi bài kiểm tra. Lưu lượng loopback vẫn đi qua packet filter của kernel, nhưng trên Ubuntu, rule mặc định của ufw cho phép mọi lưu lượng trên interface lo, nên cổng 2222 không cần rule firewall riêng, trừ khi ai đó đã xóa cấu hình mặc định đó. Output debug cho biết file đã được mở, fingerprint đã được so sánh và nguyên nhân từ chối chính xác, bao gồm các dòng như Authentication refused: bad ownership or modes for directory /home/deploy. Nhấn Ctrl+C khi đã xác định được nguyên nhân. sshd thực tế trên cổng 22 không bị ảnh hưởng trong suốt quá trình này.
Cách tránh tự khóa quyền truy cập
Mọi bước chỉnh sửa cấu hình server đều cần có một cách truy cập dự phòng không phụ thuộc vào SSH. Hãy thiết lập cách này khi SSH vẫn hoạt động, không phải sau khi SSH bị lỗi.
- Mở console của nhà cung cấp qua serial hoặc VNC (virtual network computing), rồi xác nhận bạn có thể đăng nhập tại đó.
- Đảm bảo bạn biết một local password đang hoạt động cho account có quyền sudo. Nếu chưa có, trước tiên hãy reset root password từ console của nhà cung cấp.
- Giữ nguyên SSH session hiện tại. Một session đang mở vẫn tồn tại sau
systemctl restart ssh, nên nó vẫn là đường truy cập dự phòng nếu cấu hình mới bị sai. - Kiểm tra cú pháp trước khi restart:
sudo sshd -tkhông in gì khi file hợp lệ, và in file cùng số dòng khi file không hợp lệ. - Mở terminal thứ hai và đăng nhập lại từ đầu trước khi đóng terminal thứ nhất. Cấu hình bị lỗi sẽ chặn các lần đăng nhập mới nhưng không ảnh hưởng đến các session hiện có, nên session bạn đang sử dụng không thể cho biết thay đổi đã hoạt động hay chưa.
Dùng sudo systemctl restart ssh để restart trên Debian và Ubuntu, hoặc sudo systemctl restart sshd trên Rocky Linux và AlmaLinux. Trên Ubuntu 24.04, sshd được khởi động từ một socket unit; port và địa chỉ của unit này lấy từ sshd_config thông qua systemd generator. Vì vậy, thay đổi đối với Port hoặc ListenAddress cũng cần chạy sudo systemctl daemon-reload rồi sudo systemctl restart ssh.socket trước khi có hiệu lực.
FAQ
Tôi nhận được Permission denied (publickey) khi cùng một key vẫn hoạt động trên server khác. Vì sao?
Vì key không có vấn đề; vấn đề nằm ở phần khác. Chạy ssh -v rồi tìm dòng Offering public key hoặc Trying private key tương ứng với key của bạn. Nếu key không xuất hiện ở cả hai vị trí, ssh chưa gửi key đó: file không nằm trong ~/.ssh với tên mặc định và key chưa được nạp vào agent, vì vậy hãy thêm -i /path/to/key -o IdentitiesOnly=yes. Nếu key có trong danh sách nhưng server vẫn từ chối, key đó bị thiếu trong authorized_keys của account, đường dẫn đến file cho phép group ghi, hoặc cấu hình sshd chặn user. Log của server sẽ phân biệt được các trường hợp này.
Làm thế nào để biết SSH thực sự đang gửi key nào?
ssh -v host in một dòng debug1: Offering public key: cho mỗi key mà nó đã có public half, kèm loại key và fingerprint SHA256. Key được đọc từ file sẽ ghi tên file đó, còn key chỉ có trong agent sẽ hiển thị comment của agent; agent ở cuối dòng cho biết key do agent cung cấp. Nếu dòng tiếp theo là send_pubkey_test: no mutual signature algorithm, key đó thực tế không được gửi. Với key mà ssh không đọc được public half từ trước, sẽ không có dòng Offering nào: ssh in Trying private key: kèm tên file, nạp private key rồi gửi trực tiếp một request có chữ ký. ssh-add -l liệt kê các fingerprint mà agent đang giữ. ssh-keygen -lf ~/.ssh/id_ed25519.pub in fingerprint của một key file, còn ssh-keygen -y -f ~/.ssh/id_ed25519 in public key thực sự được suy ra từ private key. Để đăng nhập thành công, fingerprint của key bạn đã gửi cũng phải xuất hiện trong kết quả ssh-keygen -lf chạy trên authorized_keys của server.
Vì sao sshd bỏ qua file authorized_keys của tôi?
Vì StrictModes được bật mặc định, và file, thư mục .ssh hoặc home directory có quyền ghi đối với group hoặc mọi user, hoặc thuộc sở hữu của account khác với bạn và root. sshd sẽ không tin cậy một đường dẫn mà người khác có thể thay đổi, nên xử lý như thể không có key nào tồn tại. Kiểm tra này yêu cầu cả ba thành phần không được cho group hoặc user khác quyền ghi, mỗi thành phần phải thuộc sở hữu của login account hoặc root, và authorized_keys phải là file thông thường. Vì vậy, chỉ xóa quyền ghi không phải lúc nào cũng đủ. Dùng 755 hoặc chặt hơn cho home directory, 700 trên .ssh và 600 trên authorized_keys, tất cả đều thuộc sở hữu của login account. Đây là cấu hình an toàn nên dùng. Với LogLevel VERBOSE, server sẽ ghi lại Authentication refused: bad ownership or modes for directory /home/deploy/.ssh.
Key của tôi ngừng hoạt động ngay sau khi nâng cấp server. Đã thay đổi điều gì?
Nếu đây là RSA key, nguyên nhân nhiều khả năng là thay đổi liên quan đến SHA-1. OpenSSH 8.8 mặc định đã vô hiệu hóa chữ ký SHA-1 ssh-rsa, vì vậy RSA key bị từ chối khi đầu bên kia chỉ có thể dùng key theo cách đó. Client hiện tại hiển thị debug1: send_pubkey_test: no mutual signature algorithm. Không cần thay key nếu bạn có thể nâng cấp đầu bên cũ, vì RSA key sử dụng SHA-256 hoặc SHA-512 khi cả hai đầu đều hỗ trợ. Nếu không thể nâng cấp, và đầu bên cũ chạy OpenSSH 6.5 trở lên, hãy tạo key hiện đại bằng ssh-keygen -t ed25519 rồi cài file .pub của key đó. Đầu bên cũ hơn 6.5 không hỗ trợ Ed25519 cũng như RSA với SHA-256, nên tạo key mới không giải quyết được trường hợp này. Nếu cần truy cập ngay, PubkeyAcceptedAlgorithms +ssh-rsa trên đầu bên đã nâng cấp sẽ bật lại các chữ ký cũ. Bạn nên xóa dòng đó sau khi đã áp dụng giải pháp lâu dài.
Tôi đã sửa sshd_config và giờ hoàn toàn không thể đăng nhập. Làm cách nào để truy cập lại?
Dùng console của nhà cung cấp; kết nối này không đi qua SSH. Đăng nhập tại đó bằng local password, chạy sudo sshd -t để xem lỗi cú pháp và số dòng, hoàn tác thay đổi rồi khởi động lại service. Sau đó chạy sudo sshd -T để xem các giá trị hiệu lực mà các file hiện tạo ra, vì file trong /etc/ssh/sshd_config.d/ có thể đang ghi đè cấu hình chính. Lệnh này đọc lại các file thay vì hỏi sshd đang chạy, vì vậy sau mỗi lần sửa tiếp theo, hãy khởi động lại service trước khi thử đăng nhập. Nếu không có local password, trước hết hãy reset root password từ console, rồi sửa file.