
Automatizza il blocco dei bot dannosi che tentano di accedere al tuo server
Una TUI e una CLI che ti aiutano a configurare il tuo server per fermare i bot malevoli senza nasconderti dietro un CDN. È un'interfaccia grafica per il tuo web server esistente (nginx, Apache, Traefik o NPMplus) e il tuo firewall (nftables o iptables). Per quelli di noi che non vogliono nascondersi dietro Cloudflare e dare a una sola azienda le chiavi di tutti i regni.
Ti protegge in due modi:
Cerca di impedirti di fare qualcosa di autodistruttivo. Vedrai sempre prima quali modifiche
verranno apportate prima di applicarle, e puoi usare il flag --dry-run per maggiore sicurezza. Ma sospetto
che alla fine vorrai abilitare l'applicazione automatica, per comodità. Per questo motivo, l'app cerca anche
di non bloccarti fuori. Gli indirizzi IP con login SSH riusciti non vengono mai bloccati, le configurazioni del webserver
vengono sempre testate prima dell'applicazione e cerca di riconoscere le app in esecuzione dietro proxy HTTP e
adatta le regole di rilevamento dinamico alle app.
Pulsante rosso grande: sudo stop-bots uninstall all

Il resto di questo readme è stato scritto dall'AI. Sentiti libero di chiedere alla tua AI di riassumerlo, non mi dispiacerà.
L'installazione non avvia nulla e non viene scritto nulla finché non applichi. Alla prima applicazione, con le impostazioni con cui parte un nuovo database:
E questo è ciò che viene scritto e dove:
| Cosa | Dove |
|---|---|
| La regola di blocco | all'interno del blocco server di ogni sito, tra # BEGIN stop-bots e # END stop-bots |
I file necessari alla regola, quando un'impostazione ne richiede uno (robots.txt, rate limiting) | /etc/stop-bots/nginx/ e il conf.d di NGINX (per Apache, /etc/stop-bots/apache/ e conf-enabled) |
| Su Traefik, entrambi | un file dedicato, stop-bots.yml, nella directory letta dal file provider di Traefik; nessun tuo file viene modificato |
| Su NPMplus, entrambi | un blocco in custom_nginx/server_http.conf, incluso da ogni host NPMplus, una riga in custom_nginx/http_top.conf, e i propri file in custom_nginx/stop-bots/; i file host scritti da NPMplus non vengono mai modificati |
| Lo script del firewall | /etc/stop-bots/firewall.next.nft (o .next.sh per iptables), copiato in firewall.nft una volta applicato; tocca solo la propria tabella inet stop_bots |
| Impostazioni, blocchi e il motivo di ciascuno | /var/lib/stop-bots/db.sqlite3 |
Ecco sudo stop-bots batch --dry-run --diff su un database nuovo e un NGINX con un solo sito,
abbreviato (il pattern reale degli user agent è lungo qualche centinaio di nomi):
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; }
…
Su Debian o Ubuntu, dal repository APT:
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
Oppure cargo install stop-bots con Rust 1.88 o superiore, oppure un binario statico per x86_64 o
aarch64 Linux dalle release su GitHub,
ciascuno con un checksum e un'attestazione di provenienza della build
(verifica di un download).
L'installazione non avvia nulla.
È testato su Debian e Ubuntu con systemd, e NGINX, Apache, Traefik o NPMplus. Richiede
nft, oppure iptables-restore e ip6tables-restore, per il firewall. Caddy non è
supportato.
NGINX è il predefinito. Su un host Apache, indicalo una volta, e abilita mod_rewrite, con cui
sono scritti i blocchi:
sudo stop-bots set-web-server apache
sudo a2enmod rewrite
Il supporto per Apache è più recente di quello per NGINX ed è stato testato sulla struttura di Debian e Ubuntu
(/etc/apache2). Alcune funzionalità sono esclusive di NGINX, tra cui il rate limiting.
Su un host Traefik 3, puntalo alla directory letta dal file provider di Traefik e indica al log di accesso di Traefik di conservare lo user agent, che per impostazione predefinita viene scartato e che la maggior parte dei rilevatori richiede:
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