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.

🌐 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
| Jail | Log | Regel | Ban |
|---|---|---|---|
| sshd | journal (systemd-backend) | 3 mislukkingen | standaard 1 u |
| nginx-k3s-wp-login | ingress-log | 10 POSTs naar /wp-login.php in 10 min | 1 u |
| nginx-k3s-nc-login | ingress-log | 10 POSTs naar de /login van Nextcloud in 10 min | 1 u |
| nginx-k3s-grafana-login | ingress-log | 5 mislukte Grafana-logins (HTTP 401) in 10 min | 1 u |
| nginx-k3s-scanner | ingress-log | 20 antwoorden met 403 of 404 in 1 min | 1 u |
| nginx-k3s-bad-paths | ingress-log | 2 requests naar paden die hier nooit bestaan (/.env, /.git/, /phpmyadmin, web shells …) in 1 u | 24 u |
| recidive | fail2ban.log | 3 keer gebannen op één dag | 30 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:
| Jail | Blog | Nextcloud A | Nextcloud B |
|---|---|---|---|
| nginx-k3s-bad-paths | 107 | 74 | 74 |
| nginx-k3s-scanner | 63 | 50 | 47 |
| sshd | 9 | 2 | 11 |
| recidive | 4 | 2 | – |
| nginx-k3s-wp-login | 1 | – | – |
| Aandeel IPv6 | 11 van 184 | 2 van 128 | 2 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
- Bewaakt hij het juiste bestand?
get <jail> logpathtegenoverls /var/log/pods/…– na een restart van de ingress controller had de log-watch-timer hem binnen twee minuten moeten herladen. - Matcht het filter überhaupt?
fail2ban-regextegen het echte bestand. Een veranderd regelformaat na een ingress-upgrade komt hier naar boven. - Wordt de datum begrepen? Regels ouder dan
findtimeworden genegeerd; een verkeerddatepatternmaakt elke regel “oud”. - Bereikt de ban de kernel? Vergelijk
statusmetnft list set. Verschillen ze, zoek dan infail2ban.lognaar “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.
| Symptoom | Commando |
|---|---|
| Een jail bant niets | fail2ban-client status <jail>fail2ban-client get <jail> logpath |
| Het filter matcht niet | fail2ban-regex <logfile> /etc/fail2ban/filter.d/<filter>.conf |
| Gebannen, maar komt nog steeds door | nft get element inet filter f2b_<jail>4 '{ <ip> }' # "No such file" = not in the setmonit status f2b_sets |
| In welke set schrijft een jail? | fail2ban-client get <jail> action nftables-banned-sets setname |
| Een ban opheffen | fail2ban-client unban <ip> |
| Is een ban mislukt? | grep -E "ERROR|Failed to execute" /var/log/fail2ban.log | tailLoki: {job="fail2ban"} |= "ERROR" |
| fail2ban gestopt, of er ontbreekt een jail | systemctl status fail2banmonit status f2b_jails |
| Sets leeg na een firewall-reload | systemctl 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
| Optie | Sterkte | Waarom niet hier |
|---|---|---|
| CrowdSec | Gedeelde community-blocklists, scenario’s, bouncers | Meer bewegende delen (agent, lokale API, bouncer) en data die met een externe dienst wordt gedeeld. |
| sshguard | Klein, snel, gericht op SSH | Dekt SSH goed, de HTTP-jails minder. |
| Alleen rate limits in de ingress | Beschermt HTTP zonder extra daemon | Remt aanvallers af maar bant ze nooit, en doet niets voor SSH. Wordt aanvullend gebruikt (zoek op rate limit). |
| fail2ban | Werkt met elk log, scriptbare actions, volwassen | Gekozen – 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.
