{"id":277,"date":"2026-07-09T20:36:00","date_gmt":"2026-07-09T18:36:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/blog\/?p=277"},"modified":"2026-10-24T00:39:06","modified_gmt":"2026-10-23T22:39:06","slug":"raspberry-pi-backups-auf-ein-unifi-nas-automatisieren","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/de\/it-networks-de\/raspberry-pi-backups-auf-ein-unifi-nas-automatisieren\/","title":{"rendered":"Raspberry-Pi-Backups auf ein UniFi-NAS automatisieren"},"content":{"rendered":"

Eine t\u00e4gliche Kopie auf einem UniFi UNAS Pro erg\u00e4nzt die Anwendungsdaten des Raspberry Pi um einen zweiten Speicherort. Das Beispiel sichert ausgew\u00e4hlte Verzeichnisse und MySQL-Datenbanken \u00fcber SMB, ein Protokoll f\u00fcr Netzwerkfreigaben. F\u00fcr einen belastbaren Wiederherstellungsplan fehlen anschlie\u00dfend noch R\u00fccksicherungstests und eine getrennte Offline- oder Au\u00dfer-Haus-Kopie.<\/p>\n

Voraussetzungen und Umfang<\/h2>\n

Das Beispiel verwendet das Linux-Konto pi<\/code>, das Heimatverzeichnis \/home\/pi<\/code>, Bash und einen passenden MySQL-Dump-Client. Kontoname, numerische Benutzer- und Gruppenkennung, Datenbanken und Quellverzeichnisse m\u00fcssen zur Installation passen. Das Sicherungskonto ben\u00f6tigt Leserechte auf alle Quellen. Ein laufendes Docker-Datenbankverzeichnis l\u00e4sst sich durch blo\u00dfes Hinzuf\u00fcgen zu tar<\/code> nicht konsistent sichern.<\/p>\n

1. NAS vorbereiten<\/h2>\n

In UniFi Drive dient eine Freigabe namens Pi_Backups<\/code> als Ziel. Ein eigenes Sicherungskonto ben\u00f6tigt Schreibrechte auf diese Freigabe sowie Dateidienst-Zugangsdaten f\u00fcr SMB. Das Passwort f\u00fcr die UniFi-Konsole ist nicht zwangsl\u00e4ufig das SMB-Passwort. Der SMB-Dienst muss aktiviert sein; genaue Bezeichnungen h\u00e4ngen von der installierten Drive-Version ab.<\/p>\n

2. SMB-Freigabe einbinden<\/h2>\n

Das Paket cifs-utils<\/code> stellt das Hilfsprogramm zum Einbinden der SMB-Freigabe bereit. Die folgenden Einrichtungsschritte ben\u00f6tigen Administratorrechte:<\/p>\n

sudo apt update\nsudo apt install cifs-utils\nsudo mkdir -p \/mnt\/unas_backup<\/code><\/pre>\n
Die mit sudo nano \/etc\/.unas_creds<\/code> angelegte Datei enth\u00e4lt zwei Zeilen:<\/p>\n
username=backup_user\npassword=REPLACE_WITH_SMB_PASSWORD<\/code><\/pre>\n
Das Passwort bleibt in dieser Datei im Klartext gespeichert. Dateirechte beschr\u00e4nken den Zugriff; ein Punkt am Dateianfang verschl\u00fcsselt nichts. Eigent\u00fcmer muss root sein:<\/p>\n
sudo chown root:root \/etc\/.unas_creds\nsudo chmod 600 \/etc\/.unas_creds<\/code><\/pre>\n
Der folgende Eintrag geh\u00f6rt in \/etc\/fstab<\/code>. Adresse und Freigabename sind Beispiele. UID und GID 1000 m\u00fcssen zum Sicherungskonto passen; id pi<\/code> zeigt die tats\u00e4chlichen Werte. Zus\u00e4tzlich gelten weiterhin die Zugriffsrechte auf dem NAS.<\/p>\n
\/\/192.168.1.XXX\/Pi_Backups \/mnt\/unas_backup cifs credentials=\/etc\/.unas_creds,uid=1000,gid=1000,iocharset=utf8,_netdev,nofail 0 0<\/code><\/pre>\n
sudo mount \/mnt\/unas_backup<\/code> pr\u00fcft genau diese Einbindung. Mit nofail<\/code> kann der Systemstart ohne NAS weiterlaufen. Eine fehlende Einbindung verhindert trotzdem die Sicherung; nach R\u00fcckkehr des NAS ist ein erneutes Einbinden erforderlich. SMB bedeutet nicht automatisch verschl\u00fcsselte \u00dcbertragung. Verschl\u00fcsselungsanforderungen ben\u00f6tigen eine eigene Konfiguration und Pr\u00fcfung.<\/p>\n
3. Datenbankzugang einrichten<\/h2>\n
Die Datei \/home\/pi\/.my.cnf<\/code> geh\u00f6rt dem ausf\u00fchrenden Konto und enth\u00e4lt die unten angegebenen Datenbank-Zugangsdaten. chmod 600 \/home\/pi\/.my.cnf<\/code> beschr\u00e4nkt den Zugriff. Das separate Datenbankkonto ben\u00f6tigt die f\u00fcr die gew\u00e4hlten Dump-Optionen dokumentierten Rechte, einschlie\u00dflich Routinen und Ereignissen.<\/p>\n
[client]\nuser=backup_user\npassword=REPLACE_WITH_DATABASE_PASSWORD<\/code><\/pre>\n
4. Sicherungsskript speichern<\/h2>\n
Das folgende Skript geh\u00f6rt nach \/home\/pi\/pi_backup.sh<\/code>. Vor dem Einsatz sind app1 app2<\/code> und TARGET_FOLDERS<\/code> durch die tats\u00e4chlichen Datenbanken und Verzeichnisse zu ersetzen. F\u00fcr MariaDB sind der installierte Client mariadb-dump<\/code> und dessen unterst\u00fctzte Optionen gesondert zu pr\u00fcfen.<\/p>\n
#!\/bin\/bash\nset -euo pipefail\numask 077\nPATH=\/usr\/local\/bin:\/usr\/bin:\/bin\nNAS_MOUNT=\"\/mnt\/unas_backup\"\nTARGET_FOLDERS=(\/var\/www\/html \/etc\/nginx)\nDATABASES=(app1 app2)\nexec 9>\/home\/pi\/.pi-backup.lock\nflock -n 9 || { echo \"Backup already running\" >&2; exit 1; }\nmountpoint -q \"$NAS_MOUNT\" || { echo \"NAS is not mounted\" >&2; exit 1; }\n[[ $(findmnt -n -o FSTYPE --target \"$NAS_MOUNT\") == cifs ]] || exit 1\nBACKUP_ID=$(date +%Y-%m-%d_%H-%M-%S)\nWORK_DIR=\"$NAS_MOUNT\/.partial-$BACKUP_ID\"\nDEST_DIR=\"$NAS_MOUNT\/$BACKUP_ID\"\nmkdir -- \"$WORK_DIR\"\ntrap 'echo \"Backup failed; incomplete directory: $WORK_DIR\" >&2' ERR\nmysqldump --defaults-extra-file=\/home\/pi\/.my.cnf   --single-transaction --routines --events --triggers   --databases \"${DATABASES[@]}\" | gzip > \"$WORK_DIR\/databases.sql.gz\"\ngzip -t \"$WORK_DIR\/databases.sql.gz\"\ntar -czf \"$WORK_DIR\/files.tar.gz\" -- \"${TARGET_FOLDERS[@]}\"\ntar -tzf \"$WORK_DIR\/files.tar.gz\" > \/dev\/null\nprintf '%s\\n' \"$BACKUP_ID\" > \"$WORK_DIR\/COMPLETE\"\nmv -- \"$WORK_DIR\" \"$DEST_DIR\"\necho \"Backup written: $DEST_DIR\"\n<\/code><\/pre>\n
pipefail<\/code> macht Dump-Fehler sichtbar, die ein erfolgreiches gzip sonst verdeckt. Bei einem fehlgeschlagenen Dump oder Dateiarchiv bricht dieser geradlinige Ablauf ab. Unvollst\u00e4ndige L\u00e4ufe behalten ein Verzeichnis mit .partial-<\/code>; der endg\u00fcltige Ordner entsteht erst nach beiden Archivpr\u00fcfungen. Diese Pr\u00fcfungen erkennen besch\u00e4digte Archive, belegen aber weder logische Vollst\u00e4ndigkeit noch Wiederherstellbarkeit.<\/p>\n
--single-transaction<\/code> liefert f\u00fcr transaktionale Tabellen wie InnoDB einen konsistenten Datenstand. Nichttransaktionale Tabellen und gleichzeitige Schema\u00e4nderungen erfordern eine andere Sicherungsstrategie. Die anschlie\u00dfend kopierten Dateien geh\u00f6ren nicht automatisch zum selben Zeitpunkt wie der Datenbankstand. Anwendungen mit zusammengeh\u00f6rigen Uploads und Datenbankeintr\u00e4gen ben\u00f6tigen ein abgestimmtes Wartungsfenster oder ein geeignetes Snapshot-Verfahren.<\/p>\n
5. Zeitplan und Kontrolle<\/h2>\n
Nach chmod +x \/home\/pi\/pi_backup.sh<\/code> muss ein manueller Lauf unter demselben Konto erfolgreich sein. Der folgende Eintrag in crontab -e<\/code> des Kontos pi<\/code> startet die Sicherung um 02:00 Uhr in der lokalen Zeitzone des Cron-Dienstes:<\/p>\n
0 2 * * * \/home\/pi\/pi_backup.sh >> \/home\/pi\/backup_log.txt 2>&1<\/code><\/pre>\n
Das Protokoll w\u00e4chst durch Anh\u00e4ngen und ben\u00f6tigt deshalb eine Rotation. Eine \u00dcberwachung muss fehlgeschlagene L\u00e4ufe und ausbleibende aktuelle Sicherungen erkennen. Das Skript l\u00f6scht bewusst keine alten Kopien. Vor dem L\u00f6schen braucht es eine Aufbewahrungsregel, die freien Platz, unvollst\u00e4ndige L\u00e4ufe und den letzten gepr\u00fcften Wiederherstellungspunkt ber\u00fccksichtigt.<\/p>\n
\n\"Sicherungsablauf
Sicherungsablauf mit Sperre, Einbindungspr\u00fcfung, Teilverzeichnis, gepr\u00fcften Archiven und endg\u00fcltigem Ordner; keine automatische L\u00f6schung.<\/figcaption><\/figure>\n
\n
Fragen und Antworten<\/h2>\n
Ist damit der gesamte Raspberry Pi gesichert?<\/h3>\n
Nein. Gesichert werden die ausgew\u00e4hlten Anwendungsdatenbanken und Verzeichnisse. Betriebssysteminstallation, Bootkonfiguration, Datenbankkonten und ausgelassene Dienste ben\u00f6tigen einen gesondert dokumentierten Wiederherstellungsablauf.<\/p>\n
Wann ist eine Sicherung verwendbar?<\/h3>\n
Erst eine R\u00fccksicherung auf einem isolierten Testsystem belegt die Wiederherstellbarkeit. Dazu geh\u00f6ren eine kompatible Datenbankversion, SQL-Import, entpackte Dateien und ein Funktionstest der Anwendung. Eine Gr\u00f6\u00dfenpr\u00fcfung oder eine COMPLETE-Markierung ersetzt diesen Test nicht.<\/p>\n
Warum fehlt die automatische Bereinigung?<\/h3>\n
Das L\u00f6schen alter Kopien nach einem ungepr\u00fcften Lauf kann den letzten nutzbaren Wiederherstellungspunkt vernichten. Eine getrennte Aufbewahrungsregel muss erfolgreiche R\u00fccksicherungen und freien Speicher ber\u00fccksichtigen.<\/p>\n<\/div>\n
\n
Quellen<\/h2>\n