
Automatisieren Sie das Blockieren bösartiger Bots am Zugriff auf Ihren Server
Eine TUI und eine CLI, die dir helfen, deinen Server so zu konfigurieren, dass er böswillige Bots abwehrt, ohne sich hinter einem CDN zu verstecken. Es ist eine komfortable Oberfläche für deinen bestehenden Webserver (nginx, Apache, Traefik oder NPMplus) und deine Firewall (nftables oder iptables). Für diejenigen von uns, die sich nicht hinter Cloudflare verstecken und einem einzigen Unternehmen die Schlüssel zu allen Reichen geben wollen.
Es schützt dich auf zwei Arten:
Es versucht, dich davon abzuhalten, etwas Selbstzerstörerisches zu tun. Du siehst immer zuerst, welche Änderungen vorgenommen werden, bevor du sie anwendest, und du kannst das Flag --dry-run für zusätzliche Sicherheit verwenden. Aber ich vermute, dass du irgendwann aus Bequemlichkeit die automatische Anwendung aktivieren möchtest. Aus diesem Grund versucht die App auch, dich nicht auszusperren. IP-Adressen mit erfolgreichen SSH-Anmeldungen werden niemals blockiert, Webserver-Konfigurationen werden immer vor der Anwendung getestet, und es wird versucht, Apps zu erkennen, die hinter HTTP-Proxys laufen, und die dynamischen Erkennungsregeln an die Apps anzupassen.
Großer roter Knopf: sudo stop-bots uninstall all

Der Rest dieser Readme wurde von der KI geschrieben. Du kannst gerne deine eigene KI bitten, sie zusammenzufassen, das stört mich nicht.
Die Installation startet nichts, und es wird nichts geschrieben, bis du anwendest. Beim ersten Anwenden mit den Einstellungen, mit denen eine neue Datenbank startet:
Und das wird wohin geschrieben:
| Was | Wohin |
|---|---|
| Die Blockierungsregel | innerhalb des server-Blocks jeder Website, zwischen # BEGIN stop-bots und # END stop-bots |
Dateien, die die Regel benötigt, wenn eine Einstellung eine erfordert (robots.txt, Rate Limiting) | /etc/stop-bots/nginx/ und NGINXs conf.d (für Apache /etc/stop-bots/apache/ und conf-enabled) |
| Bei Traefik beides | eine eigene Datei, stop-bots.yml, in dem Verzeichnis, das der Datei-Provider von Traefik liest; keine deiner Dateien wird bearbeitet |
| Bei NPMplus beides | ein Block in custom_nginx/server_http.conf, den jeder NPMplus-Host einbindet, eine Zeile in custom_nginx/http_top.conf und eigene Dateien in custom_nginx/stop-bots/; die Host-Dateien, die NPMplus schreibt, werden niemals bearbeitet |
| Das Firewall-Skript | /etc/stop-bots/firewall.next.nft (oder .next.sh für iptables), nach dem Anwenden nach firewall.nft kopiert; es berührt nur seine eigene inet stop_bots-Tabelle |
| Einstellungen, Blocks und der Grund für jeden | /var/lib/stop-bots/db.sqlite3 |
Hier ist sudo stop-bots batch --dry-run --diff auf einer frischen Datenbank und einem NGINX mit einer Website, gekürzt (das echte User-Agent-Muster ist ein paar hundert Namen lang):
Dry run: nothing is downloaded, scanned, written, applied or recorded. Against the database as it is, `batch` would:
NGINX: 1 file(s) would change:
/etc/nginx/sites-enabled/example.com
Firewall (nftables): 0 rule(s), 0 kernel entries; no applied script at /etc/stop-bots/firewall.nft yet, so all of it is new
lockout check passed: the SSH log was read, and no connected client would be blocked
would write 0 rule(s) to /etc/stop-bots/firewall.next.nft; not applied — review it, then apply it (“Apply everything” or `stop-bots render-firewall --apply`)
--- /etc/nginx/sites-enabled/example.com
+++ /etc/nginx/sites-enabled/example.com
@@ -1,4 +1,10 @@
server {
+ # BEGIN stop-bots (DO NOT EDIT)
+ if ($http_user_agent ~* "AgentReadinessScanner|AIScan|ArgusScanner|…|xAI-Grok|zmap-proxy-probe") {
+ return 403;
+ }
+ # END stop-bots
+
listen 443 ssl;
server_name example.com;
root /var/www/example.com;
--- /etc/stop-bots/firewall.nft (does not exist)
+++ /etc/stop-bots/firewall.next.nft
@@ -0,0 +1,29 @@
+#!/usr/sbin/nft -f
+# Generated by stop-bots 0.2.0. Not executed automatically — review, then run
+# with: nft -f <this file>
…
+add table inet stop_bots
+delete table inet stop_bots
+add table inet stop_bots
+add chain inet stop_bots bot_block { type filter hook input priority -1; policy accept; }
…
Unter Debian oder Ubuntu aus dem APT-Repository:
curl -fsSL https://ivankovic.github.io/stop-bots/key.gpg \
| sudo tee /usr/share/keyrings/stop-bots.gpg > /dev/null
echo "deb [signed-by=/usr/share/keyrings/stop-bots.gpg] \
https://ivankovic.github.io/stop-bots stable main" \
| sudo tee /etc/apt/sources.list.d/stop-bots.list
sudo apt update && sudo apt install stop-bots
Oder cargo install stop-bots mit Rust 1.88 oder neuer, oder ein statisches Binary für x86_64 oder
aarch64 Linux aus den GitHub-Releases,
jeweils mit einer Prüfsumme und einer Build-Provenance-Attestierung
(Verifizieren eines Downloads).
Die Installation startet nichts.
Es ist getestet auf Debian und Ubuntu mit systemd sowie NGINX, Apache, Traefik oder NPMplus. Es
benötigt nft oder iptables-restore und ip6tables-restore für die Firewall. Caddy wird nicht
unterstützt.
NGINX ist der Standard. Auf einem Apache-Host teilt man dies einmal mit und aktiviert mod_rewrite, in dem
die Blocks geschrieben sind:
sudo stop-bots set-web-server apache
sudo a2enmod rewrite
Apache-Unterstützung ist neuer als die von NGINX und wurde mit dem Debian- und Ubuntu-Layout getestet
(/etc/apache2). Einige Funktionen sind nur in NGINX verfügbar, darunter die Ratenbegrenzung.
Auf einem Traefik-3-Host richtet man es auf das Verzeichnis, das der Datei-Provider von Traefik liest, und weist das Zugriffsprotokoll von Traefik an, den User-Agent zu behalten, den es standardmäßig verwirft und den die meisten Detektoren benötigen:
sudo stop-bots set-web-server traefik --root /etc/traefik/dynamic
sudo stop-bots set-log-paths --access-log /var/log/traefik/access.log
# In Traefik's static config
accessLog:
filePath: /var/log/traefik/access.log
fields:
headers:
names:
User-Agent: keep
Referer: keep