Doku zu den Befehlen aktualisiert

.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

adguard-shield.sh

@@ -987,22 +987,30 @@ case "${1:-start}" in
         cat << USAGE
 AdGuard Shield v${VERSION}
 
-Nutzung: $0 {start|stop|status|history|flush|unban|reset-offenses|test|dry-run|blocklist-status|blocklist-sync|blocklist-flush}
+Service-Steuerung (empfohlen):
+  sudo systemctl start adguard-shield
+  sudo systemctl stop adguard-shield
+  sudo systemctl restart adguard-shield
+  sudo systemctl status adguard-shield
 
-Befehle:
-  start              Startet den Monitor (inkl. Blocklist-Worker)
-  stop               Stoppt den Monitor
+Nutzung: $0 {status|history|flush|unban|reset-offenses|test|dry-run|blocklist-status|blocklist-sync|blocklist-flush}
+
+Verwaltungsbefehle:
   status             Zeigt aktive Sperren, Regeln und Wiederholungstäter
   history [N]        Zeigt die letzten N Ban-Einträge (Standard: 50)
   flush              Hebt alle Sperren auf
   unban IP           Entsperrt eine bestimmte IP-Adresse
   reset-offenses [IP] Setzt Offense-Zähler zurück (alle oder eine bestimmte IP)
   test               Testet die Verbindung zur AdGuard Home API
-  dry-run            Startet im Testmodus (keine echten Sperren)
+  dry-run            Startet im Testmodus (keine echten Sperren, Vordergrund!)
   blocklist-status   Zeigt Status der externen Blocklisten
   blocklist-sync     Einmalige Synchronisation der externen Blocklisten
   blocklist-flush    Entfernt alle Sperren der externen Blocklisten
 
+Interne Befehle (nicht direkt verwenden — nur über systemd):
+  start              Startet den Monitor im Vordergrund
+  stop               Stoppt den Monitor
+
 Konfiguration: $CONFIG_FILE
 Log-Datei:     $LOG_FILE
 Ban-History:   $BAN_HISTORY_FILE

doc/befehle.md

@@ -43,15 +43,31 @@ Folgende Pakete werden bei der Installation automatisch installiert (via `apt`):
 - `gawk` — Textverarbeitung
 - `systemd` — Service-Management
 
-## Monitor (Hauptscript)
+## systemd Service
+
+AdGuard Shield wird als systemd Service betrieben. **Zum Starten, Stoppen und Neustarten immer `systemctl` verwenden:**
 
 ```bash
-# Starten
-sudo /opt/adguard-shield/adguard-shield.sh start
+# Start / Stop / Restart
+sudo systemctl start adguard-shield
+sudo systemctl stop adguard-shield
+sudo systemctl restart adguard-shield
 
-# Stoppen
-sudo /opt/adguard-shield/adguard-shield.sh stop
+# Status
+sudo systemctl status adguard-shield
 
+# Autostart aktivieren / deaktivieren
+sudo systemctl enable adguard-shield
+sudo systemctl disable adguard-shield
+```
+
+> **Hinweis:** Der Service wird bei der Installation automatisch für den Autostart beim Booten aktiviert. Nach einem Update wird der Service automatisch neu gestartet — ein manueller Neustart ist nicht nötig.
+
+## Monitor — Verwaltungsbefehle
+
+Die folgenden Befehle dienen der **Verwaltung und Diagnose** und können jederzeit ausgeführt werden, auch während der Service läuft:
+
+```bash
 # Status + aktive Sperren anzeigen
 sudo /opt/adguard-shield/adguard-shield.sh status
 
@@ -70,7 +86,7 @@ sudo /opt/adguard-shield/adguard-shield.sh unban 192.168.1.100
 # API-Verbindung testen
 sudo /opt/adguard-shield/adguard-shield.sh test
 
-# Dry-Run (nur loggen, nichts sperren)
+# Dry-Run (nur loggen, nichts sperren — läuft im Vordergrund!)
 sudo /opt/adguard-shield/adguard-shield.sh dry-run
 
 # Offense-Zähler für alle IPs zurücksetzen (Progressive Sperren)
@@ -89,6 +105,8 @@ sudo /opt/adguard-shield/adguard-shield.sh blocklist-sync
 sudo /opt/adguard-shield/adguard-shield.sh blocklist-flush
 ```
 
+> **⚠ Wichtig:** Zum Starten und Stoppen des Monitors **nicht** `adguard-shield.sh start` bzw. `stop` verwenden! Diese Befehle starten den Prozess im **Vordergrund** — die Ausgabe wird live angezeigt und `Strg+C` beendet den gesamten Prozess. Stattdessen immer `sudo systemctl start/stop/restart adguard-shield` nutzen.
+
 ## iptables Helper
 
 Für die manuelle Verwaltung der Firewall-Regeln:
@@ -138,26 +156,6 @@ sudo /opt/adguard-shield/external-blocklist-worker.sh status
 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-shield
-sudo systemctl stop adguard-shield
-sudo systemctl restart adguard-shield
-
-# Status
-sudo systemctl status adguard-shield
-
-# Autostart aktivieren / deaktivieren
-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

install.sh

@@ -77,8 +77,15 @@ print_help() {
     echo -e "  ${CYAN}sudo bash install.sh uninstall${NC}                         # Deinstallation"
     echo -e "  ${CYAN}sudo bash install.sh status${NC}                           # Status prüfen"
     echo ""
+    echo -e "${BOLD}Service-Befehle:${NC}"
+    echo -e "  ${CYAN}sudo systemctl start adguard-shield${NC}                    # Service starten"
+    echo -e "  ${CYAN}sudo systemctl stop adguard-shield${NC}                     # Service stoppen"
+    echo -e "  ${CYAN}sudo systemctl restart adguard-shield${NC}                  # Service neustarten"
+    echo -e "  ${CYAN}sudo systemctl status adguard-shield${NC}                   # Service-Status"
+    echo -e "  ${CYAN}sudo journalctl -u adguard-shield -f${NC}                   # Logs live verfolgen"
+    echo ""
     echo -e "${BOLD}Monitor-Befehle (nach Installation):${NC}"
-    echo -e "  ${CYAN}sudo /opt/adguard-shield/adguard-shield.sh start${NC}       # Monitor starten"
+    echo -e "  ${CYAN}sudo /opt/adguard-shield/adguard-shield.sh start${NC}       # Monitor im Vordergrund starten"
     echo -e "  ${CYAN}sudo /opt/adguard-shield/adguard-shield.sh stop${NC}        # Monitor stoppen"
     echo -e "  ${CYAN}sudo /opt/adguard-shield/adguard-shield.sh status${NC}      # Status & aktive Sperren"
     echo -e "  ${CYAN}sudo /opt/adguard-shield/adguard-shield.sh history${NC}     # Ban-History anzeigen"
@@ -97,13 +104,6 @@ print_help() {
     echo -e "  ${CYAN}sudo /opt/adguard-shield/iptables-helper.sh save${NC}       # Regeln speichern"
     echo -e "  ${CYAN}sudo /opt/adguard-shield/iptables-helper.sh restore${NC}    # Regeln wiederherstellen"
     echo ""
-    echo -e "${BOLD}Service-Befehle:${NC}"
-    echo -e "  ${CYAN}sudo systemctl start adguard-shield${NC}                    # Service starten"
-    echo -e "  ${CYAN}sudo systemctl stop adguard-shield${NC}                     # Service stoppen"
-    echo -e "  ${CYAN}sudo systemctl restart adguard-shield${NC}                  # Service neustarten"
-    echo -e "  ${CYAN}sudo systemctl status adguard-shield${NC}                   # Service-Status"
-    echo -e "  ${CYAN}sudo journalctl -u adguard-shield -f${NC}                   # Logs live verfolgen"
-    echo ""
     echo -e "${BOLD}Voraussetzungen:${NC}"
     echo "  - Linux Server (Debian/Ubuntu empfohlen)"
     echo "  - Root-Zugriff (sudo)"