SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor

Jak naprawić błąd SSH Permission denied (publickey)

Błąd Permission denied (publickey) ma pięć różnych przyczyn. Analiza logów ssh -v pozwala zidentyfikować źródło problemu i przywrócić dostęp bez ryzyka trwałej blokady.

Co w rzeczywistości oznacza błąd Permission denied (publickey)

Błąd Permission denied (publickey) oznacza, że klient wysłał jeden lub więcej kluczy publicznych, a serwer nie zaakceptował żadnego z nich. Połączenie sieciowe działa poprawnie, a usługa sshd jest uruchomiona: odmowa następuje na ostatnim etapie uwierzytelniania. Jeśli sesja kończy się przed tym momentem, przyczyną jest connection refused lub connection timed out, co stanowi odrębny przypadek wymagający innych testów. Rozwiązanie nie powinno być zgadywane, ponieważ ssh -v wskazuje, która z pięciu przyczyn występuje w danym przypadku.

Słowa w nawiasach określają metody, które serwer jest gotów zaakceptować. Komunikat Permission denied (publickey) oznacza, że logowanie hasłem jest na serwerze wyłączone, więc nie ma możliwości skorzystania z tej metody jako alternatywy. Komunikat Permission denied (publickey,password) oznacza, że logowanie hasłem było dostępne, ale próba ta również zakończyła się niepowodzeniem.

Jeden komunikat obejmuje pięć różnych błędów i jest celowo nieprecyzyjny. Serwer, który odpowiadałby "no such user" lub "that key is not installed", ułatwiałby zadanie osobom skanującym sieć w poszukiwaniu prawidłowych kont. Dlatego nie należy rozpoczynać od wymiany kluczy ani edycji plików konfiguracyjnych. Należy wykonać jedno polecenie, odczytać trzy linie wyjścia, co pozwoli zawęzić pięć możliwych przyczyn do jednej.

Uruchom najpierw ssh -v i przeczytaj trzy linie

Powtórz polecenie, które zakończyło się niepowodzeniem, dodając -v:

ssh -v deploy@203.0.113.10

Skrócony, lecz realistyczny wynik wygląda następująco:

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).

Trzy linie zawierają wszystkie niezbędne informacje.

Authenticating to 203.0.113.10:22 as 'deploy' to nazwa użytkownika, która zostanie faktycznie użyta. Nie ta, którą zamierzałeś podać: to nazwa, którą ssh wyznaczyło na podstawie linii poleceń, pliku ~/.ssh/config lub lokalnej nazwy użytkownika.

Authentications that can continue: publickey to lista metod akceptowanych przez serwer, wysyłana przed próbą użycia jakiegokolwiek klucza. Jeśli publickey brakuje na tej początkowej liście, serwer ma wyłączone logowanie kluczem publicznym, więc żaden klucz nie zadziała.

Offering public key: ... jest drukowane dla każdego klucza, którego część publiczną ssh już posiada, tuż przed zaoferowaniem tego klucza, wraz z typem klucza i jego odciskiem SHA256. Klucz odczytany z pliku wskazuje na ten plik. Klucz istniejący tylko w ssh-agent wyświetla komentarz zapisany przez agenta zamiast ścieżki, a słowo agent na końcu linii oznacza każdy klucz dostarczony przez agenta. ssh drukuje tę linię tuż przed sprawdzeniem, czy obie strony współdzielą algorytm podpisu dla danego klucza, więc jeśli następną linią jest send_pubkey_test: no mutual signature algorithm, klucz ten ostatecznie nie został wysłany (przyczyna 5 obejmuje ten przypadek). Klucz, którego części publicznej ssh nie mogło wcześniej odczytać, nigdy nie otrzyma linii Offering: ssh loguje Trying private key: ... tylko z nazwą pliku, wczytuje klucz prywatny i natychmiast wysyła podpisane żądanie. Klucz, dla którego nie ma żadnej z tych linii, nigdy nie został wysłany do serwera.

Teraz podziel problem na dwie części:

  • Brak linii Offering public key lub Trying private key dla oczekiwanego klucza. Błąd leży po stronie Twojej maszyny, ponieważ serwer w ogóle nie otrzymał Twojego klucza.
  • Klucz jest oferowany, a Authentications that can continue: publickey pojawia się ponownie. Serwer otrzymał ten klucz i go odrzucił, więc błąd leży po stronie serwera.

Poniższe przyczyny zostały uszeregowane według częstotliwości występowania.

Przyczyna 1: połączenie z użyciem błędnej nazwy użytkownika

Najczęstsza przyczyna jest jednocześnie najmniej złożona. sshd, demon serwera SSH (secure shell), nigdy nie informuje o nieistniejącym koncie. Przeprowadza pełną wymianę danych dla wymyślonej nazwy użytkownika, a na końcu odmawia dostępu z tym samym komunikatem, ponieważ ujawnianie poprawnych nazw kont ułatwia atak. Literówka w nazwie użytkownika wygląda identycznie jak uszkodzony klucz.

Przed podjęciem innych działań sprawdź linię Authenticating to ... as. Jeśli wskazuje ona na nazwę użytkownika z Twojego laptopa zamiast na konto serwerowe, oznacza to, że w poleceniu pominięto nazwę użytkownika.

ssh -v deploy@203.0.113.10
ssh -v root@203.0.113.10

Domyślne konto zależy od obrazu przygotowanego przez dostawcę. Według stanu na sierpień 2026, obrazy chmurowe Ubuntu zazwyczaj zawierają konto ubuntu, obrazy Debian zawierają debian lub admin, Rocky Linux i AlmaLinux zawierają rocky oraz almalinux, a wielu dostawców VPS instaluje klucz bezpośrednio w root. Panel sterowania dostawcy zawiera informację o tym, jakie konto zostało utworzone. Żadne polecenie uruchomione spoza serwera nie jest w stanie tego sprawdzić.

Blok Host w pliku ~/.ssh/config również definiuje nazwę użytkownika i ma ona pierwszeństwo przed lokalną nazwą użytkownika:

Host vps-prod
  HostName 203.0.113.10
  User deploy

Jeśli konto zostało utworzone samodzielnie, a logowanie nie powiodło się, prawdopodobnie klucz został zainstalowany dla domyślnego użytkownika obrazu i nie został skopiowany. Ten krok jest częścią poradnika pierwsze dziesięć minut na nowym VPS i łatwo go pominąć.

Przyczyna 2: klucz, który ma być użyty, nie jest tym, który jest wysyłany

Domyślnie ssh oferuje tylko klucze przechowywane przez ssh-agent oraz stały zestaw nazw plików w ~/.ssh: id_rsa, id_ecdsa, id_ed25519, warianty dla kluczy sprzętowych id_ecdsa_sk i id_ed25519_sk oraz hybrydowe klucze postkwantowe id_mldsa44_ed25519. Obecne wydania OpenSSH nie obsługują już DSA (OpenSSH 10.0 usunęło to wsparcie w kwietniu 2025 roku), więc stary plik id_dsa nigdy nie jest sprawdzany. Klucz zapisany jako ~/.ssh/vps-prod jest niewidoczny dla ssh, dopóki nie zostanie wskazany z nazwy, dlatego szczegółowy tryb diagnostyczny nie wyświetla dla niego linii Offering public key.

Wskaż plik i zablokuj użycie kluczy z agenta:

ssh -i ~/.ssh/vps-prod -o IdentitiesOnly=yes deploy@203.0.113.10

Samo -i nie wystarcza, gdy agent przechowuje klucze, ponieważ ssh nadal oferuje klucze agenta w pierwszej kolejności, a wskazany plik na końcu. Ma to znaczenie, ponieważ serwer z OpenSSH starszym niż 10.6 wlicza każdy odrzucony klucz do limitu MaxAuthTries, który domyślnie wynosi 6. Agent przechowujący siedem kluczy może wyczerpać limit, zanim ssh dotrze do właściwego klucza. OpenSSH 10.6, wydane 6 października 2026 roku, dodaje słowo kluczowe max-pk-ok do istniejącej opcji sshd PubkeyAuthOptions, zapisywanej jako PubkeyAuthOptions max-pk-ok:6. Pozwala to serwerowi sprawdzić określoną liczbę oferowanych kluczy (domyślnie 6), zanim kolejne zaczną być wliczane do MaxAuthTries. Zwiększa to limit, ale go nie usuwa. Po osiągnięciu limitu komunikat zmienia się na:

Received disconnect from 203.0.113.10 port 22:2: Too many authentication failures

Jeśli wyświetlany jest właśnie ten komunikat, serwer zakończył sesję, zanim dotarto do właściwego klucza, co jest tematem zbyt wielu nieudanych prób uwierzytelnienia. IdentitiesOnly=yes ogranicza próbę logowania do wskazanego pliku. Wyświetl listę kluczy w agencie za pomocą ssh-add -l i wyczyść go poleceniem ssh-add -D, jeśli zgromadził wiele starych kluczy. Następnie zapisz ustawienia w pliku konfiguracyjnym, aby kolejne logowanie nie wymagało pamiętania o flagach:

Host vps-prod
  HostName 203.0.113.10
  User deploy
  IdentityFile ~/.ssh/vps-prod
  IdentitiesOnly yes

Kolejna pułapka po stronie klienta. ssh odmawia użycia klucza prywatnego, jeśli inne konta w systemie mają do niego dostęp do odczytu. Wyświetlane jest ostrzeżenie i ładowanie klucza zostaje przerwane, co uniemożliwia logowanie. Nie należy jednak oczekiwać braku linii Offering: gdy ssh posiada już połowę publiczną, na przykład z pliku .pub, oferuje ją, serwer może odpowiedzieć Server accepts key, a dopiero wtedy ssh ładuje klucz prywatny w celu złożenia podpisu, napotyka ostrzeżenie i rezygnuje z tego klucza:

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@         WARNING: UNPROTECTED PRIVATE KEY FILE!          @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Permissions 0644 for '/home/you/.ssh/vps-prod' are too open.

chmod 600 ~/.ssh/vps-prod rozwiązuje ten problem. Przenoszenie klucza przez pamięć USB lub udziały sieciowe Windows to najczęstsza przyczyna utraty uprawnień. Lokalizacja kluczy oraz zasady ich nazywania zostały opisane w podstawach zarządzania kluczami SSH.

Przyczyna 3: klucz publiczny nie trafił do pliku authorized_keys

Jeśli ssh -v wykazuje wysłanie klucza, a serwer nadal odmawia dostępu, należy sprawdzić, czy klucz znajduje się w pliku authorized_keys danego konta. Należy otworzyć konsolę dostawcy usług, ponieważ logowanie przez SSH w celu weryfikacji jest niemożliwe.

sudo ls -l /home/deploy/.ssh/
sudo ssh-keygen -lf /home/deploy/.ssh/authorized_keys

Polecenie ssh-keygen -lf wykonane na pliku authorized_keys wyświetla jeden odcisk palca (fingerprint) dla każdego wpisu:

256 SHA256:0eL/8sBw... you@laptop (ED25519)
3072 SHA256:9Tq2yZk... old-laptop (RSA)

Należy porównać te wartości z odciskiem palca w wierszu Offering public key. Jeśli klucz został wysłany w wierszu Trying private key, wiersz ten wskazuje jedynie plik; w takim przypadku należy uzyskać odcisk palca za pomocą ssh-keygen -lf dla odpowiedniego pliku .pub. Jeśli klucza nie ma na liście, oznacza to, że nie został on zainstalowany na danym koncie, niezależnie od podjętych wcześniej działań.

Występują cztery częste przyczyny niepowodzenia:

  • Wklejono klucz prywatny zamiast zawartości pliku .pub. Wiersz klucza publicznego zawiera typ klucza, taki jak ssh-ed25519, ecdsa-sha2-nistp256 lub ssh-rsa, następnie długi ciąg base64 oraz opcjonalny komentarz; przed typem klucza mogą znajdować się opcje, takie jak restrict. Klucz prywatny zaczyna się od -----BEGIN OPENSSH PRIVATE KEY-----.
  • Wklejony tekst został przeniesiony do kilku wierszy. Każdy wpis musi znajdować się dokładnie w jednym wierszu; przeniesiony klucz jest odczytywany jako kilka uszkodzonych wpisów i nie pasuje do żadnego z nich.
  • Klucz trafił do /root/.ssh/authorized_keys, podczas gdy logowanie odbywa się jako deploy (lub odwrotnie). Plik jest przypisany do konkretnego konta i nie istnieje plik współdzielony.
  • Pole "add my key" w panelu dostawcy zapisało klucz tylko dla domyślnego użytkownika obrazu systemu, przez co konto utworzone później posiada pusty katalog .ssh.

Bezpieczny sposób dodania klucza z poziomu konsoli, jako 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_keys

Następnie należy ponownie uruchomić sudo ssh-keygen -lf /home/deploy/.ssh/authorized_keys. Nowy odcisk palca powinien pojawić się na liście. Z maszyny, która nadal pozwala na logowanie hasłem, ssh-copy-id -i ~/.ssh/vps-prod.pub deploy@203.0.113.10 automatycznie dopisze klucz oraz utworzy .ssh i authorized_keys z odpowiednimi uprawnieniami, jeśli jeszcze nie istnieją. Narzędzie to nie zmienia uprawnień istniejącego już katalogu .ssh ani pliku authorized_keys, dlatego należy je zweryfikować zgodnie z opisem w przyczynie 4.

Przyczyna 4: dlaczego sshd ignoruje authorized_keys przy zbyt otwartych uprawnieniach

StrictModes yes to ustawienie domyślne sshd. Zgodnie z nim sshd odmawia odczytu authorized_keys, jeśli ten plik, katalog .ssh lub katalog domowy konta mogą być zapisywane przez kogokolwiek innego niż właściciel, albo jeśli należą do niewłaściwego konta. Powód jest bezpośredni: jeśli grupa lub inni użytkownicy mają uprawnienia do zapisu w katalogu domowym, każde konto z takim dostępem może podmienić authorized_keys i przejąć logowanie. sshd traktuje niezaufaną ścieżkę tak, jakby klucz nie istniał.

Klient otrzymuje zwykły komunikat Permission denied. Dziennik serwera rejestruje rzeczywistą przyczynę:

Authentication refused: bad ownership or modes for directory /home/deploy/.ssh

lub, gdy problemem jest sam plik:

Authentication refused: bad ownership or modes for file /home/deploy/.ssh/authorized_keys

Co sshd zaakceptuje:

  • Katalog domowy: brak uprawnień do zapisu dla grupy i innych użytkowników. 755, 750 oraz 700 przechodzą weryfikację. 775 oraz 777 kończą się niepowodzeniem.
  • ~/.ssh: ta sama zasada. Podręcznik sshd zaleca dostęp wyłącznie dla właściciela, co odpowiada trybowi 700.
  • ~/.ssh/authorized_keys: ta sama zasada, musi to być zwykły plik. Jeśli tak nie jest, dziennik wskazuje ścieżkę is not a regular file. Podręcznik zaleca odczyt i zapis wyłącznie dla właściciela, co odpowiada trybowi 600.
  • Własność: każdy element musi należeć do konta, na które następuje logowanie, lub do root. Każdy inny właściciel powoduje niepowodzenie weryfikacji.

Własność jest równie ważna jak tryb. sshd odczytuje authorized_keys jako konto logowania, więc plik utworzony za pomocą sudo nano i nieprzekazany z powrotem pozostaje własnością root z trybem 600. Przechodzi on weryfikację własności, ale sshd nie może go otworzyć, a dziennik raportuje błąd otwarcia pliku. Należy naprawić oba parametry jednocześnie:

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/.ssh

Ostatnie polecenie pokazuje wynik. Wymagane jest drwxr-xr-x lub bardziej restrykcyjne dla katalogu domowego oraz drwx------ dla .ssh. Jeśli te ciągi znaków nie są jeszcze zrozumiałe, należy przeczytać jak interpretować ciąg uprawnień typu drwxr-xr-x przed zmianą trybów na działającym serwerze.

W systemach Rocky Linux i AlmaLinux należy dodać SELinux (Security-Enhanced Linux) do listy podejrzanych. Katalog .ssh utworzony w nietypowy sposób może posiadać niewłaściwą etykietę pliku, przez co sshd otrzymuje odmowę dostępu do odczytu, mimo że tryby wyglądają na poprawne. sudo restorecon -Rv /home/deploy/.ssh przywraca etykiety, a sudo ausearch -m avc -ts recent pokazuje, czy to SELinux był komponentem odmawiającym dostępu.

Przyczyna 5: konfiguracja sshd odrzuca połączenie

Samo odczytanie /etc/ssh/sshd_config w nowoczesnych systemach Ubuntu lub Debian jest niewystarczające. Plik ten zaczyna się od Include /etc/ssh/sshd_config.d/*.conf, a OpenSSH przyjmuje pierwszą napotkaną wartość dla każdego ustawienia. Plik typu drop-in, taki jak 50-cloud-init.conf, jest odczytywany przed resztą głównego pliku i ma pierwszeństwo przed każdym ustawieniem globalnym edytowanym w dalszej części. Wyjątkiem jest blok Match: dokumentacja sshd_config wskazuje, że ustawienia wewnątrz bloku nadpisują te z sekcji globalnej. Zatem pasujący blok Match, nawet umieszczony na końcu głównego pliku, ma pierwszeństwo przed plikami drop-in dla połączeń, które spełniają jego warunki. Pliki drop-in są odczytywane w porządku leksykograficznym, więc plik o nazwie 00-something.conf jest czytany przed 50-cloud-init.conf, a pierwsze wystąpienie danej wartości wygrywa. Dlatego edycja może wyglądać na poprawną, nie zmieniając niczego w działaniu serwera.

Należy sprawdzić efektywną konfigurację, którą sshd buduje na podstawie wszystkich plików:

sudo sshd -T | grep -Ei 'pubkeyauth|authorizedkeysfile|permitrootlogin|allowusers|allowgroups|denyusers'

sshd -T uruchamia nowy proces testowy, który odczytuje pliki w ich aktualnym stanie na dysku. Nie odpytuje on działającego procesu sshd, więc zmiany, które nie zostały jeszcze zastosowane przez restart, będą widoczne tutaj, zanim serwer zacznie je uwzględniać.

Poprawna odpowiedź wygląda następująco:

permitrootlogin prohibit-password
pubkeyauthentication yes
authorizedkeysfile .ssh/authorized_keys .ssh/authorized_keys2

Na co należy zwrócić uwagę w danych wyjściowych:

  • pubkeyauthentication no. Żaden klucz nie zostanie zaakceptowany. Pojawia się to również w ssh -v jako pierwsza lista Authentications that can continue: bez żadnego publickey.
  • authorizedkeysfile wskazujące na inną lokalizację, na przykład /etc/ssh/authorized_keys/%u. Plik w katalogu domowym jest wtedy całkowicie ignorowany, a zasady uprawnień z przyczyny 4 dotyczą nowej ścieżki.
  • Obecność allowusers lub allowgroups. Każde konto, którego nie ma na liście, jest odrzucane z tym konkretnym błędem bez dodatkowych wyjaśnień. denyusers oraz denygroups działają analogicznie w drugą stronę.
  • permitrootlogin no podczas próby logowania jako root. prohibit-password jest użytecznym ustawieniem pośrednim: root może użyć klucza, ale nie hasła.

Bloki Match nie pojawiają się w zwykłym sshd -T, ponieważ ich wynik zależy od tego, kto się łączy. Należy sprawdzić konkretne połączenie:

sudo sshd -T -C user=deploy,host=vps.example.com,addr=198.51.100.7

Jeszcze jedno ustawienie wpływa na starsze klucze. OpenSSH 8.8 przestało domyślnie akceptować podpisy SHA-1 (ssh-rsa). Klucz RSA, który działał przez lata, może przestać działać po aktualizacji jednej ze stron, jeśli druga strona jest zbyt stara, by użyć RSA z SHA-256. Aktualny klient łączący się z takim starym serwerem informuje o tym wprost:

debug1: send_pubkey_test: no mutual signature algorithm

Sam klucz jest zazwyczaj poprawny. Informacje o wydaniu OpenSSH 8.8 wskazują, że nie ma potrzeby wymiany kluczy ssh-rsa, ponieważ system przełącza się na RSA/SHA-256 lub RSA/SHA-512, gdy obie strony to obsługują. Aktualizacja starej strony jest trwałym rozwiązaniem. Jeśli aktualizacja nie jest możliwa, nowy klucz również zadziała, o ile stara strona korzysta z OpenSSH 6.5 lub nowszego (wersja ta wprowadziła Ed25519, podczas gdy RSA z SHA-256 pojawiło się dopiero w 7.2): ssh-keygen -t ed25519 -C "deploy@vps-prod", a następnie należy zainstalować plik .pub zgodnie z powyższym opisem. Strona starsza niż 6.5 nie obsługuje ani Ed25519, ani RSA z SHA-256, więc nowy klucz Ed25519 nie pomoże. Ustawienie PubkeyAcceptedAlgorithms +ssh-rsa po zaktualizowanej stronie (w bloku Host pliku ~/.ssh/config klienta lub w konfiguracji sshd serwera) przywraca stare podpisy i umożliwia dostęp, jednak należy to traktować jako tymczasowy sposób na uzyskanie dostępu, a nie jako docelowe rozwiązanie. Pozostałe ustawienia serwera warte przejrzenia znajdują się w zabezpieczanie serwera SSH na VPS.

Jak zweryfikować zgodność klucza prywatnego z zainstalowanym kluczem publicznym

Większość domysłów w przypadku tego błędu wynika z braku pewności, czy dwa pliki stanowią parę. Jedno polecenie pozwala to rozstrzygnąć:

ssh-keygen -y -f ~/.ssh/vps-prod

Polecenie to wypisuje klucz publiczny wygenerowany na podstawie klucza prywatnego. Nie odczytuje ono pliku .pub znajdującego się obok, dzięki czemu wskazuje rzeczywistą zawartość klucza prywatnego, a nie to, co sugeruje nieaktualny plik .pub. Jeśli klucz jest zabezpieczony hasłem, polecenie poprosi o jego podanie, co jednocześnie potwierdza znajomość tego hasła.

ssh-keygen -lf ~/.ssh/vps-prod.pub
ssh-add -l

Pierwsze polecenie wyświetla odcisk palca (fingerprint) pliku klucza publicznego. Drugie wyświetla odciski palców przechowywane w agencie. Należy teraz zestawić cztery widoki tego samego ciągu znaków: odcisk palca w linii Offering public key z pliku ssh -v, odcisk palca pliku .pub, odciski palców w ssh-keygen -lf na serwerze w pliku authorized_keys oraz odcisk palca w dzienniku serwera. Miejsce, w którym przestają się one zgadzać, wskazuje źródło błędu.

Odczyt dziennika serwera podczas nieudanego logowania

Klient celowo nie otrzymuje użytecznych informacji. Serwer zapisuje rzeczywistą przyczynę. Uruchom monitorowanie dziennika w sesji konsoli, a następnie wykonaj nieudaną komendę ssh ze swojego laptopa.

sudo journalctl -u ssh -f

Standardowy obraz serwerowy Ubuntu 24.04 instaluje rsyslog domyślnie (manifest pakietów wymienia go na dzień 3 listopada 2026), więc te same rekordy trafiają również do /var/log/auth.log. Minimalne obrazy chmurowe Ubuntu 24.04 są dostarczane bez rsyslog, więc domyślnie nie istnieje tam auth.log i należy sprawdzać dziennik systemd. W systemach Rocky Linux oraz AlmaLinux jednostka nosi nazwę sshd, a te same rekordy trafiają do /var/log/secure.

Ustaw LogLevel VERBOSE w konfiguracji sshd i przeładuj usługę. Każda próba logowania spowoduje zapisanie w dzienniku odcisku klucza, który faktycznie otrzymał serwer:

Failed publickey for deploy from 198.51.100.7 port 49812 ssh2: ED25519 SHA256:0eL/8sBw...

Ten wiersz wskazuje, po której stronie leży przyczyna błędu. Rozpoznawalny odcisk oznacza, że klucz dotarł do serwera, ale został odrzucony, więc należy sprawdzić przyczyny 3, 4 i 5. Nierozpoznawalny odcisk oznacza, że klient wysłał inny klucz niż zamierzony, więc należy wrócić do przyczyny 2.

Jeśli dziennik nadal nie jest jasny, uruchom drugą instancję sshd na innym porcie w trybie debugowania. Pozostaje ona na pierwszym planie, obsługuje jedno połączenie, wypisuje powód decyzji, a następnie kończy działanie:

sudo /usr/sbin/sshd -ddd -p 2222

Z sesji konsoli na tym samym serwerze połącz się z nim przez adres pętli zwrotnej:

ssh -p 2222 -i ~/.ssh/vps-prod -o IdentitiesOnly=yes deploy@127.0.0.1

Użycie 127.0.0.1 eliminuje sieć między użytkownikiem a serwerem z testu. Ruch na pętli zwrotnej nadal przechodzi przez filtr pakietów jądra, ale w systemie Ubuntu domyślne reguły ufw akceptują wszystko na interfejsie lo, więc port 2222 nie wymaga własnej reguły zapory, chyba że domyślne ustawienia zostały usunięte. Dane wyjściowe trybu debugowania wskazują otwarty plik, porównany odcisk klucza oraz dokładną przyczynę odmowy, w tym wiersze takie jak Authentication refused: bad ownership or modes for directory /home/deploy. Po uzyskaniu odpowiedzi naciśnij Ctrl+C. Główny proces sshd na porcie 22 pozostaje w tym czasie nienaruszony.

Jak uniknąć utraty dostępu do serwera

Każda operacja edycji konfiguracji serwera wymaga zapewnienia alternatywnej metody dostępu, która nie polega na SSH. Należy ją skonfigurować, gdy SSH jeszcze działa, a nie po wystąpieniu awarii.

  1. Otwórz konsolę dostawcy przez port szeregowy lub VNC (virtual network computing) i potwierdź możliwość zalogowania się.
  2. Upewnij się, że znasz działające hasło lokalne dla konta z uprawnieniami sudo. Jeśli go nie posiadasz, najpierw zresetuj hasło root z poziomu konsoli dostawcy.
  3. Pozostaw bieżącą sesję SSH otwartą. Otwarta sesja przetrwa systemctl restart ssh, więc pozostanie drogą powrotu, jeśli nowa konfiguracja okaże się błędna.
  4. Sprawdź składnię przed restartem: sudo sshd -t nie wyświetla żadnych komunikatów, gdy plik jest poprawny, a w przeciwnym razie wskazuje plik oraz numer linii z błędem.
  5. Otwórz drugi terminal i zaloguj się ponownie przed zamknięciem pierwszego. Błędna konfiguracja blokuje nowe logowania, ale nie przerywa istniejących, więc sesja, w której pracujesz, nie potwierdzi poprawności wprowadzonych zmian.

Zrestartuj usługę za pomocą sudo systemctl restart ssh w systemach Debian i Ubuntu lub sudo systemctl restart sshd w systemach Rocky Linux i AlmaLinux. W systemie Ubuntu 24.04 usługa sshd jest uruchamiana z jednostki typu socket, której port i adres pochodzą z sshd_config za pośrednictwem generatora systemd, dlatego zmiana w Port lub ListenAddress wymaga również wykonania sudo systemctl daemon-reload, a następnie sudo systemctl restart ssh.socket, aby zmiany weszły w życie.

FAQ

Dlaczego otrzymuję błąd Permission denied (publickey), skoro ten sam klucz działa na innym serwerze?

Ponieważ klucz jest poprawny, a problem leży w jego otoczeniu. Uruchom ssh -v i znajdź linię Offering public key lub Trying private key dla swojego klucza. Jeśli klucza nie ma w żadnej z nich, ssh nigdy go nie wysłało: plik nie znajduje się w ~/.ssh pod domyślną nazwą i nie jest załadowany do agenta, więc dodaj go za pomocą -i /path/to/key -o IdentitiesOnly=yes. Jeśli klucz jest wymieniony, a serwer nadal odmawia dostępu, oznacza to, że klucz nie znajduje się w pliku authorized_keys na koncie, ścieżka do niego jest zapisywalna przez grupę lub konfiguracja sshd blokuje użytkownika. Dziennik serwera pozwala rozróżnić te przypadki.

Jak sprawdzić, który klucz jest faktycznie wysyłany przez SSH?

ssh -v host wyświetla linię debug1: Offering public key: dla każdego klucza, którego część publiczną już posiada, wraz z typem klucza i odciskiem SHA256. Klucz odczytany z pliku wskazuje nazwę tego pliku, podczas gdy klucz przechowywany tylko w agencie pokazuje swój komentarz, a agent na końcu linii oznacza klucze dostarczone przez agenta. Jeśli następną linią jest send_pubkey_test: no mutual signature algorithm, oznacza to, że klucz ostatecznie nie został wysłany. Klucz, którego części publicznej ssh nie mogło odczytać z wyprzedzeniem, nie otrzymuje linii Offering: ssh wyświetla Trying private key: z nazwą pliku, ładuje klucz prywatny i bezpośrednio wysyła podpisane żądanie. ssh-add -l wypisuje odciski kluczy przechowywane przez agenta. ssh-keygen -lf ~/.ssh/id_ed25519.pub drukuje odcisk pojedynczego pliku klucza, a ssh-keygen -y -f ~/.ssh/id_ed25519 drukuje klucz publiczny, który faktycznie wywodzi się z klucza prywatnego. Aby logowanie powiodło się, odcisk wysłanego klucza musi również pojawić się w ssh-keygen -lf uruchomionym względem pliku authorized_keys na serwerze.

Dlaczego sshd ignoruje mój plik authorized_keys?

Ponieważ StrictModes jest domyślnie włączone, a plik, katalog .ssh lub katalog domowy są zapisywalne przez grupę lub wszystkich, albo ich właścicielem jest konto inne niż użytkownik lub root. sshd nie ufa ścieżce, którą ktoś inny może zmienić, więc zachowuje się tak, jakby klucz nie istniał. Kontrola wymaga, aby żaden z tych trzech elementów nie był zapisywalny przez grupę lub innych użytkowników, aby każdy z nich był własnością konta logowania lub roota oraz aby authorized_keys był zwykłym plikiem, więc samo usunięcie uprawnień do zapisu nie zawsze wystarcza. 755 lub bardziej restrykcyjne uprawnienia dla katalogu domowego, 700 dla .ssh oraz 600 dla authorized_keys, przy zachowaniu własności konta logowania, to bezpieczna konfiguracja. Dzięki LogLevel VERBOSE serwer rejestruje Authentication refused: bad ownership or modes for directory /home/deploy/.ssh.

Mój klucz przestał działać zaraz po aktualizacji serwera. Co się zmieniło?

Jeśli jest to klucz RSA, najprawdopodobniej chodzi o zmianę dotyczącą SHA-1. OpenSSH 8.8 domyślnie wyłączyło podpisy ssh-rsa SHA-1, więc klucz RSA jest odrzucany, gdy druga strona może go użyć tylko w ten sposób. Bieżący klient wyświetla debug1: send_pubkey_test: no mutual signature algorithm. Klucz nie wymaga wymiany, jeśli można zaktualizować starszą stronę, ponieważ klucze RSA używają SHA-256 lub SHA-512 wszędzie tam, gdzie obie strony to obsługują. Jeśli nie jest to możliwe, a starsza strona używa OpenSSH 6.5 lub nowszego, wygeneruj nowoczesny klucz za pomocą ssh-keygen -t ed25519 i zainstaluj jego plik .pub. Strona starsza niż 6.5 nie obsługuje ani Ed25519, ani RSA z SHA-256, więc nowy klucz nie rozwiąże tego przypadku. Jeśli potrzebujesz natychmiastowego dostępu, PubkeyAcceptedAlgorithms +ssh-rsa po zaktualizowanej stronie ponownie włącza stare podpisy; należy usunąć tę linię po wprowadzeniu trwałej poprawki.

Edytowałem sshd_config i teraz w ogóle nie mogę się zalogować. Jak odzyskać dostęp?

Użyj konsoli dostarczonej przez dostawcę, która nie korzysta z SSH. Zaloguj się tam za pomocą lokalnego hasła, uruchom sudo sshd -t, aby zobaczyć błąd składni i numer linii, cofnij zmianę i zrestartuj usługę. Następnie uruchom sudo sshd -T, aby zobaczyć efektywne wartości, które obecnie generują pliki, ponieważ plik w /etc/ssh/sshd_config.d/ może nadpisywać główną konfigurację. Polecenie to odczytuje pliki na nowo, zamiast pytać działający proces sshd, więc po każdej kolejnej edycji zrestartuj usługę przed ponownym testowaniem logowania. Jeśli nie masz lokalnego hasła, najpierw zresetuj hasło roota z poziomu konsoli, a następnie napraw plik.

Czy ten artykuł był przydatny?