Backups & Telegram-Benachrichtigungen automatisieren

TL;DR

Backups zählen nur, wenn man weiß, dass sie auch wirklich funktioniert haben. Ich habe ein Skript geschrieben, das Mounts, Duplicati-Jobs und Docker-Backups prüft und mir bei Problemen direkt über Telegram Bescheid gibt.

Warum ich stillen Backups nicht mehr traue

Wenn du einen Homeserver betreibst, kennst du das Gefühl bestimmt: Du richtest einmal einen Backup-Job ein, siehst, dass er ohne Fehler durchläuft, und vergisst ihn für Monate. Alles fühlt sich sicher an – bis zu dem Tag, an dem du wirklich etwas wiederherstellen musst und merkst, dass die externe Festplatte vor drei Wochen ausgehängt wurde oder ein Datenbank-Dump heimlich nur 0-Byte-Dateien schreibt.

Ich wollte Schluss mit dem Rätselraten machen. Statt mich alle paar Tage per SSH einzuloggen und durch das Duplicati-Webinterface zu klicken, habe ich mir in /docker/ ein kleines, automatisiertes Prüf- und Benachrichtigungs-Setup gebaut.

Das Prüfskript: check-backups.sh

Das Herzstück ist /docker/check-backups.sh (das ich der Bequemlichkeit halber auch als /docker/backup-status.sh verlinkt habe). Es ist ein Bash-Wrapper, der die eigentliche Arbeit an ein eingebettetes Python-3-Skript übergibt.

Bei jedem Lauf prüft es drei Dinge:

  1. Speicher & Mounts: Es kontrolliert /, /data_safe und /data_external_unsafe per os.statvfs und mountpoint -q. Bei der externen Crucial-SSD (/data_external_unsafe) prüft es außerdem auf eine checkfile-Datei als Canary, damit ich sicher bin, dass wirklich das Laufwerk gemountet ist und nicht nur ein leeres Verzeichnis.
  2. Duplicati-Backups: Statt das Web-UI zu scrapen, öffnet das Skript /docker/duplicati/config/Duplicati-server.sqlite im Read-Only-Modus. Es liest die konfigurierten Jobs, Zeitpläne und eventuelle ErrorLog-Einträge der letzten 14 Tage aus. Für jeden Job schaut es zusätzlich in die jeweilige Job-Datenbank, um den letzten Fileset-Zeitstempel und die gesamte Remotevolume-Größe zu holen – egal ob das Ziel meine Hetzner Storage Box, die Crucial-SSD oder eine Seagate-USB-HDD ist.
  3. Docker-Services: Es prüft den Backup-Status meiner Docker-Stacks und meldet Dinge wie leere Dumps, veraltete Backups oder Skriptfehler.

Dazu gibt es noch ein paar CLI-Flags wie --json, --all, --include-ignored, --full-test (für tiefere Archiv-Tests) und --no-color. Gerade --json macht die Automatisierung super einfach.

Telegram-Alerts mit notify-backup-status.sh

Ein schöner Terminal-Report ist super, wenn ich ohnehin eingeloggt bin – aber eigentlich will ich benachrichtigt werden, wenn etwas klemmt, ohne selbst nachsehen zu müssen. Dafür ist /docker/notify-backup-status.sh da.

Es ist wieder ein Bash-plus-Python-Wrapper, der check-backups.sh --json ausführt und das Ergebnis auswertet. Falls check-backups.sh selbst abstürzt, schickt es sofort einen 🚨 DOCKER BACKUP ALERT über telegram-send.

Ansonsten geht es alle aktiven Docker-Services und Duplicati-Jobs durch und zählt, wie viele gesund sind, wie viele Warnungen haben (z. B. STALE, NOT_IN_CRON oder SCRIPT_ERROR) und wie viele fehlgeschlagen sind (FAILED, NO_BACKUP, EMPTY_DUMP).

Je nach Ergebnis wählt es die passende Überschrift:

  • ✅ Docker Backup Verification: All Healthy
  • ⚠️ Docker Backup Verification: Warnings
  • 🚨 DOCKER BACKUP ALERT: Failures Detected!

Ein kleines Detail, über das ich im Nachhinein sehr froh bin: Telegram erlaubt maximal 4.096 Zeichen pro Nachricht. Falls mal mehrere Dinge gleichzeitig schiefgehen, teilt notify-backup-status.sh die Problemliste automatisch in Häppchen bis 3.900 Zeichen auf, damit nichts abgeschnitten oder von der API abgelehnt wird.

Hat es sich gelohnt?

Auf jeden Fall. Jetzt bekomme ich über /root/.config/telegram-send.conf eine saubere HTML-Zusammenfassung direkt in Telegram. Wenn alles grün ist, hake ich es in zwei Sekunden ab. Wenn etwas gelb oder rot ist, weiß ich sofort, welcher Service oder welches Ziel Aufmerksamkeit braucht – lange bevor ich jemals ein Backup einspielen muss.

Share this post: