Files
adguard-shield/doc/update.md
scriptos 4f679cadd4 feat: Progressive Sperren (Recidive) – Wiederholungstäter werden stufenweise länger gesperrt
- Neues Recidive-System: Sperrdauer steigt exponentiell bei wiederholten Verstößen (wie fail2ban)
- Konfigurierbar: Multiplikator, Max-Stufe mit permanenter Sperre, Zähler-Reset-Zeit
- Offense-Tracking via *.offenses State-Dateien
- Permanente Sperren werden nicht automatisch aufgehoben
- Neuer Befehl: reset-offenses [IP] zum Zurücksetzen der Offense-Zähler
- Status-Anzeige zeigt Stufe, Dauer und Wiederholungstäter-Übersicht
- Benachrichtigungen enthalten Stufe und progressive Sperrdauer
- unban-expired.sh berücksichtigt permanente Sperren
- Dokumentation vollständig aktualisiert (Konfig, Befehle, Architektur, Troubleshooting, README)
2026-03-03 22:16:29 +01:00

2.0 KiB

Update-Anleitung

Voraussetzungen

  • AdGuard Shield ist bereits installiert (/opt/adguard-shield/)
  • Git ist installiert (sudo apt install git)
  • Zugriff auf den Server per SSH mit Root-Rechten

Update durchführen

1. Git-Repository aktualisieren

Wechsle in das Verzeichnis, in dem du das Repository geklont hast, und hole die neueste Version:

cd /pfad/zum/adguard-shield
git pull

Hinweis: Falls du das Repository z.B. nach /opt/adguard-shield-repo geklont hast:

cd /opt/adguard-shield-repo
git pull

2. Update-Script ausführen

sudo bash install.sh update

Das Update-Script macht automatisch folgendes:

  1. Abhängigkeiten prüfen — Fehlende Pakete werden nachinstalliert
  2. Scripts aktualisieren — Alle .sh-Dateien werden nach /opt/adguard-shield/ kopiert
  3. Konfigurations-Migration — Neue Parameter werden automatisch zur bestehenden Konfiguration hinzugefügt, bestehende Einstellungen bleiben unverändert
  4. Backup erstellen — Die alte Konfiguration wird als adguard-shield.conf.old gesichert
  5. Service aktualisieren — Die systemd Service-Datei wird aktualisiert und daemon-reload ausgeführt
  6. Service neustarten — Der Service wird automatisch neu gestartet (falls er vorher lief)

3. Neue Parameter prüfen (optional)

Nach dem Update empfiehlt es sich, eventuell neu hinzugefügte Konfigurationsparameter zu prüfen:

sudo nano /opt/adguard-shield/adguard-shield.conf

Falls etwas nicht stimmt, kann das Backup wiederhergestellt werden:

sudo cp /opt/adguard-shield/adguard-shield.conf.old /opt/adguard-shield/adguard-shield.conf
sudo systemctl restart adguard-shield

Kurzfassung (Copy & Paste)

cd /pfad/zum/adguard-shield
git pull
sudo bash install.sh update

Versionsprüfung

Installierte Version anzeigen:

sudo /opt/adguard-shield/adguard-shield.sh status

Oder über den Installer:

sudo bash install.sh status