v0.3.0 - Initial Release

2026-03-03 21:15:54 +01:00
parent a5fb3bcf25
commit 64079f6fef
15 changed files with 896 additions and 279 deletions
--- a/doc/architektur.md
+++ b/doc/architektur.md
@@ -15,7 +15,7 @@
 └─────────────────────┘                │
                                       ▼
                            ┌──────────────────────┐
-                            │  adguard-ratelimit.sh │
+                            │  adguard-shield.sh │
                            │  (Monitor Script)     │
                            └──────────┬───────────┘
                                       │
@@ -35,27 +35,27 @@
 4. Monitor erkennt: 45 > 30 (Limit überschritten)
 5. Prüfung: Ist der Client auf der Whitelist? → Nein
 6. iptables-Regel wird erstellt: `DROP` für `192.168.1.50` auf allen DNS-Ports
-7. State-Datei wird angelegt: `/var/lib/adguard-ratelimit/192.168.1.50.ban`
-8. Ban-History Eintrag wird in `/var/log/adguard-ratelimit-bans.log` geschrieben
+7. State-Datei wird angelegt: `/var/lib/adguard-shield/192.168.1.50.ban`
+8. Ban-History Eintrag wird in `/var/log/adguard-shield-bans.log` geschrieben
 9. Log-Eintrag + optionale Webhook-Benachrichtigung
 10. Nach 3600 Sekunden (1 Stunde): automatische Entsperrung + History-Eintrag

 ## iptables Strategie

-Das Tool erstellt eine eigene Chain `ADGUARD_RATELIMIT`:
+Das Tool erstellt eine eigene Chain `ADGUARD_SHIELD`:

 ```
 INPUT Chain
  ├── ... (bestehende Regeln bleiben unberührt)
-  ├── -p tcp --dport 53  → ADGUARD_RATELIMIT
-  ├── -p udp --dport 53  → ADGUARD_RATELIMIT
-  ├── -p tcp --dport 443 → ADGUARD_RATELIMIT
-  ├── -p udp --dport 443 → ADGUARD_RATELIMIT
-  ├── -p tcp --dport 853 → ADGUARD_RATELIMIT
-  ├── -p udp --dport 853 → ADGUARD_RATELIMIT
+  ├── -p tcp --dport 53  → ADGUARD_SHIELD
+  ├── -p udp --dport 53  → ADGUARD_SHIELD
+  ├── -p tcp --dport 443 → ADGUARD_SHIELD
+  ├── -p udp --dport 443 → ADGUARD_SHIELD
+  ├── -p tcp --dport 853 → ADGUARD_SHIELD
+  ├── -p udp --dport 853 → ADGUARD_SHIELD
  └── ...

-ADGUARD_RATELIMIT Chain
+ADGUARD_SHIELD Chain
  ├── -s 192.168.1.50 → DROP  (gesperrter Client)
  ├── -s 10.0.0.25    → DROP  (gesperrter Client)
  └── RETURN                   (alle anderen passieren)
@@ -64,14 +64,14 @@ ADGUARD_RATELIMIT Chain
 **Vorteile der eigenen Chain:**
 - Greift nicht in bestehende Firewall-Regeln ein
 - Kann komplett geflusht werden ohne andere Regeln zu beeinflussen
- Einfaches Debugging per `iptables -L ADGUARD_RATELIMIT`
+- Einfaches Debugging per `iptables -L ADGUARD_SHIELD`

 ## State-Management

 Jede aktive Sperre wird als Datei gespeichert:

 ```
-/var/lib/adguard-ratelimit/192.168.1.50.ban
+/var/lib/adguard-shield/192.168.1.50.ban
 ```

 Inhalt:
@@ -92,26 +92,64 @@ Das ermöglicht:
 ## Dateistruktur nach Installation

 ```
-/opt/adguard-ratelimit/
-├── adguard-ratelimit.sh     # Haupt-Monitor-Script
-├── adguard-ratelimit.conf   # Konfiguration (chmod 600)
-├── iptables-helper.sh       # iptables Verwaltung
-└── unban-expired.sh         # Cron-basiertes Entsperren
+/opt/adguard-shield/
+├── adguard-shield.sh              # Haupt-Monitor-Script
+├── adguard-shield.conf            # Konfiguration (chmod 600)
+├── adguard-shield.conf.old        # Backup der Konfig nach Update
+├── iptables-helper.sh             # iptables Verwaltung
+├── external-blocklist-worker.sh   # Externer Blocklist-Worker
+└── unban-expired.sh               # Cron-basiertes Entsperren

 /etc/systemd/system/
-└── adguard-ratelimit.service
+└── adguard-shield.service         # systemd Service (Autostart aktiv)

-/var/lib/adguard-ratelimit/
-└── *.ban                    # State-Dateien aktiver Sperren
+/var/lib/adguard-shield/
+├── *.ban                          # State-Dateien aktiver Sperren
+└── external-blocklist/            # Cache für externe Blocklisten

 /var/log/
-├── adguard-ratelimit.log        # Laufzeit-Log
-└── adguard-ratelimit-bans.log   # Ban-History (alle Sperren/Entsperrungen)
+├── adguard-shield.log             # Laufzeit-Log
+└── adguard-shield-bans.log        # Ban-History (alle Sperren/Entsperrungen)
+```
+
+## Installer-Architektur
+
+Der Installer (`install.sh`) bietet ein interaktives Menü und folgende Funktionen:
+
+| Befehl | Beschreibung |
+|--------|--------------|
+| `install` | Vollständige Neuinstallation (Abhängigkeiten, Dateien, Konfiguration, Service) |
+| `update` | Update mit automatischer Konfigurations-Migration und Service-Neustart |
+| `uninstall` | Deinstallation mit optionalem Behalten der Konfiguration |
+| `status` | Installationsstatus, Version und Service-Status anzeigen |
+| `--help` | Hilfe und Befehlsübersicht |
+
+### Konfigurations-Migration beim Update
+
+```
+┌─────────────────────────┐     ┌─────────────────────────┐
+│   Bestehende Konfig     │     │   Neue Konfig (Repo)    │
+│   (Benutzer-Settings)   │     │   (mit neuen Parametern) │
+└───────────┬─────────────┘     └───────────┬─────────────┘
+            │                               │
+            ▼                               ▼
+     ┌──────────────────────────────────────────┐
+     │        Konfigurations-Migration          │
+     │  1. Backup als .conf.old erstellen       │
+     │  2. Alle Schlüssel vergleichen           │
+     │  3. Neue Schlüssel zur Konfig ergänzen   │
+     │  4. Bestehende Werte NICHT ändern        │
+     └──────────────────────┬───────────────────┘
+                            ▼
+              ┌──────────────────────────┐
+              │  Aktualisierte Konfig    │
+              │  (alte Werte + neue Keys) │
+              └──────────────────────────┘
 ```

 ## Ban-History

-Jede Sperre und Entsperrung wird dauerhaft in der Ban-History protokolliert (`/var/log/adguard-ratelimit-bans.log`). Das ermöglicht eine lückenlose Nachvollziehbarkeit, auch nachdem State-Dateien bereits gelöscht wurden.
+Jede Sperre und Entsperrung wird dauerhaft in der Ban-History protokolliert (`/var/log/adguard-shield-bans.log`). Das ermöglicht eine lückenlose Nachvollziehbarkeit, auch nachdem State-Dateien bereits gelöscht wurden.

 **Format:**
 ```
@@ -133,6 +171,6 @@ ZEITSTEMPEL         | AKTION | CLIENT-IP                               | DOMAIN

 **History anzeigen:**
 ```bash
-sudo /opt/adguard-ratelimit/adguard-ratelimit.sh history       # letzte 50
-sudo /opt/adguard-ratelimit/adguard-ratelimit.sh history 200   # letzte 200
+sudo /opt/adguard-shield/adguard-shield.sh history       # letzte 50
+sudo /opt/adguard-shield/adguard-shield.sh history 200   # letzte 200
 ```
--- a/doc/befehle.md
+++ b/doc/befehle.md
@@ -1,43 +1,86 @@
 # Befehle & Nutzung

+## Installer / Updater
+
+Der Installer bietet ein interaktives Menü wenn er ohne Argumente aufgerufen wird:
+
+```bash
+# Interaktives Menü anzeigen
+sudo bash install.sh
+
+# Neuinstallation
+sudo bash install.sh install
+
+# Update (mit automatischer Konfigurations-Migration)
+sudo bash install.sh update
+
+# Deinstallation
+sudo bash install.sh uninstall
+
+# Installationsstatus anzeigen
+sudo bash install.sh status
+
+# Hilfe anzeigen
+sudo bash install.sh --help
+```
+
+### Update-Verhalten
+
+Beim Update passiert automatisch:
+1. Alle Scripts werden aktualisiert
+2. Die bestehende Konfiguration wird als `adguard-shield.conf.old` gesichert
+3. Neue Konfigurationsparameter werden automatisch zur bestehenden Konfig hinzugefügt
+4. Bestehende Einstellungen bleiben **immer** erhalten
+5. Der systemd Service wird per `daemon-reload` neu geladen
+6. Der Service wird automatisch neu gestartet (falls er lief)
+
+### Voraussetzungen
+
+Folgende Pakete werden bei der Installation automatisch installiert (via `apt`):
+- `curl` — API-Kommunikation mit AdGuard Home
+- `jq` — JSON-Verarbeitung der API-Antworten
+- `iptables` — Firewall-Regeln für IP-Sperren
+- `gawk` — Textverarbeitung
+- `systemd` — Service-Management
+
 ## Monitor (Hauptscript)

 ```bash
 # Starten
-sudo /opt/adguard-ratelimit/adguard-ratelimit.sh start
+sudo /opt/adguard-shield/adguard-shield.sh start

 # Stoppen
-sudo /opt/adguard-ratelimit/adguard-ratelimit.sh stop
+sudo /opt/adguard-shield/adguard-shield.sh stop

 # Status + aktive Sperren anzeigen
-sudo /opt/adguard-ratelimit/adguard-ratelimit.sh status
+sudo /opt/adguard-shield/adguard-shield.sh status

 # Ban-History anzeigen (letzte 50 Einträge)
-sudo /opt/adguard-ratelimit/adguard-ratelimit.sh history
+sudo /opt/adguard-shield/adguard-shield.sh history

 # Ban-History anzeigen (letzte 100 Einträge)
-sudo /opt/adguard-ratelimit/adguard-ratelimit.sh history 100
+sudo /opt/adguard-shield/adguard-shield.sh history 100

 # Alle Sperren aufheben
-sudo /opt/adguard-ratelimit/adguard-ratelimit.sh flush
+sudo /opt/adguard-shield/adguard-shield.sh flush

 # Einzelne IP entsperren
-sudo /opt/adguard-ratelimit/adguard-ratelimit.sh unban 192.168.1.100
+sudo /opt/adguard-shield/adguard-shield.sh unban 192.168.1.100

 # API-Verbindung testen
-sudo /opt/adguard-ratelimit/adguard-ratelimit.sh test
+sudo /opt/adguard-shield/adguard-shield.sh test

 # Dry-Run (nur loggen, nichts sperren)
-sudo /opt/adguard-ratelimit/adguard-ratelimit.sh dry-run
+sudo /opt/adguard-shield/adguard-shield.sh dry-run

 # Externe Blocklist - Status anzeigen
-sudo /opt/adguard-ratelimit/adguard-ratelimit.sh blocklist-status
+sudo /opt/adguard-shield/adguard-shield.sh blocklist-status

 # Externe Blocklist - Einmalige Synchronisation
-sudo /opt/adguard-ratelimit/adguard-ratelimit.sh blocklist-sync
+sudo /opt/adguard-shield/adguard-shield.sh blocklist-sync

 # Externe Blocklist - Alle Sperren der externen Liste aufheben
-sudo /opt/adguard-ratelimit/adguard-ratelimit.sh blocklist-flush
+sudo /opt/adguard-shield/adguard-shield.sh blocklist-flush
 ```

 ## iptables Helper
@@ -46,26 +89,26 @@ Für die manuelle Verwaltung der Firewall-Regeln:

 ```bash
 # Chain erstellen
-sudo /opt/adguard-ratelimit/iptables-helper.sh create
+sudo /opt/adguard-shield/iptables-helper.sh create

 # Alle Regeln anzeigen
-sudo /opt/adguard-ratelimit/iptables-helper.sh status
+sudo /opt/adguard-shield/iptables-helper.sh status

 # IP manuell sperren
-sudo /opt/adguard-ratelimit/iptables-helper.sh ban 192.168.1.100
+sudo /opt/adguard-shield/iptables-helper.sh ban 192.168.1.100

 # IP entsperren
-sudo /opt/adguard-ratelimit/iptables-helper.sh unban 192.168.1.100
+sudo /opt/adguard-shield/iptables-helper.sh unban 192.168.1.100

 # Alle Regeln leeren
-sudo /opt/adguard-ratelimit/iptables-helper.sh flush
+sudo /opt/adguard-shield/iptables-helper.sh flush

 # Chain komplett entfernen
-sudo /opt/adguard-ratelimit/iptables-helper.sh remove
+sudo /opt/adguard-shield/iptables-helper.sh remove

 # Regeln speichern / wiederherstellen
-sudo /opt/adguard-ratelimit/iptables-helper.sh save
-sudo /opt/adguard-ratelimit/iptables-helper.sh restore
+sudo /opt/adguard-shield/iptables-helper.sh save
+sudo /opt/adguard-shield/iptables-helper.sh restore
 ```

 ## Externer Blocklist-Worker
@@ -74,51 +117,55 @@ Der Worker kann auch standalone gesteuert werden:

 ```bash
 # Worker manuell starten (normalerweise automatisch per Hauptscript)
-sudo /opt/adguard-ratelimit/external-blocklist-worker.sh start
+sudo /opt/adguard-shield/external-blocklist-worker.sh start

 # Worker stoppen
-sudo /opt/adguard-ratelimit/external-blocklist-worker.sh stop
+sudo /opt/adguard-shield/external-blocklist-worker.sh stop

 # Einmalige Synchronisation (z.B. nach Konfigurationsänderung)
-sudo /opt/adguard-ratelimit/external-blocklist-worker.sh sync
+sudo /opt/adguard-shield/external-blocklist-worker.sh sync

 # Status anzeigen
-sudo /opt/adguard-ratelimit/external-blocklist-worker.sh status
+sudo /opt/adguard-shield/external-blocklist-worker.sh status

 # Alle externen Sperren aufheben
-sudo /opt/adguard-ratelimit/external-blocklist-worker.sh flush
+sudo /opt/adguard-shield/external-blocklist-worker.sh flush
 ```

 ## systemd Service

+Der Service wird bei der Installation automatisch für den **Autostart beim Booten** aktiviert.
+
 ```bash
 # Start / Stop / Restart
-sudo systemctl start adguard-ratelimit
-sudo systemctl stop adguard-ratelimit
-sudo systemctl restart adguard-ratelimit
+sudo systemctl start adguard-shield
+sudo systemctl stop adguard-shield
+sudo systemctl restart adguard-shield

 # Status
-sudo systemctl status adguard-ratelimit
+sudo systemctl status adguard-shield

 # Autostart aktivieren / deaktivieren
-sudo systemctl enable adguard-ratelimit
-sudo systemctl disable adguard-ratelimit
+sudo systemctl enable adguard-shield
+sudo systemctl disable adguard-shield
 ```

+> **Hinweis:** Nach einem Update wird der Service automatisch neu gestartet. Ein manueller Neustart ist nicht nötig.
+
 ## Logs

 ```bash
 # systemd Journal
-sudo journalctl -u adguard-ratelimit -f
+sudo journalctl -u adguard-shield -f

 # Log-Datei direkt
-sudo tail -f /var/log/adguard-ratelimit.log
+sudo tail -f /var/log/adguard-shield.log

 # Nur Sperr-Einträge
-sudo grep "SPERRE" /var/log/adguard-ratelimit.log
+sudo grep "SPERRE" /var/log/adguard-shield.log

 # Nur Entsperr-Einträge
-sudo grep "ENTSPERRE" /var/log/adguard-ratelimit.log
+sudo grep "ENTSPERRE" /var/log/adguard-shield.log
 ```

 ## Cron-basiertes Entsperren
@@ -130,5 +177,14 @@ Als Alternative oder Ergänzung zum Haupt-Monitor:
 sudo crontab -e

 # Alle 5 Minuten abgelaufene Sperren prüfen
-*/5 * * * * /opt/adguard-ratelimit/unban-expired.sh
+*/5 * * * * /opt/adguard-shield/unban-expired.sh
+```
+
+## Hilfe
+
+Alle verfügbaren Befehle und Optionen des Installers anzeigen:
+
+```bash
+sudo bash install.sh --help
+sudo bash install.sh -h
 ```
--- a/doc/benachrichtigungen.md
+++ b/doc/benachrichtigungen.md
@@ -4,7 +4,7 @@ Das Tool kann bei Sperren und Entsperrungen Benachrichtigungen an verschiedene D

 ## Aktivierung

-In der Konfiguration (`adguard-ratelimit.conf`):
+In der Konfiguration (`adguard-shield.conf`):

 ```bash
 NOTIFY_ENABLED=true
@@ -18,7 +18,7 @@ NOTIFY_WEBHOOK_URL="<url>"
 NOTIFY_ENABLED=true
 NOTIFY_TYPE="ntfy"
 NTFY_SERVER_URL="https://ntfy.sh"
-NTFY_TOPIC="adguard-ratelimit"
+NTFY_TOPIC="adguard-shield"
 NTFY_TOKEN=""
 NTFY_PRIORITY="4"
 ```
@@ -94,7 +94,7 @@ Sendet einen POST mit JSON-Body:

 ```json
 {
-  "message": "🚫 DNS Rate-Limit: Client 192.168.1.50 gesperrt ...",
+  "message": "🚫 AdGuard Shield: Client 192.168.1.50 gesperrt ...",
  "action": "ban",
  "client": "192.168.1.50",
  "domain": "microsoft.com"
@@ -104,7 +104,7 @@ Sendet einen POST mit JSON-Body:
 ## Beispiel-Nachrichten

 **Sperre:**
-> 🚫 DNS Rate-Limit: Client **192.168.1.50** gesperrt (45x microsoft.com in 60s). Sperre für 3600s.
+> 🚫 AdGuard Shield: Client **192.168.1.50** gesperrt (45x microsoft.com in 60s). Sperre für 3600s.

 **Entsperrung:**
-> ✅ DNS Rate-Limit: Client **192.168.1.50** wurde entsperrt.
+> ✅ AdGuard Shield: Client **192.168.1.50** wurde entsperrt.
--- a/doc/konfiguration.md
+++ b/doc/konfiguration.md
@@ -3,9 +3,21 @@
 Die Konfigurationsdatei liegt nach der Installation unter:

 ```
-/opt/adguard-ratelimit/adguard-ratelimit.conf
+/opt/adguard-shield/adguard-shield.conf
 ```

+## Automatische Konfigurations-Migration
+
+Bei einem **Update** (`sudo bash install.sh update`) wird die Konfiguration automatisch migriert:
+
+1. Die aktuelle Konfiguration wird als **Backup** gespeichert: `adguard-shield.conf.old`
+2. Neue Parameter (die in der alten Konfig noch nicht existieren) werden **automatisch** zur bestehenden Konfiguration hinzugefügt
+3. Alle bestehenden Einstellungen bleiben **unverändert** erhalten
+
+Dadurch muss der Benutzer bei Updates die Konfiguration nicht manuell austauschen oder vergleichen.
+
+> **Hinweis:** Nach einem Update empfiehlt es sich, die eventuell neu hinzugefügten Parameter zu prüfen und bei Bedarf anzupassen.
+
 ## Alle Parameter

 ### AdGuard Home API
@@ -30,7 +42,7 @@ Die Konfigurationsdatei liegt nach der Installation unter:
 | Parameter | Standard | Beschreibung |
 |-----------|----------|--------------|
 | `BAN_DURATION` | `3600` | Sperrdauer in Sekunden (3600 = 1 Stunde) |
-| `IPTABLES_CHAIN` | `ADGUARD_RATELIMIT` | Name der iptables Chain |
+| `IPTABLES_CHAIN` | `ADGUARD_SHIELD` | Name der iptables Chain |
 | `BLOCKED_PORTS` | `53 443 853 784 8853` | Ports die gesperrt werden |
 | `WHITELIST` | `127.0.0.1,::1` | IPs die nie gesperrt werden (kommagetrennt) |

@@ -38,10 +50,10 @@ Die Konfigurationsdatei liegt nach der Installation unter:

 | Parameter | Standard | Beschreibung |
 |-----------|----------|--------------|
-| `LOG_FILE` | `/var/log/adguard-ratelimit.log` | Pfad zur Log-Datei |
+| `LOG_FILE` | `/var/log/adguard-shield.log` | Pfad zur Log-Datei |
 | `LOG_LEVEL` | `INFO` | Log-Level: `DEBUG`, `INFO`, `WARN`, `ERROR` |
 | `LOG_MAX_SIZE_MB` | `50` | Max. Log-Größe bevor rotiert wird |
-| `BAN_HISTORY_FILE` | `/var/log/adguard-ratelimit-bans.log` | Datei für die Ban-History (alle Sperren/Entsperrungen) |
+| `BAN_HISTORY_FILE` | `/var/log/adguard-shield-bans.log` | Datei für die Ban-History (alle Sperren/Entsperrungen) |

 ### Benachrichtigungen

@@ -55,8 +67,8 @@ Die Konfigurationsdatei liegt nach der Installation unter:

 | Parameter | Standard | Beschreibung |
 |-----------|----------|--------------|
-| `STATE_DIR` | `/var/lib/adguard-ratelimit` | Verzeichnis für State-Dateien |
-| `PID_FILE` | `/var/run/adguard-ratelimit.pid` | PID-Datei |
+| `STATE_DIR` | `/var/lib/adguard-shield` | Verzeichnis für State-Dateien |
+| `PID_FILE` | `/var/run/adguard-shield.pid` | PID-Datei |
 | `DRY_RUN` | `false` | Testmodus — nur loggen, nicht sperren |
 ### Externe Blocklist

@@ -69,7 +81,7 @@ Ermöglicht das Einbinden externer IP-Blocklisten (z.B. gehostete Textdateien mi
 | `EXTERNAL_BLOCKLIST_INTERVAL` | `300` | Prüfintervall in Sekunden (300 = 5 Min.) |
 | `EXTERNAL_BLOCKLIST_BAN_DURATION` | `0` | Sperrdauer in Sekunden (0 = permanent bis IP aus Liste entfernt) |
 | `EXTERNAL_BLOCKLIST_AUTO_UNBAN` | `true` | IPs automatisch entsperren wenn aus Liste entfernt |
-| `EXTERNAL_BLOCKLIST_CACHE_DIR` | `/var/lib/adguard-ratelimit/external-blocklist` | Lokaler Cache für heruntergeladene Listen |
+| `EXTERNAL_BLOCKLIST_CACHE_DIR` | `/var/lib/adguard-shield/external-blocklist` | Lokaler Cache für heruntergeladene Listen |

 #### Externe Blocklist einrichten

@@ -99,7 +111,7 @@ EXTERNAL_BLOCKLIST_URLS="https://example.com/list1.txt,https://other.com/list2.t
 4. Service neustarten:

 ```bash
-sudo systemctl restart adguard-ratelimit
+sudo systemctl restart adguard-shield
 ```
 ## Gesperrte Ports im Detail

--- a/doc/tipps-und-troubleshooting.md
+++ b/doc/tipps-und-troubleshooting.md
@@ -4,7 +4,7 @@

 - **Erst immer im Dry-Run testen**, bevor der scharfe Modus aktiviert wird
  ```bash
-  sudo /opt/adguard-ratelimit/adguard-ratelimit.sh dry-run
+  sudo /opt/adguard-shield/adguard-shield.sh dry-run
  ```
 - **Whitelist großzügig pflegen**: Eigene IPs, Router, wichtige Server nicht vergessen
 - **Sperrdauer anpassen**: Für DDoS-artige Muster ggf. länger sperren
@@ -17,7 +17,7 @@
 ### API-Verbindung schlägt fehl

 ```bash
-sudo /opt/adguard-ratelimit/adguard-ratelimit.sh test
+sudo /opt/adguard-shield/adguard-shield.sh test
 ```

 **Mögliche Ursachen:**
@@ -36,23 +36,23 @@ curl -s -u admin:passwort http://127.0.0.1:3000/control/querylog?limit=1
 Das Script muss als **root** laufen, da iptables Root-Rechte benötigt.

 ```bash
-sudo /opt/adguard-ratelimit/adguard-ratelimit.sh start
+sudo /opt/adguard-shield/adguard-shield.sh start
 ```

 ### Client wird fälschlich gesperrt

 1. Client sofort entsperren:
   ```bash
-   sudo /opt/adguard-ratelimit/adguard-ratelimit.sh unban 192.168.1.100
+   sudo /opt/adguard-shield/adguard-shield.sh unban 192.168.1.100
   ```
 2. In der Ban-History prüfen, warum gesperrt wurde:
   ```bash
-   sudo /opt/adguard-ratelimit/adguard-ratelimit.sh history | grep 192.168.1.100
+   sudo /opt/adguard-shield/adguard-shield.sh history | grep 192.168.1.100
   ```
-3. IP zur Whitelist hinzufügen in `adguard-ratelimit.conf`
+3. IP zur Whitelist hinzufügen in `adguard-shield.conf`
 3. Service neustarten:
   ```bash
-   sudo systemctl restart adguard-ratelimit
+   sudo systemctl restart adguard-shield
   ```

 ### Sperren überleben Reboot nicht
@@ -73,22 +73,55 @@ Das ist normal — iptables-Regeln sind flüchtig. Der **Service** erstellt die

 ```bash
 # Altes PID-File entfernen
-sudo rm -f /var/run/adguard-ratelimit.pid
-sudo systemctl start adguard-ratelimit
+sudo rm -f /var/run/adguard-shield.pid
+sudo systemctl start adguard-shield
 ```

+## Update durchführen
+
+```bash
+# Repository aktualisieren
+cd /tmp/adguard-shield
+git pull
+
+# Update ausführen (Konfig wird automatisch migriert, Service neu gestartet)
+sudo bash install.sh update
+```
+
+**Was passiert beim Update:**
+- Alle Scripts werden aktualisiert
+- Konfiguration wird als `adguard-shield.conf.old` gesichert
+- Neue Konfigurationsparameter werden automatisch zur bestehenden Konfig ergänzt
+- Bestehende Einstellungen bleiben erhalten
+- Service wird per `daemon-reload` neu geladen und automatisch neu gestartet
+
 ## Deinstallation

 ```bash
+# Über den Installer (interaktiv mit Menü)
 sudo bash install.sh uninstall
 ```

 Oder manuell:
 ```bash
-sudo systemctl stop adguard-ratelimit
-sudo systemctl disable adguard-ratelimit
-sudo /opt/adguard-ratelimit/iptables-helper.sh remove
-sudo rm -rf /opt/adguard-ratelimit
-sudo rm -f /etc/systemd/system/adguard-ratelimit.service
+sudo systemctl stop adguard-shield
+sudo systemctl disable adguard-shield
+sudo /opt/adguard-shield/iptables-helper.sh remove
+sudo rm -rf /opt/adguard-shield
+sudo rm -f /etc/systemd/system/adguard-shield.service
 sudo systemctl daemon-reload
 ```
+
+## Voraussetzungen
+
+Folgende Pakete werden für den Betrieb benötigt und bei der Installation automatisch installiert:
+
+| Paket | Zweck |
+|-------|-------|
+| `curl` | API-Kommunikation mit AdGuard Home |
+| `jq` | JSON-Verarbeitung der API-Antworten |
+| `iptables` | Firewall-Regeln (IPv4 + IPv6) |
+| `gawk` | Textverarbeitung in Scripts |
+| `systemd` | Service-Management und Autostart |
+
+Diese werden bei `sudo bash install.sh install` automatisch geprüft und bei Bedarf über den Paketmanager (`apt`, `dnf`, `yum`, `pacman`) nachinstalliert.