Zum Hauptinhalt springen

Fail2ban — SSH und Webdienste vor Brute-Force-Angriffen schützen

Umfassender Einsteiger-Ratgeber zur Installation, Konfiguration und Verwaltung von Fail2ban auf Linux, mit detaillierter Flag-Erklärung, jail.local und IP-Entsperrung.

Auf dieser Seite
  1. Was ist Fail2ban und wie funktioniert es?
  2. 1. Installation und Dienst-Einrichtung
  3. Erklärung der Befehle und Parameter:
  4. 2. Konfiguration: Der Unterschied zwischen jail.conf und jail.local
  5. 3. Zentrale Standardparameter ([DEFAULT])
  6. Die Parameter im Detail:
  7. 4. SSH-Schutz konfigurieren ([sshd])
  8. 5. Webserver-Schutz: Jails für Nginx & Apache
  9. Nginx vor Bot-Scans schützen:
  10. 6. Verwaltung im Alltag: Die wichtigsten CLI-Befehle
  11. 1. Gesamtstatus und aktive Jails prüfen
  12. 2. Spezifisches Jail analysieren und gesperrte IPs auflisten
  13. 3. Eine IP-Adresse manuell entsperren
  14. 4. Eine verdächtige IP manuell sperren
  15. 5. Regex-Filter an Logdateien testen
  16. 7. Häufige Fehler und Troubleshooting

Was ist Fail2ban und wie funktioniert es?

Sobald ein Linux-Server mit einem offenen Port an das Internet angebunden ist (z. B. SSH auf Port 22 oder Webserver auf Port 80/443), scannen automatisierte Bots das System und probieren hunderte Passwörter pro Minute durch.

Fail2ban ist ein Open-Source-Sicherheitsdienst (fail2ban-server), der die Protokolldateien des Servers (wie /var/log/auth.log oder das systemd-Journal) kontinuierlich überwacht. Erkennt das System wiederholte fehlgeschlagene Authentifizierungsversuche von derselben IP-Adresse innerhalb eines definierten Zeitfensters, trägt Fail2ban automatisch eine Sperrregel in die Firewall ein (nftables, iptables oder ufw), um alle künftigen Pakete dieses Angreifers zu verwerfen.

text10 lines
[ Angreifer / Bot ] ──(Fehlgeschlagene Logins)──► [ /var/log/auth.log ]
                                                            │
                                                            ▼ (Scan mit Regex-Filtern)
                                                  [ Fail2ban Daemon ]
                                                            │
                                                            ▼ (maxretry überschritten!)
                                                  [ Linux Firewall (UFW/nftables) ]
                                                            │
                                                            ▼
                                                  [ Droppe alle Pakete der Angreifer-IP ]

1. Installation und Dienst-Einrichtung

Unter Debian, Ubuntu oder Raspberry Pi OS installierst du Fail2ban über den Paketmanager APT:

bash3 lines
sudo apt update
sudo apt install -y fail2ban
sudo systemctl enable --now fail2ban

Erklärung der Befehle und Parameter:

  • sudo: Führt den Befehl mit Administratorrechten (root) aus, die zur Verwaltung von Systempaketen und Firewalls erforderlich sind.
  • apt update: Aktualisiert die Paketlisten der konfigurierten Paketquellen auf den neuesten Stand.
  • apt install -y fail2ban: Installiert das Fail2ban-Paket. Der Parameter -y beantwortet alle Bestätigungsabfragen automatisch mit "Ja".
  • systemctl enable --now fail2ban: Vereint zwei Schritte:
  • enable: Richtet Fail2ban so ein, dass es bei jedem Serverstart automatisch mitgestartet wird.
  • --now: Startet den Dienst sofort im Hintergrund, ohne dass ein Neustart erforderlich ist.

Überprüfe, ob der Dienst aktiv läuft:

bash1 line
sudo systemctl status fail2ban

2. Konfiguration: Der Unterschied zwischen jail.conf und jail.local

Die Standardkonfiguration liegt unter /etc/fail2ban/jail.conf.

Warning

Bearbeite niemals /etc/fail2ban/jail.conf direkt! Bei jedem Systemupdate (apt upgrade) wird jail.conf mit den neuen Standardwerten der Paketbetreuer überschrieben. Eigene Anpassungen gehen dabei unwiderruflich verloren.

Fail2ban verwendet ein mehrschichtiges Konfigurationssystem: Dateien mit der Endung .local haben immer Vorrang vor .conf. Erstelle daher eine Arbeitskopie:

bash1 line
sudo cp /etc/fail2ban/jail.conf /etc/fail2ban/jail.local

Öffne die neue Konfigurationsdatei mit einem Editor:

bash1 line
sudo nano /etc/fail2ban/jail.local

3. Zentrale Standardparameter ([DEFAULT])

Suche in /etc/fail2ban/jail.local den Abschnitt [DEFAULT]. Diese Einstellungen gelten global für alle Schutzbereiche (Jails), sofern sie nicht spezifisch überschrieben werden:

ini15 lines
[DEFAULT]
# Dauer der Sperre (z. B. 1h, 1d, 1w)
bantime = 1h

# Zeitfenster, in dem Fehlversuche gezählt werden
findtime = 10m

# Anzahl erlaubter Fehlversuche vor der Sperrung
maxretry = 5

# Vertrauenswürdige IP-Adressen (Whitelist), die NIEMALS gesperrt werden dürfen
ignoreip = 127.0.0.1/8 ::1 192.168.1.0/24 203.0.113.15

# Protokoll-Backend (systemd ist optimal für moderne Debian/Ubuntu-Systeme)
backend = systemd

Die Parameter im Detail:

  • bantime = 1h: Bestimmt die Sperrdauer. Mögliche Einheiten: Sekunden (3600), Minuten (60m), Stunden (1h) oder Tage (7d). Der Wert -1 bewirkt eine permanente Sperre.
  • findtime = 10m: Das Beobachtungszeitfenster. Treten innerhalb von 10 Minuten 5 Fehlversuche auf, greift die Sperre. Liegen zwischen den Fehlversuchen mehr als 10 Minuten, wird der Zähler zurückgesetzt.
  • maxretry = 5: Die maximale Toleranz an Fehlversuchen, bevor die Firewall-Regel aktiviert wird.
  • ignoreip: Eine durch Leerzeichen getrennte Liste von IPs, Subnetzen (z. B. 192.168.1.0/24) oder Hostnamen, die von Sperren ausgenommen sind. Trage hier unbedingt deine eigene feste IP-Adresse oder dein VPN-Netzwerk ein, um dich nicht selbst auszusperren.
  • backend = systemd: Weist Fail2ban an, direkt das systemd-Journal auszulesen. Das spart Ressourcen gegenüber alten Logdateien und verhindert Probleme bei Log-Rotationen.

4. SSH-Schutz konfigurieren ([sshd])

Scrolle zum Abschnitt [sshd] in /etc/fail2ban/jail.local und passe die Einstellungen an:

ini6 lines
[sshd]
enabled  = true
port     = ssh
filter   = sshd
maxretry = 3
bantime  = 24h
  • enabled = true: Aktiviert dieses Jail.
  • port = ssh: Standardmäßig Port 22. Wenn du einen alternativen SSH-Port nutzt (z. B. 2222), passe diesen Wert entsprechend an: port = 2222.
  • maxretry = 3: Strengeres Limit für SSH als der globale Standard.
  • bantime = 24h: Sperrt Angreifer auf SSH für volle 24 Stunden.

Speichere die Datei (Ctrl+O, dann Enter und Ctrl+X in nano) und starte Fail2ban neu:

bash1 line
sudo systemctl restart fail2ban

5. Webserver-Schutz: Jails für Nginx & Apache

Auch Webanwendungen lassen sich gezielt vor Exploit-Scannern und Brute-Force-Attacken schützen.

Nginx vor Bot-Scans schützen:

Füge diesen Block zu /etc/fail2ban/jail.local hinzu:

ini7 lines
[nginx-botsearch]
enabled  = true
port     = http,https
filter   = nginx-botsearch
logpath  = /var/log/nginx/error.log
maxretry = 2
bantime  = 48h
  • port = http,https: Wendet die Sperre auf Port 80 und Port 443 an.
  • filter = nginx-botsearch: Erkennt automatische Anfragen nach Schwachstellen (wie /wp-login.php, phpmyadmin oder .env-Dateien), die auf dem Server gar nicht existieren.
  • maxretry = 2: Da legitime Nutzer solche Pfade nicht aufrufen, greift die Sperre bereits nach dem zweiten Versuch für 48 Stunden.

6. Verwaltung im Alltag: Die wichtigsten CLI-Befehle

Zur Verwaltung dient das Kommandozeilen-Werkzeug fail2ban-client.

1. Gesamtstatus und aktive Jails prüfen

bash1 line
sudo fail2ban-client status

2. Spezifisches Jail analysieren und gesperrte IPs auflisten

bash1 line
sudo fail2ban-client status sshd

Beispiel-Ausgabe:

text9 lines
Status for the jail: sshd
|- Filter
|  |- Currently failed: 1
|  |- Total failed:     42
|  `- File list:        systemd
`- Actions
   |- Currently banned: 2
   |- Total banned:     15
   `- Banned IP list:   198.51.100.24 203.0.113.88

3. Eine IP-Adresse manuell entsperren

Wurde eine eigene IP oder die eines Kollegen versehentlich blockiert, lässt sich diese sofort freigeben:

bash1 line
sudo fail2ban-client set sshd unbanip 203.0.113.88
  • set sshd: Gibt an, in welchem Jail die Aktion ausgeführt werden soll.
  • unbanip <IP>: Entfernt die Firewall-Sperre für die angegebene Adresse.

4. Eine verdächtige IP manuell sperren

bash1 line
sudo fail2ban-client set sshd banip 198.51.100.99

5. Regex-Filter an Logdateien testen

Um neue Filterregeln vor der Aktivierung zu überprüfen, nutze fail2ban-regex:

bash1 line
sudo fail2ban-regex /var/log/auth.log /etc/fail2ban/filter.d/sshd.conf

7. Häufige Fehler und Troubleshooting

ProblemUrsacheLösung
Vom eigenen Server ausgesperrtKennwort zu oft falsch eingegeben, keine WhitelistÜber die Provider-Webkonsole (VNC/KVM) anmelden, sudo fail2ban-client set sshd unbanip <Eigene_IP> ausführen und die IP in ignoreip eintragen.
Keine IPs werden gebanntFalscher Log-Pfad oder BackendIn [DEFAULT] backend = systemd setzen oder den Pfad mit ls -l /var/log/auth.log kontrollieren.
Fail2ban startet nichtSyntaxfehler in jail.localKonfiguration mit sudo fail2ban-client -d auf Fehler prüfen oder sudo journalctl -u fail2ban -e einsehen.
Hinter Cloudflare ProxyWeb-Jail sieht nur Cloudflare-IPsIn Nginx das Modul set_real_ip_from mit den Cloudflare-Netzen konfigurieren, damit die echte Client-IP geloggt wird.