ACLClouds
ACLClouds

Wie installiere und konfiguriere ich Fail2ban auf einem Debian- oder Ubuntu-VPS?

Fail2ban installieren, eine jail.local für SSH und nginx schreiben, eine IP sperren und entsperren, den Status der Jails lesen und typische Fehler mit

Fail2ban liest die Logs Ihrer Dienste und sperrt für eine festgelegte Zeit die IP-Adressen, die sich häufende Fehlversuche verursachen: SSH-Passwörter, die in Schleife ausprobiert werden, Scans nach Admin-Seiten, gescheiterte Web-Anmeldungen. Auf einem aus dem Internet erreichbaren VPS beginnen die Versuche auf Port 22 wenige Minuten nach der Bereitstellung. Diese Anleitung installiert Fail2ban unter Debian 12 / 13 oder Ubuntu 22.04 / 24.04, schützt SSH und nginx und zeigt dann, wie Sie eine Adresse prüfen, sperren und entsperren.

Schritt-für-Schritt-Anleitung

  1. Fail2ban installieren

    Aktualisieren Sie die Paketliste und installieren Sie dann fail2ban zusammen mit nftables und python3-systemd, damit es über nftables sperren und das systemd-Journal lesen kann. Der Dienst startet sofort mit der Standardkonfiguration.

  2. Die Datei jail.local anlegen

    Bearbeiten Sie niemals /etc/fail2ban/jail.conf, die bei jedem Update ersetzt wird. Schreiben Sie Ihre Einstellungen in /etc/fail2ban/jail.local: Sperrdauer, Beobachtungszeitraum, Anzahl der Fehlversuche, Adressen, die nie gesperrt werden dürfen, und die nftables-Aktion.

  3. SSH schützen

    Aktivieren Sie das Jail [sshd] mit backend = systemd: Unter Debian schreibt SSH in das systemd-Journal, und die Datei /var/log/auth.log existiert oft nicht. Lauscht SSH auf einem anderen Port als 22, geben Sie ihn mit port an.

  4. Die nginx-Jails hinzufügen

    Läuft nginx auf dem VPS, aktivieren Sie nginx-http-auth für fehlgeschlagene Passwörter der HTTP-Authentifizierung und nginx-botsearch für Bots, die nach Admin-Seiten suchen. Beide Jails lesen /var/log/nginx/error.log.

  5. Testen und neu starten

    Prüfen Sie die Syntax mit fail2ban-client -t, starten Sie mit systemctl restart fail2ban neu und listen Sie dann die aktiven Jails mit fail2ban-client status auf.

  6. Prüfen, sperren und entsperren

    fail2ban-client status sshd zeigt die gezählten Fehlversuche und die gesperrten Adressen. fail2ban-client set sshd unbanip 198.51.100.7 gibt eine Adresse frei, fail2ban-client set sshd banip 198.51.100.7 sperrt sie von Hand.

Installation unter Debian und Ubuntu

apt update
apt install -y fail2ban nftables python3-systemd
systemctl enable --now fail2ban
fail2ban-client version

/etc/fail2ban/jail.local

[DEFAULT]
bantime = 1h
findtime = 10m
maxretry = 5
bantime.increment = true
bantime.maxtime = 1w
ignoreip = 127.0.0.1/8 ::1 203.0.113.10
banaction = nftables-multiport
banaction_allports = nftables-allports

[sshd]
enabled = true
port = ssh
backend = systemd
journalmatch = _SYSTEMD_UNIT=ssh.service + _COMM=sshd + _COMM=sshd-session
maxretry = 4

[nginx-http-auth]
enabled = true

[nginx-botsearch]
enabled = true

Konfiguration testen und anwenden

fail2ban-client -t
systemctl restart fail2ban
fail2ban-client status
fail2ban-client status sshd

Adressen sperren, entsperren und auflisten

fail2ban-client banned
fail2ban-client set sshd banip 198.51.100.7
fail2ban-client set sshd unbanip 198.51.100.7
fail2ban-client unban 198.51.100.7
nft list table inet f2b-table

Prüfen, ob ein Filter die Fehlversuche erkennt

fail2ban-regex systemd-journal sshd
fail2ban-regex /var/log/nginx/error.log nginx-botsearch
tail -n 50 /var/log/fail2ban.log

UFW-Variante

[DEFAULT]
banaction = ufw
banaction_allports = ufw

Bevor Sie beginnen

Melden Sie sich mit ssh root@IP als root an oder setzen Sie sudo vor jeden Befehl. Notieren Sie die öffentliche IP-Adresse, von der aus Sie den VPS verwalten, und tragen Sie sie in ignoreip ein: Sonst genügt es, sich mehrmals beim eigenen Passwort zu vertippen, um sich selbst auszusperren.

  • Fail2ban ergänzt die SSH-Anmeldung per Schlüssel, ersetzt sie aber nicht: Sobald der Schlüssel installiert ist, deaktivieren Sie die Passwort-Authentifizierung (siehe „Was sollte ich vor meiner ersten VPS-Bereitstellung sichern?“).
  • Die Adressen 203.0.113.10 und 198.51.100.7 in den Beispielen sind Dokumentationsadressen: Ersetzen Sie sie durch Ihre eigenen.
  • Wenn Sie sich ausgesperrt haben: Die noVNC-Konsole im ACLClouds-Panel läuft nicht über SSH, damit können Sie Ihre Adresse jederzeit wieder entsperren.

Die Einstellungen in jail.local verstehen

Ein Jail verknüpft einen Filter (die Muster, die einen Fehlversuch in einem Log erkennen), eine Log-Quelle und eine Sperraktion. Der Abschnitt [DEFAULT] legt die gemeinsamen Werte fest, jedes Jail kann sie überschreiben.

  • maxretry, findtime und bantime: Hier führen 5 Fehlversuche innerhalb von 10 Minuten zu einer Sperre von einer Stunde; für SSH genügen 4 Fehlversuche.
  • bantime.increment = true verlängert die Sperre bei jedem Wiederholungsfall, bis zu bantime.maxtime (eine Woche).
  • ignoreip akzeptiert durch Leerzeichen getrennte Adressen und Bereiche, für IPv4 wie für IPv6.
  • banaction = nftables-multiport legt in nftables die Tabelle inet f2b-table an und blockiert dort die gesperrten Adressen, über IPv4 wie über IPv6, auf den Ports des Jails.
  • backend = systemd und journalmatch sorgen dafür, dass das Jail [sshd] das systemd-Journal liest und keine Datei. Die Zeile journalmatch deckt Ubuntu und Debian ab, einschließlich OpenSSH 10 unter Debian 13, wo die Meldungen von sshd-session kommen.

Fail2ban mit nftables oder UFW

Debian 12 und 13 verwenden nftables. Die Aktion nftables-multiport funktioniert dort ohne weitere Einstellung, auch wenn UFW installiert ist: Fail2ban hält seine Regeln in einer eigenen Tabelle. Unter Ubuntu können Sie die Aktion ufw bevorzugen (Block „UFW-Variante“), um die Sperren in ufw status zu sehen.

Fail2ban blockiert den Verkehr, der beim VPS selbst ankommt. Von Docker veröffentlichte Ports laufen über die Kette FORWARD und entgehen diesen Regeln: Um einen Dienst in einem Container zu schützen, verwenden Sie banaction = iptables-multiport und fügen in seinem Jail chain = DOCKER-USER hinzu.

Häufige Fehler vermeiden

Die meisten Installationen, die „nichts sperren“, haben eine dieser Ursachen. Mit fail2ban-client status sshd lassen sie sich unterscheiden: Bleibt Total failed auf 0, während Versuche eintreffen, liest der Filter nicht das richtige Log.

  • jail.conf statt jail.local bearbeiten: Die Änderungen gehen beim nächsten Paket-Update verloren.
  • Ein nginx-Jail aktivieren, obwohl nginx nicht installiert ist: Die Log-Datei fehlt, und Fail2ban verweigert den Start.
  • Den SSH-Port ändern, ohne port in [sshd] anzupassen: Die Adresse wird auf Port 22 gesperrt, nicht auf dem neuen.
  • Die eigene Adresse in ignoreip vergessen und sich dann beim Testen selbst aussperren.
  • backend = systemd in [DEFAULT] schreiben: Die nginx-Jails, die Dateien lesen, sehen dann nichts mehr.

Schnellüberprüfung

  • systemctl is-active fail2ban antwortet active.
  • fail2ban-client status listet sshd und, falls nginx installiert ist, die nginx-Jails auf.
  • fail2ban-regex systemd-journal sshd findet passende Zeilen.
  • Ihre eigene IP-Adresse steht in ignoreip.
  • nft list table inet f2b-table zeigt die gesperrten Adressen.

Häufig gestellte Fragen

Fail2ban startet nicht und meldet Have not found any log file for sshd jail: Was tun?

Das Jail sucht /var/log/auth.log, die fehlt, wenn SSH nur in das systemd-Journal schreibt, was unter Debian häufig ist. Fügen Sie backend = systemd im Abschnitt [sshd] von jail.local hinzu, installieren Sie python3-systemd und führen Sie dann erneut systemctl restart fail2ban aus.

Wie entsperre ich eine IP-Adresse mit Fail2ban?

Führen Sie fail2ban-client set sshd unbanip 198.51.100.7 aus und ersetzen Sie dabei Jail und Adresse, oder fail2ban-client unban 198.51.100.7, um sie aus allen Jails zu entfernen. Ist es Ihre eigene Adresse und antwortet SSH nicht mehr, melden Sie sich über die noVNC-Konsole des Panels an, um den Befehl auszuführen.

Wie sehe ich die gesperrten Adressen?

fail2ban-client status sshd zeigt die Anzahl der gesperrten Adressen und ihre Liste für ein Jail; fail2ban-client banned liefert sie für alle Jails. Auf Firewall-Seite zeigt nft list table inet f2b-table die Sets der blockierten Adressen.

Unter Ubuntu 24.04 bricht Fail2ban mit No module named 'asynchat' ab: Warum?

Die erste mit Ubuntu 24.04 ausgelieferte Fail2ban-Version war nicht mit Python 3.12 kompatibel. Die Korrektur ist in den Paketquellen verfügbar: Führen Sie apt update && apt install --only-upgrade fail2ban und danach systemctl restart fail2ban aus.

Versuche treffen ein, aber Total failed bleibt auf 0: Was sollte ich prüfen?

Der Filter liest nicht die richtigen Meldungen. Testen Sie ihn mit fail2ban-regex systemd-journal sshd: Die Zeile Lines: ... matched muss größer als 0 sein. Andernfalls prüfen Sie backend = systemd und die Zeile journalmatch des Jails [sshd], dann den Namen des Dienstes mit systemctl status ssh.

Reicht Fail2ban aus, um einen VPS zu schützen?

Nein. Es verringert das Rauschen von Brute-Force-Angriffen und entlastet die Logs, aber ein SSH-Schlüssel, eine deaktivierte Passwort-Anmeldung, eine Firewall, die nur die benötigten Ports durchlässt, und regelmäßige Updates bleiben unverzichtbar.