rsync: Ordner sichern und synchronisieren, mit Beispielen
Mit rsync spiegelst Du Ordner auf Pi, Server oder SSD: Schrägstrich-Falle, --dry-run vor --delete, SSH, Ausschlüsse, Cronjob und openrsync am Mac.
Von Nathan Base
Du willst Deinen Fotoordner, Deine Projekte oder die Daten eines Raspberry Pi regelmäßig auf einen Server, einen zweiten Pi oder eine externe Platte spiegeln, ohne jedes Mal alles neu zu kopieren. Genau dafür gibt es rsync. Der Befehl hat nur zwei Stellen, an denen er Dich wirklich überraschen kann: den Schrägstrich am Ende des Quellpfads und die Option --delete. Beide nehmen wir uns hier mit echter Ausgabe vor, danach geht es um SSH, Ausschlüsse, einen Cronjob und die Eigenheiten des rsync auf dem Mac.
Alle Beispiele sind getestet: unter Debian 13 „Trixie“ mit rsync 3.5.0 in einem Docker-Container (dieselbe Basis wie das aktuelle Raspberry Pi OS), unter macOS 27.2 Golden Gate mit dem dort mitgelieferten openrsync und von diesem Mac per SSH auf den Debian-Container.
Was rsync anders macht als cp und scp
cp und scp kopieren stur alles, was Du ihnen gibst. rsync vergleicht vorher Quelle und Ziel, standardmäßig über Dateigröße und Änderungszeit, und überträgt nur, was fehlt oder sich geändert hat. Der zweite Lauf über einen großen Ordner dauert deshalb oft nur Sekunden. Bricht eine Übertragung ab, macht rsync mit den fehlenden Dateien weiter, statt von vorn zu beginnen.
Für einzelne Dateien bleibt scp die schnellere Wahl, wie es Dateien per scp zwischen Mac und Raspberry Pi kopieren zeigt. Sobald Du einen Ordner wiederholt abgleichen willst, ist rsync das richtige Werkzeug.
Unter Raspberry Pi OS und Debian installierst Du rsync, falls es fehlt, mit:
sudo apt install rsyncFür Übertragungen per SSH muss rsync auf beiden Seiten installiert sein.
Die Grundform: rsync -avh —progress
Fast jeder rsync-Aufruf beginnt so:
rsync -avh --progress ~/Fotos/ /media/anna/SSD/Fotos/Erst kommt die Quelle, dann das Ziel, hier eine externe Platte unter Linux (am Mac liegt sie unter /Volumes/<Name der Platte>). Die Optionen bedeuten:
-a(Archivmodus) kopiert Unterordner mit und behält Rechte, Zeitstempel, symbolische Links und die Gruppe bei, den Besitzer nur, wenn rsync mit Root-Rechten läuft. Laut der rsync man page entspricht es-rlptgoD.-vzeigt jede übertragene Datei an.-hgibt Größen lesbar aus, also1.07Kstatt1070.--progresszeigt pro Datei einen Fortschritt, was bei großen Videos oder Images hilfreich ist.
Existiert der Zielordner Fotos noch nicht, legt rsync ihn an. Das gilt allerdings nur für die letzte Ebene: Fehlt auch SSD, etwa weil die Platte nicht eingehängt ist, bricht rsync mit einer Fehlermeldung ab, statt stillschweigend einen falschen Ordner anzulegen.
Der Schrägstrich am Quellpfad
Das ist die Stelle, an der die meisten zum ersten Mal stolpern. Ein Schrägstrich am Ende der Quelle bedeutet „kopiere den Inhalt dieses Ordners“, ohne Schrägstrich heißt es „kopiere den Ordner selbst“. Am Ziel ist der Schrägstrich egal. Die Ausgaben unten stammen aus dem Test und sind auf die wichtigen Zeilen gekürzt.
Mit Schrägstrich landen die Dateien direkt im Ziel:
rsync -avh Fotos/ ziel/created directory ziel
./
bild1.jpg
2026/
2026/bild2.jpgOhne Schrägstrich entsteht im Ziel ein zusätzlicher Ordner Fotos:
rsync -avh Fotos ziel/created directory ziel
Fotos/
Fotos/bild1.jpg
Fotos/2026/
Fotos/2026/bild2.jpgAchte auf die erste Zeile nach created directory: Steht dort ./, wird der Inhalt kopiert, steht dort Fotos/, der Ordner. Gewöhn Dir an, Quelle und Ziel immer beide mit Schrägstrich zu schreiben (Fotos/ nach Backup/Fotos/). Dann weißt Du ohne Nachdenken, wo die Dateien landen, und --delete bezieht sich garantiert auf den richtigen Ordner.
Erst —dry-run, dann —delete
Ohne weitere Option löscht rsync im Ziel nie etwas. Hast Du in der Quelle eine Datei entfernt, bleibt sie im Backup liegen. Für einen echten Spiegel brauchst Du --delete, das alles im Ziel löscht, was in der Quelle nicht mehr existiert. Mit einem falschen Pfad kann das einen ganzen Ordner leeren.
Deshalb lässt Du jeden neuen --delete-Befehl zuerst mit --dry-run (kurz -n) laufen. rsync zeigt dann an, was es tun würde, ohne etwas zu verändern:
rsync -avh --dry-run --delete Fotos/ ziel/sending incremental file list
deleting bild1.jpg
neu.jpg
sent 204 bytes received 41 bytes 490.00 bytes/sec
total size is 8 speedup is 0.03 (DRY RUN)Lies die Zeilen mit deleting genau. Stehen dort nur die Dateien, die Du wirklich losgeworden bist, entfernst Du --dry-run und führst denselben Befehl noch einmal aus. Siehst Du plötzlich Hunderte deleting-Zeilen, stimmt fast immer ein Pfad oder ein Schrägstrich nicht.
Das abschließende (DRY RUN) gibt nur das klassische rsync aus. Das openrsync auf dem Mac lässt den Hinweis weg, verändert bei --dry-run aber genauso wenig.
Über SSH auf den Pi oder Server spiegeln
Liegt das Ziel auf einem anderen Rechner, schreibst Du es wie bei scp als benutzer@rechner:pfad. rsync nutzt dafür automatisch SSH:
rsync -avh --progress ~/Fotos/ [email protected]:Backup/Fotos/Ersetze anna durch Deinen Benutzernamen auf dem Zielrechner und raspberrypi.local durch seinen Namen oder seine IP-Adresse. Ein Pfad ohne führenden / hinter dem Doppelpunkt beginnt im Benutzerordner, hier also /home/anna/Backup/Fotos/. Der Ordner Backup muss bereits existieren.
Läuft SSH auf einem anderen Port oder willst Du einen bestimmten Schlüssel verwenden, gibst Du den SSH-Aufruf mit -e vor:
rsync -avh -e "ssh -p 2222 -i ~/.ssh/backup_ed25519" ~/Fotos/ [email protected]:Backup/Fotos/2222 ist der SSH-Port des Servers, ~/.ssh/backup_ed25519 Dein privater Schlüssel. Für automatische Backups ist ein Schlüssel Pflicht, weil ein Cronjob kein Passwort eintippen kann. Wie Du ihn erzeugst und auf den Server bringst, steht in SSH-Schlüssel erstellen: ed25519 Schritt für Schritt.
Dateien ausschließen mit —exclude
Caches, temporäre Dateien und die .DS_Store-Dateien des Macs gehören nicht ins Backup. Einzelne Muster schließt Du mit --exclude aus:
rsync -avh --exclude '.DS_Store' --exclude '.cache/' ~/Fotos/ ziel/Der Schrägstrich hinter .cache/ sorgt dafür, dass nur Ordner dieses Namens ausgeschlossen werden. Die einfachen Anführungszeichen verhindern, dass die Shell die Muster vorher auflöst.
Werden es mehr als zwei, schreibst Du sie in eine Datei ~/rsync-ausschluss.txt, ein Muster pro Zeile:
.DS_Store
.cache/
*.tmp
node_modules/rsync -avh --delete --exclude-from="$HOME/rsync-ausschluss.txt" ~/Fotos/ ziel/Ausgeschlossene Dateien sind im Ziel vor --delete geschützt. Liegt dort noch ein alter .cache-Ordner, bleibt er stehen. Willst Du ihn mitlöschen, ergänzt Du --delete-excluded, natürlich auch hier erst mit --dry-run.
Automatisch per Cronjob
Läuft der Befehl von Hand zuverlässig, trägst Du ihn als Cronjob ein. Öffne die Crontab Deines Benutzers mit crontab -e und füge diese Zeile ein:
30 2 * * * rsync -a --delete --exclude-from=/home/anna/rsync-ausschluss.txt /home/anna/Dokumente/ [email protected]:Backup/Dokumente/ >> /home/anna/rsync-backup.log 2>&1Der Abgleich läuft dann jede Nacht um 2:30 Uhr. Schreib in der Crontab volle Pfade statt ~, lass -v und --progress weg und leite die Ausgabe in eine Logdatei, damit Du Fehler später nachlesen kannst. Der SSH-Schlüssel darf für diesen Zweck keine Passphrase haben, sonst scheitert die Anmeldung, weil im Cronjob niemand sie eingeben kann. Die Felder der Zeitangabe und das Bearbeiten im Editor erklärt Anleitung: Cronjobs unter Raspberry Pi OS einrichten ausführlich.
rsync auf dem Mac: openrsync statt rsync
Wenn Du auf einem aktuellen Mac rsync --version eingibst, siehst Du kein klassisches rsync:
openrsync: protocol version 29
rsync version 2.6.9 compatibleApple liefert unter /usr/bin/rsync inzwischen openrsync aus, eine unabhängige Neuentwicklung aus dem OpenBSD-Projekt. Den Quellcode veröffentlicht Apple im Repository apple-oss-distributions/rsync, die Optionen beschreibt man rsync auf dem Mac. Alle Befehle aus dieser Anleitung funktionieren damit, auch die Übertragung vom Mac auf einen Pi mit dem klassischen rsync 3.5.
Einige Optionen kennt openrsync aber nicht und bricht mit unrecognized option oder invalid option ab:
| Option im klassischen rsync | Wirkung | openrsync auf dem Mac |
|---|---|---|
--mkpath | fehlende Zielordner anlegen | fehlt |
--info=progress2 | Gesamtfortschritt statt pro Datei | fehlt |
-A | ACLs übernehmen | fehlt |
-X | erweiterte Attribute übernehmen | fehlt, heißt hier -E |
Vorsicht bei -E: Im klassischen rsync bedeutet es etwas anderes, nämlich das Ausführbar-Bit zu erhalten. Brauchst Du diese Optionen, installierst Du das aktuelle rsync über Homebrew:
brew install rsyncWeil Homebrew seinen Ordner im PATH vor /usr/bin einträgt, startet rsync danach die Homebrew-Version. Prüf das mit rsync --version: Die erste Zeile nennt dann eine Version ab 3, aktuell 3.5.2. Diesen Homebrew-Schritt beschreibt der Artikel nach der offiziellen Homebrew-Seite, im Test lief nur das mitgelieferte openrsync. Liegt Homebrew noch nicht auf Deinem Mac, hilft Mac für Entwickler einrichten: der Leitfaden für 2026.
Wenn es nicht klappt
„mkdir … failed: No such file or directory (2)“ mit code 11: Ein übergeordneter Ordner des Ziels fehlt. Leg ihn auf dem Zielrechner mit mkdir -p an oder nutze mit dem klassischen rsync --mkpath.
„Permission denied (13)“ mit code 23: Dein Benutzer darf im Zielordner nicht schreiben. Wähle ein Ziel in Deinem Benutzerordner oder gib den Ordner auf dem Zielrechner mit sudo chown anna: /pfad/zum/ziel Deinem Benutzer.
„chown … failed: Operation not permitted (1)“ auf einer externen Platte: Das passiert unter Linux, wenn die Platte mit exFAT oder FAT formatiert ist, denn diese Dateisysteme kennen keine Linux-Besitzer und -Rechte. Ersetze -a dann durch -rlt, das Unterordner, Links und Zeitstempel überträgt und die Rechte weglässt:
rsync -rltvh --delete ~/Dokumente/ /media/anna/SSD/Dokumente/Im Test lief der zweite Durchgang damit ohne erneute Übertragung durch. Am Mac lief -a auf exFAT ohne Fehlermeldung. Ob für ein dauerhaftes Backupziel ein anderes Dateisystem besser passt, klärt Externe SSD am Mac formatieren: APFS, exFAT oder HFS+?. Eine schnelle externe SSD mit USB-C (Affiliate Link) reicht für die meisten Spiegel völlig aus.
Abgebrochene Übertragung einer großen Datei: Normalerweise verwirft rsync eine halb übertragene Datei. Mit --partial behält es das Fragment und setzt beim nächsten Aufruf dort an. Die Kurzform -P schaltet --partial und --progress gemeinsam ein:
rsync -avh -P ~/Videos/urlaub.mov [email protected]:Videos/Im Test mit einer 50-MB-Datei blieben nach dem Abbruch 15 MB auf dem Ziel liegen, und der zweite Lauf übertrug nur noch den Rest.
Spiegel ist nicht gleich Backup
rsync mit --delete hält eine exakte Kopie aktuell, und das ist seine Stärke und seine Grenze: Löschst Du versehentlich eine Datei oder verschlüsselt eine Schadsoftware Deine Daten, überträgt der nächste Lauf genau das ins Ziel. Für ältere Stände und verschlüsselte Kopien außer Haus ergänzt Du den Spiegel deshalb um ein versioniertes Backup, wie es Backups mit restic: verschlüsselt auf S3 und Spaces beschreibt. Für den schnellen, täglichen Abgleich zwischen Mac, Pi und Platte bleibt rsync mit --dry-run als festem erstem Schritt das Werkzeug, auf das Du Dich verlassen kannst.
Weiterlesen.
-
Raspberry Pi & LinuxDateien per scp zwischen Mac und Raspberry Pi kopieren
Dateien und Ordner per scp vom Mac auf den Raspberry Pi und zurück kopieren, mit Beispielen für Ordner, Ports und SSH-Schlüssel, plus rsync.
Nathan Base -
Selfhosting & WebSSH-Schlüssel erstellen: ed25519 Schritt für Schritt
SSH-Key mit ssh-keygen erzeugen, per ssh-copy-id auf Server und Pi bringen, bei GitHub hinterlegen und „Permission denied (publickey)“ lösen.
Nathan Base -
Raspberry Pi & LinuxAnleitung: Cronjobs unter Raspberry Pi OS einrichten
Cronjobs unter Raspberry Pi OS Trixie einrichten: Zeitzone setzen, crontab verstehen, Bash- und Python-Scripts samt venv starten und Fehler protokollieren.
Nathan Base -
Selfhosting & WebBackups mit restic: verschlüsselt auf S3 und Spaces
Server und Mac mit restic sichern: verschlüsselt, inkrementell und automatisch auf DigitalOcean Spaces oder anderen S3-Speicher, samt Restore.
Nathan Base -
Raspberry Pi & LinuxLinux-Festplatte voll: große Dateien finden mit ncdu
No space left on device? So findest Du unter Linux mit df, du und ncdu die Speicherfresser, räumst sicher auf und löst auch den Fall gelöschter Dateien.
Nathan Base -
Raspberry Pi & Linuxjournalctl: Fehler unter Linux in den Logs finden
Mit journalctl findest Du heraus, warum ein Dienst streikt oder der Pi neu startet: nach Dienst, Zeit und Priorität filtern, Journal dauerhaft speichern.
Nathan Base