Deep Dive: fail2ban – van een logregel naar een entry in een kernel-set, en de bans die nooit gebeurden

Hoe fail2ban logregels in bans omzet, hoe deze setup het voedt met roterende containerlogs en de bans direct in nftables-sets schrijft – en drie gevallen waarin fail2ban een ban meldde die de firewall nooit afdwong.

Illustratie bij de Deep Dive-serie

🌐 Ook in: English · Deutsch · Français · Español · Italiano · Português · Polski

Deep Dive in de serie rond de Ansible Tour. De tour legt de roles uit, de deep dives de techniek eronder: hoe het werkt, waarom het hier zo wordt gebruikt en wat er onderweg misging.

fail2ban lijkt de simpelste tool op deze servers: log lezen, mislukkingen tellen, adres bannen. Op een K3s-host zit er aan elk deel van die zin een addertje. De logs staan in containerbestanden die bij elke restart van naam veranderen; de bans moeten terechtkomen in een firewall waar ook andere programma’s in schrijven; en een adresfamilie die niemand heeft getest kan het hele ding tot een placebo maken. Deze post volgt één kwaadaardige request van de logregel tot de entry in de kernel, legt uit wat deel 5 van de tour alleen aanstipt – en beschrijft drie gevallen waarin fail2ban “Ban” zei en de firewall het adres toch binnenliet.

Inhoud

🧭 Hoe fail2ban werkt

Jails, filters, actions

Een jail verbindt drie dingen: een log om in de gaten te houden, een filter dat een foute regel herkent en een action die bant. Het filter is een set reguliere expressies (failregex, met ignoreregex voor uitzonderingen) waarin <HOST> het adres markeert. Elke match is een mislukking voor dat adres. Verzamelt een adres maxretry mislukkingen binnen findtime, dan draait de action en bant het voor bantime.

Backends: hoe het log wordt gelezen

  • systemd leest het journal direct (gefilterd per unit) – robuust, geen bestanden, geen rotatie. Hier gebruikt voor sshd.
  • polling controleert het bestand om de paar seconden op nieuwe inhoud. Simpel, werkt op elk bestandssysteem – en de enige optie als het pad een glob is die verandert.
  • pyinotify reageert direct op file events; sneller, maar het bewaakt de bestanden die bestonden toen de jail startte.

De timestamp is net zo belangrijk als het adres: fail2ban parseert de datum van elke regel (datepattern) en negeert regels die ouder zijn dan findtime. Een filter met het verkeerde datumformaat matcht niets, stilletjes.

De database en recidive

fail2ban slaat actuele bans op in een SQLite-database (/var/lib/fail2ban/fail2ban.sqlite3). Na een restart past het elke ban die nog niet verlopen is opnieuw toe. De recidive-jail keert fail2ban tegen zichzelf: het log is fail2ban.log, het filter telt “Ban”-regels, en wie drie keer op een dag gebannen wordt, wordt 30 dagen gebannen op elke poort.

🛡️ Waarom het hier staat

  • Goedkope bescherming tegen geautomatiseerde aanvallen op SSH, de WordPress-login, de Nextcloud-login en Grafana – en tegen scanners die lijsten met bekende kwetsbare paden aflopen.
  • Bans in de kernel, niet in de applicatie. Een gebannen adres bereikt helemaal niets, zelfs de TLS-handshake niet.
  • Zichtbaarheid. Wie er aanklopt, hoe vaak en bij welke deur staat in het banlog – sinds oktober 2026 doorzoekbaar in Loki.

🔧 Wat deze repository doet

Zeven jails, twee logbronnen

JailLogRegelBan
sshdjournal (systemd-backend)3 mislukkingenstandaard 1 u
nginx-k3s-wp-loginingress-log10 POSTs naar /wp-login.php in 10 min1 u
nginx-k3s-nc-loginingress-log10 POSTs naar de /login van Nextcloud in 10 min1 u
nginx-k3s-grafana-loginingress-log5 mislukte Grafana-logins (HTTP 401) in 10 min1 u
nginx-k3s-scanneringress-log20 antwoorden met 403 of 404 in 1 min1 u
nginx-k3s-bad-pathsingress-log2 requests naar paden die hier nooit bestaan (/.env, /.git/, /phpmyadmin, web shells …) in 1 u24 u
recidivefail2ban.log3 keer gebannen op één dag30 dagen

Alle HTTP-jails lezen het access log van de ingress controller, de enige plek waar elke request langskomt, voor blog en Nextcloud gelijk. De filters verwachten de containerd-prefix voor elke regel (2026-06-19T14:24:11Z stdout F <client> - - [time] "POST /wp-login.php …"); een filter geschreven voor een gewoon nginx-log zou nooit matchen.

De ban gaat direct naar nftables

fail2ban krijgt geen eigen table of chain. De action voegt het adres toe aan een set die de firewall helemaal bovenaan zijn input chain controleert – elke jail in een eigen paar f2b_<jail>4/6 (waarom: zie de vijfde bug hieronder).

Elk element heeft zijn eigen timeout, dus een ban verloopt in de kernel ook als fail2ban intussen is gestorven. De unban is alleen een best-effort opruimactie.

Het logbestand dat verhuist

Het ingress-log is niet één bestand. Het is /var/log/pods/<namespace>_<pod>_<uid>/nginx-ingress/N.log, en zowel de pod-directory als het nummer veranderen: een containerrestart schrijft 1.log na 0.log, een nieuwe pod krijgt een nieuwe directory. fail2ban expandeert de glob in logpath één keer, bij het starten van de jail. Een kleine timer (fail2ban-ingress-logwatch, elke twee minuten) vergelijkt de huidige lijst bestanden met de vorige en herlaadt de nginx-k3s-*-jails als die verschilt. Zonder die timer: zie de eerste bug hieronder.

🐛 Drie keer dat fail2ban “Ban” zei en er niets gebeurde

1. Dagenlang naar een dood bestand kijken

Op 23 september 2026 bleken de HTTP-jails op beide Nextcloud-servers al dagen niets te hebben gebannen. Na een reboot was fail2ban vóór de ingress-container gestart, en na een containerrestart bleven de jails een bestand volgen dat geen regels meer kreeg. Alles zag er gezond uit – de service draaide, de jails stonden in de lijst, nergens een fout. De hierboven beschreven log-watch-timer is de fix. Het is ook een van de redenen dat Monit nu controleert of elke verwachte jail actief is (het verhaal van de watchdog begon ermee dat fail2ban twee dagen lang stilletjes dood was).

De les: Een jail die draait is nog geen jail die leest. Sindsdien herlaadt een timer de HTTP-jails zodra het ingress-logbestand verandert, en controleert Monit dat elke jail een bestand bewaakt dat bestaat.

2. Een firewall-reload die de ban-sets leegmaakte

De firewall vervangt bij elke reload zijn eigen table – en daarmee de sets, leeg. fail2ban hield zijn bans in zijn database en dacht dat ze actief waren. Op 30 september 2026, na een playbook-run, bestonden 15 van 17 bans op de ene server en 17 van 24 op de andere alleen in fail2ban. De firewall-handler herstart fail2ban nu direct na elke reload, en fail2ban past elke nog niet verlopen ban opnieuw toe.

De les: Bans die alleen in de database van fail2ban bestaan, beschermen niets. Na elke firewall-reload herstart een handler fail2ban, en Monit vergelijkt de bans met de sets.

3. IPv6-bans die nooit mogelijk waren

Tot 14 oktober 2026 gaf elke jail nftset = banned4 door aan de action – ook voor IPv6-adressen. nft weigerde een IPv6-adres in een IPv4-set te zetten (“Address family for hostname not supported”), fail2ban logde de ban toch, en het adres werd nooit geblokkeerd. Op alle drie de servers. De sectie [Init?family=inet6] hierboven kiest de set op basis van adresfamilie; in de week tot 20 oktober 2026 waren 15 van de 444 bans IPv6-adressen – weinig, maar elk daarvan was er vroeger gewoon doorheen gelopen.

De les: fail2ban logt “Ban” ook als de action faalt. Of het adres echt geblokkeerd is, laat alleen nft list set zien.

Een vierde, gevonden door Loki

Toen de logs op 19 oktober 2026 naar Loki gingen, vuurde de nieuwe alert voor fail2ban-fouten meteen. De meeste fouten waren onschuldig (KeyError op een podlog dat net was verwijderd – de polling-backend die een bestand kwijtraakt, de jail gaat gewoon door). Maar op 13 en 14 oktober waren er echte: Failed to execute ban jail 'nginx-k3s-bad-paths' action 'nftables…' – bans die niet gebeurden terwijl de firewall-reload werd omgebouwd. Niemand had ze gezien, want fail2ban mailt zijn eigen fouten niet. De alert doet dat nu wel, minus het bekende onschuldige patroon.

Een vijfde: één set voor elke jail

Tot 21 oktober 2026 schreven alle jails in hetzelfde set-paar banned4/6. Dat ziet er netjes uit en heeft een addertje: een adres dat door twee jails gebannen is, bestaat maar één keer in de set. Als de kortere ban afliep – die van de scanner-jail na een dag, bijvoorbeeld – verliet het adres de set, hoewel recidive het nog 30 dagen buiten wilde houden. fail2ban noemde het gebannen; de kernel niet meer. Een vergelijking die dag vond één tot vijf van zulke adressen per server. Sindsdien heeft elke jail een eigen paar (f2b_sshd4, f2b_recidive4, …) en voegt alleen daar toe en verwijdert alleen daar, en een Monit-check (f2b_sets) vergelijkt regelmatig de lijst van fail2ban met de sets.

De les: Eén set die gedeeld wordt door bans van verschillende lengte verliest de langere. Daarom heeft elke jail een eigen set-paar.

Een zesde: een filter dat nooit matchte

Op 26 oktober 2026 voerde een nieuwe test elk filter een logregel in het huidige formaat. Het Nextcloud-filter herkende zijn regel niet: het zocht naar POST /login, maar Nextcloud stuurt zijn loginformulier naar /index.php/login zolang htaccess.RewriteBase niet is ingesteld. Sinds juli had de jail op beide Nextcloud-servers geen enkele loginpoging geteld, en de rate limit in de ingress, die ook alleen /login kende, had die requests evenmin afgeremd. Filter en ingress kennen nu beide paden; in het huidige log vond het nieuwe filter 15 pogingen, het oude 0. De test draait sindsdien bij elke playbook-run: hij controleert elk filter tegen een voorbeeldregel, bant in elke jail een adres uit de documentatieranges (192.0.2.0/24, 2001:db8::/32), controleert de set en heft de ban weer op.

De les: Controleren dat een service draait is niet genoeg. Je moet hem echte input geven en naar het resultaat kijken.

📊 Wat het bant

Eén week, 14 tot 20 oktober 2026, alle drie de servers:

JailBlogNextcloud ANextcloud B
nginx-k3s-bad-paths1077474
nginx-k3s-scanner635047
sshd9211
recidive42–
nginx-k3s-wp-login1––
Aandeel IPv611 van 1842 van 1282 van 132

Het beeld is duidelijk: bijna alle bans komen van scanners die zoeken naar .env-bestanden, Git-directories, adminpanelen en web shells. Echte loginaanvallen zijn zeldzaam – de WordPress-login zag twee POSTs in drie uur op de dag dat de logs werden geanalyseerd, en sinds 19 oktober 2026 antwoordt /wp-login.php sowieso alleen nog aan adressen uit de landenlijst. SSH-bans zijn laag omdat poort 10022 alleen Duitse adresranges accepteert; wat overblijft zijn een paar adressen van binnen die range.

Als een jail niet afgaat

  1. Bewaakt hij het juiste bestand? get <jail> logpath tegenover ls /var/log/pods/… – na een restart van de ingress controller had de log-watch-timer hem binnen twee minuten moeten herladen.
  2. Matcht het filter überhaupt? fail2ban-regex tegen het echte bestand. Een veranderd regelformaat na een ingress-upgrade komt hier naar boven.
  3. Wordt de datum begrepen? Regels ouder dan findtime worden genegeerd; een verkeerd datepattern maakt elke regel “oud”.
  4. Bereikt de ban de kernel? Vergelijk status met nft list set. Verschillen ze, zoek dan in fail2ban.log naar “Failed to execute ban” – of in Loki: {job="fail2ban"} |= "ERROR".

Test niet vanaf je eigen jump host

Eén keer /.env opvragen om te zien of de bad-paths-jail werkt, is verleidelijk. Twee requests binnen een uur bannen het adres voor 24 uur – de jump host inbegrepen, en daarmee elke SSH-sessie naar die server. De private ranges staan in ignoreip, het publieke adres van het beheernetwerk niet. Test met fail2ban-regex tegen een logregel, of vanaf een adres dat je een dag kunt missen.

🆘 Spiekbriefje: symptoom → commando

De korte versie van dit artikel voor het moment dat er iets mis is. Uitvoeren op de host als root; <…> zijn placeholders.

SymptoomCommando
Een jail bant nietsfail2ban-client status <jail>
fail2ban-client get <jail> logpath
Het filter matcht nietfail2ban-regex <logfile> /etc/fail2ban/filter.d/<filter>.conf
Gebannen, maar komt nog steeds doornft get element inet filter f2b_<jail>4 '{ <ip> }' # "No such file" = not in the set
monit status f2b_sets
In welke set schrijft een jail?fail2ban-client get <jail> action nftables-banned-sets setname
Een ban opheffenfail2ban-client unban <ip>
Is een ban mislukt?grep -E "ERROR|Failed to execute" /var/log/fail2ban.log | tail
Loki: {job="fail2ban"} |= "ERROR"
fail2ban gestopt, of er ontbreekt een jailsystemctl status fail2ban
monit status f2b_jails
Sets leeg na een firewall-reloadsystemctl restart fail2ban # re-applies every active ban
Jezelf buitengesloten# from another address or the provider console:
fail2ban-client unban <your-ip>

🎯 De lessen

  • Test een filter tegen een echte logregel in het formaat van vandaag, niet alleen de syntax.
  • “Ban” in het log betekent niet “geblokkeerd”: de waarheid is de set in de kernel.
  • Bans van verschillende lengte hebben aparte sets nodig.
  • Containerlogbestanden verhuizen; de jail moet mee verhuizen.
  • Test verdachte paden nooit vanaf je eigen jump host.

⚖️ Alternatieven – en waarom fail2ban

OptieSterkteWaarom niet hier
CrowdSecGedeelde community-blocklists, scenario’s, bouncersMeer bewegende delen (agent, lokale API, bouncer) en data die met een externe dienst wordt gedeeld.
sshguardKlein, snel, gericht op SSHDekt SSH goed, de HTTP-jails minder.
Alleen rate limits in de ingressBeschermt HTTP zonder extra daemonRemt aanvallers af maar bant ze nooit, en doet niets voor SSH. Wordt aanvullend gebruikt (zoek op rate limit).
fail2banWerkt met elk log, scriptbare actions, volwassenGekozen – met de drie lessen hierboven ingebouwd.

fail2ban is oud, simpel en doet precies wat het belooft. Het werk zat nooit in de tool; het zat erin ervoor te zorgen dat elke “Ban” in zijn log ook als entry in de kernel eindigde. Sinds oktober 2026 wordt dat gecontroleerd – door de firewall-handler, door Monit en door een log-alert – in plaats van aangenomen.

Sommige teksten en afbeeldingen op deze site zijn met hulp van AI gemaakt of door AI gegenereerd. Details