Deep Dive: fail2ban – od linii w logu do wpisu w secie jądra i bany, których nigdy nie było

Jak fail2ban zamienia linie logów w bany, jak ten setup karmi go rotującymi logami kontenerów i zapisuje bany prosto do setów nftables – oraz trzy przypadki, w których fail2ban zgłosił bana, którego firewall nigdy nie wyegzekwował.

Ilustracja do serii Deep Dive

🌐 Także w: English · Deutsch · Français · Español · Italiano · Português · Nederlands

Deep Dive z serii wokół Ansible Tour. Tour objaśnia role, deep dive’y technologię pod spodem: jak działa, dlaczego jest tu używana właśnie tak i co po drodze poszło nie tak.

fail2ban wygląda na najprostsze narzędzie na tych serwerach: przeczytaj log, policz nieudane próby, zbanuj adres. Na hoście K3s każda część tego zdania ma swój haczyk. Logi leżą w plikach kontenerów, które zmieniają nazwę przy każdym restarcie; bany muszą trafić do firewalla, do którego piszą też inne programy; a rodzina adresów, której nikt nie przetestował, potrafi zamienić całość w placebo. Ten wpis śledzi jedno złośliwe żądanie od linii w logu aż do wpisu w jądrze, wyjaśnia to, co część 5 touru tylko muska – i opisuje trzy przypadki, w których fail2ban powiedział “Ban”, a firewall i tak wpuścił adres.

Spis treści

🧭 Jak działa fail2ban

Jaile, filtry, akcje

Jail łączy trzy rzeczy: log do obserwowania, filtr, który rozpoznaje złą linię, i akcję, która banuje. Filtr to zestaw wyrażeń regularnych (failregex, z ignoreregex dla wyjątków), w których <HOST> oznacza adres. Każde dopasowanie to porażka dla tego adresu. Jeśli adres uzbiera maxretry porażek w ciągu findtime, akcja się uruchamia i banuje go na bantime.

Backendy: jak czytany jest log

  • systemd czyta journal bezpośrednio (filtrowany po unicie) – solidnie, bez plików, bez rotacji. Używany tu dla sshd.
  • polling co kilka sekund sprawdza plik pod kątem nowej treści. Prosty, działa na każdym systemie plików – i jest jedyną opcją, gdy ścieżka to zmieniający się glob.
  • pyinotify reaguje natychmiast na zdarzenia plików; szybszy, ale obserwuje pliki, które istniały w momencie startu jaila.

Znacznik czasu jest równie ważny jak adres: fail2ban parsuje datę każdej linii (datepattern) i ignoruje linie starsze niż findtime. Filtr ze złym formatem daty nie dopasowuje niczego – po cichu.

Baza danych i recidive

fail2ban przechowuje aktualne bany w bazie SQLite (/var/lib/fail2ban/fail2ban.sqlite3). Po restarcie ponownie nakłada każdy ban, który jeszcze nie wygasł. Jail recidive obraca fail2bana przeciwko niemu samemu: jego logiem jest fail2ban.log, filtr liczy linie “Ban”, a kto zostanie zbanowany trzy razy w ciągu dnia, dostaje bana na 30 dni na wszystkich portach.

🛡️ Po co tu jest

  • Tania ochrona przed zautomatyzowanymi atakami na SSH, logowanie WordPressa, logowanie Nextclouda i Grafanę – oraz przed skanerami, które przechodzą przez listy znanych podatnych ścieżek.
  • Bany w jądrze, nie w aplikacji. Zbanowany adres nie dociera do niczego, nawet do handshake’u TLS.
  • Widoczność. Kto puka, jak często i do których drzwi – to wszystko jest w logu banów, od października 2026 przeszukiwalnym w Loki.

🔧 Co robi to repozytorium

Siedem jaili, dwa źródła logów

JailLogRegułaBan
sshdjournal (backend systemd)3 porażkidomyślnie 1 h
nginx-k3s-wp-loginlog ingressu10 POST-ów na /wp-login.php w 10 min1 h
nginx-k3s-nc-loginlog ingressu10 POST-ów na /login Nextclouda w 10 min1 h
nginx-k3s-grafana-loginlog ingressu5 nieudanych logowań do Grafany (HTTP 401) w 10 min1 h
nginx-k3s-scannerlog ingressu20 odpowiedzi 403 lub 404 w 1 min1 h
nginx-k3s-bad-pathslog ingressu2 żądania ścieżek, które tu nigdy nie istnieją (/.env, /.git/, /phpmyadmin, web shelle …) w 1 h24 h
recidivefail2ban.logzbanowany 3 razy w ciągu dnia30 dni

Wszystkie jaile HTTP czytają access log kontrolera ingress – jedynego miejsca, przez które przechodzi każde żądanie, zarówno do bloga, jak i do Nextclouda. Filtry oczekują prefiksu containerd przed każdą linią (2026-06-19T14:24:11Z stdout F <client> - - [time] "POST /wp-login.php …"); filtr napisany pod zwykły log nginx nigdy by niczego nie dopasował.

Ban trafia prosto do nftables

fail2ban nie dostaje własnej tabeli ani chaina. Jego akcja dodaje adres do setu, który firewall sprawdza na samej górze swojego input chaina – każdy jail do własnej pary f2b_<jail>4/6 (dlaczego – patrz piąty bug poniżej).

Każdy element ma własny timeout, więc ban wygasa w jądrze, nawet jeśli fail2ban w międzyczasie padł. Unban to tylko sprzątanie na zasadzie best effort.

Plik logu, który się przesuwa

Log ingressu to nie jeden plik. To /var/log/pods/<namespace>_<pod>_<uid>/nginx-ingress/N.log, a zmieniają się zarówno katalog poda, jak i numer: restart kontenera zapisuje 1.log po 0.log, nowy pod dostaje nowy katalog. fail2ban rozwija glob w logpath raz, przy starcie jaila. Mały timer (fail2ban-ingress-logwatch, co dwie minuty) porównuje aktualną listę plików z poprzednią i przeładowuje jaile nginx-k3s-*, gdy się różni. Bez niego – patrz pierwszy bug poniżej.

🐛 Trzy razy, kiedy fail2ban powiedział “Ban” i nic się nie stało

1. Dni wpatrywania się w martwy plik

23 września 2026 okazało się, że jaile HTTP na obu serwerach Nextcloud od dni niczego nie zbanowały. Po reboocie fail2ban wystartował przed kontenerem ingressu, a po restarcie kontenera jaile dalej śledziły plik, do którego nie trafiały już żadne linie. Wszystko wyglądało zdrowo – usługa działała, jaile były na liście, nigdzie żadnego błędu. Opisany wyżej timer log-watch jest poprawką. To też jeden z powodów, dla których Monit sprawdza teraz, czy każdy oczekiwany jail jest aktywny (historia watchdoga zaczęła się od tego, że fail2ban po cichu nie żył przez dwa dni).

Wniosek: Jail, który działa, to jeszcze nie jail, który czyta. Od tego czasu timer przeładowuje jaile HTTP, gdy tylko zmieni się plik logu ingressu, a Monit sprawdza, czy każdy jail obserwuje plik, który istnieje.

2. Przeładowanie firewalla, które opróżniło sety banów

Firewall przy każdym przeładowaniu podmienia własną tabelę – a razem z nią sety, puste. fail2ban trzymał swoje bany w bazie i wierzył, że są aktywne. 30 września 2026, po przebiegu playbooka, 15 z 17 banów na jednym serwerze i 17 z 24 na drugim istniało tylko w fail2banie. Handler firewalla restartuje teraz fail2bana natychmiast po każdym przeładowaniu, a fail2ban ponownie nakłada każdy niewygasły ban.

Wniosek: Bany, które istnieją tylko w bazie fail2bana, niczego nie chronią. Po każdym przeładowaniu firewalla handler restartuje fail2bana, a Monit porównuje bany z setami.

3. Bany IPv6, które nigdy nie były możliwe

Do 14 października 2026 każdy jail przekazywał akcji nftset = banned4 – także dla adresów IPv6. nft odmawiał wstawienia adresu IPv6 do setu IPv4 (“Address family for hostname not supported”), fail2ban i tak logował bana, a adres nigdy nie był blokowany. Na wszystkich trzech serwerach. Wspomniana wyżej sekcja [Init?family=inet6] wybiera set według rodziny adresów; w tygodniu do 20 października 2026 15 z 444 banów dotyczyło adresów IPv6 – niewiele, ale każdy z nich wcześniej przeszedłby jak przez otwarte drzwi.

Wniosek: fail2ban loguje „Ban” nawet wtedy, gdy akcja się nie powiedzie. Czy adres jest naprawdę zablokowany, pokazuje dopiero nft list set.

Czwarty, znaleziony przez Loki

Kiedy 19 października 2026 logi trafiły do Loki, nowy alert na błędy fail2bana odpalił od razu. Większość błędów była niegroźna (KeyError na logu poda, który właśnie usunięto – backend polling gubi plik, jail działa dalej). Ale 13 i 14 października były prawdziwe: Failed to execute ban jail 'nginx-k3s-bad-paths' action 'nftables…' – bany, które nie doszły do skutku, kiedy przerabiano przeładowanie firewalla. Nikt ich nie zauważył, bo fail2ban nie wysyła maili o własnych błędach. Alert teraz to robi, z pominięciem znanego niegroźnego wzorca.

Piąty: jeden set dla wszystkich jaili

Do 21 października 2026 wszystkie jaile pisały do tej samej pary setów banned4/6. Wygląda schludnie i ma haczyk: adres zbanowany przez dwa jaile istnieje w secie tylko raz. Kiedy krótszy ban się kończył – powiedzmy jail scanner po dniu – adres wypadał z setu, choć recidive nadal chciał go trzymać z daleka przez 30 dni. fail2ban pokazywał go jako zbanowany; jądro już nie. Porównanie z tamtego dnia znalazło od jednego do pięciu takich adresów na serwer. Od tego czasu każdy jail ma własną parę (f2b_sshd4, f2b_recidive4, …) i tylko tam dodaje i usuwa, a check Monita (f2b_sets) regularnie porównuje listę fail2bana z setami.

Wniosek: Jeden set współdzielony przez bany różnej długości gubi ten dłuższy. Dlatego każdy jail ma własną parę setów.

Szósty: filtr, który nigdy nie dopasował

26 października 2026 nowy test podał każdemu filtrowi linię logu w dzisiejszym formacie. Filtr Nextclouda nie rozpoznał swojej linii: szukał POST /login, ale Nextcloud wysyła formularz logowania na /index.php/login, dopóki nie ustawiono htaccess.RewriteBase. Od lipca jail na obu serwerach Nextcloud nie policzył ani jednej próby logowania, a rate limit w ingressie, który też znał tylko /login, również tych żądań nie spowalniał. Filtr i ingress znają teraz obie ścieżki; w bieżącym logu nowy filtr znalazł 15 prób, stary 0. Test od tamtej pory jedzie przy każdym przebiegu playbooka: sprawdza każdy filtr na przykładowej linii, banuje w każdym jailu adres z zakresów dokumentacyjnych (192.0.2.0/24, 2001:db8::/32), sprawdza set i znosi bana z powrotem.

Wniosek: Sprawdzenie, że usługa działa, nie wystarczy. Trzeba dać jej prawdziwe dane wejściowe i spojrzeć na wynik.

📊 Co banuje

Jeden tydzień, 14–20 października 2026, wszystkie trzy serwery:

JailBlogNextcloud ANextcloud B
nginx-k3s-bad-paths1077474
nginx-k3s-scanner635047
sshd9211
recidive42–
nginx-k3s-wp-login1––
Udział IPv611 z 1842 z 1282 z 132

Obraz jest jasny: prawie wszystkie bany pochodzą od skanerów szukających plików .env, katalogów Git, paneli admina i web shelli. Prawdziwe ataki na logowanie są rzadkie – logowanie WordPressa zobaczyło dwa POST-y w trzy godziny w dniu, w którym analizowano logi, a od 19 października 2026 /wp-login.php i tak odpowiada tylko adresom z listy krajów. Banów SSH jest mało, bo port 10022 przyjmuje tylko niemieckie zakresy adresów; zostaje kilka adresów z wnętrza tego zakresu.

Kiedy jail nie reaguje

  1. Czy obserwuje właściwy plik? get <jail> logpath kontra ls /var/log/pods/… – po restarcie kontrolera ingress timer log-watch powinien go przeładować w ciągu dwóch minut.
  2. Czy filtr w ogóle dopasowuje? fail2ban-regex na prawdziwym pliku. Zmiana formatu linii po aktualizacji ingressu wyjdzie tutaj.
  3. Czy data jest rozumiana? Linie starsze niż findtime są ignorowane; zły datepattern sprawia, że każda linia jest “stara”.
  4. Czy ban dociera do jądra? Porównaj status z nft list set. Jeśli się różnią, szukaj w fail2ban.log frazy “Failed to execute ban” – albo w Loki: {job="fail2ban"} |= "ERROR".

Nie testuj z własnego jump hosta

Kusi, żeby raz zażądać /.env i zobaczyć, czy jail bad-paths działa. Dwa żądania w ciągu godziny banują adres na 24 godziny – razem z jump hostem, a więc i każdą sesją SSH do tego serwera. Zakresy prywatne są w ignoreip, publiczny adres sieci administracyjnej – nie. Testuj przez fail2ban-regex na linii logu albo z adresu, który możesz stracić na jeden dzień.

🆘 Ściąga: objaw → polecenie

Krótka wersja tego artykułu na moment, gdy coś jest nie tak. Uruchamiaj na hoście jako root; <…> to placeholdery.

ObjawPolecenie
Jail niczego nie banujefail2ban-client status <jail>
fail2ban-client get <jail> logpath
Filtr nie dopasowujefail2ban-regex <logfile> /etc/fail2ban/filter.d/<filter>.conf
Zbanowany, a wciąż przechodzinft get element inet filter f2b_<jail>4 '{ <ip> }' # "No such file" = not in the set
monit status f2b_sets
Do którego setu pisze jail?fail2ban-client get <jail> action nftables-banned-sets setname
Zdjęcie banafail2ban-client unban <ip>
Czy jakiś ban się nie udał?grep -E "ERROR|Failed to execute" /var/log/fail2ban.log | tail
Loki: {job="fail2ban"} |= "ERROR"
fail2ban stoi albo brakuje jailasystemctl status fail2ban
monit status f2b_jails
Sety puste po przeładowaniu firewallasystemctl restart fail2ban # re-applies every active ban
Sam się zablokowałeś# from another address or the provider console:
fail2ban-client unban <your-ip>

🎯 Wnioski

  • Testuj filtr na prawdziwej linii logu w dzisiejszym formacie, nie tylko jego składnię.
  • „Ban” w logu nie znaczy „zablokowany”: prawdą jest set w jądrze.
  • Bany różnej długości potrzebują osobnych setów.
  • Pliki logów kontenerów się przesuwają; jail musi przesuwać się razem z nimi.
  • Nigdy nie testuj podejrzanych ścieżek z własnego jump hosta.

⚖️ Alternatywy – i dlaczego fail2ban

OpcjaMocna stronaDlaczego nie tutaj
CrowdSecWspółdzielone blocklisty społeczności, scenariusze, bounceryWięcej ruchomych części (agent, lokalne API, bouncer) i dane współdzielone z zewnętrzną usługą.
sshguardMały, szybki, skupiony na SSHDobrze pokrywa SSH, jaile HTTP już słabiej.
Tylko rate limity w ingressieChroni HTTP bez dodatkowego demonaSpowalnia atakujących, ale nigdy ich nie banuje, i nic nie daje dla SSH. Używane dodatkowo (szukaj: rate limit).
fail2banDziała z każdym logiem, skryptowalne akcje, dojrzałyWybrany – z trzema powyższymi lekcjami wbudowanymi w środek.

fail2ban jest stary, prosty i robi dokładnie to, co obiecuje. Praca nigdy nie polegała na samym narzędziu; polegała na upewnieniu się, że każde “Ban” w jego logu kończy się też wpisem w jądrze. Od października 2026 jest to sprawdzane – przez handler firewalla, przez Monita i przez alert w logach – zamiast zakładane.

Część tekstów i obrazów na tej stronie powstała z pomocą AI lub została wygenerowana przez AI. Szczegóły