Zum Inhalt springen
SONOYA.com
Raspberry Pi & Linux

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

Zwei hintereinander liegende Ordnersymbole auf dunkelrotem Verlauf als Sinnbild für einen Ordner, den rsync als Spiegel auf ein zweites Ziel überträgt

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:

Code
sudo apt install rsync

Für Übertragungen per SSH muss rsync auf beiden Seiten installiert sein.

Die Grundform: rsync -avh —progress

Fast jeder rsync-Aufruf beginnt so:

Code
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.
  • -v zeigt jede übertragene Datei an.
  • -h gibt Größen lesbar aus, also 1.07K statt 1070.
  • --progress zeigt 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:

Code
rsync -avh Fotos/ ziel/
Code
created directory ziel
./
bild1.jpg
2026/
2026/bild2.jpg

Ohne Schrägstrich entsteht im Ziel ein zusätzlicher Ordner Fotos:

Code
rsync -avh Fotos ziel/
Code
created directory ziel
Fotos/
Fotos/bild1.jpg
Fotos/2026/
Fotos/2026/bild2.jpg

Achte 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:

Code
rsync -avh --dry-run --delete Fotos/ ziel/
Code
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:

Code
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:

Code
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:

Code
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:

Code
.DS_Store
.cache/
*.tmp
node_modules/
Code
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:

Code
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>&1

Der 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:

Code
openrsync: protocol version 29
rsync version 2.6.9 compatible

Apple 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 rsyncWirkungopenrsync auf dem Mac
--mkpathfehlende Zielordner anlegenfehlt
--info=progress2Gesamtfortschritt statt pro Dateifehlt
-AACLs übernehmenfehlt
-Xerweiterte Attribute übernehmenfehlt, 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:

Code
brew install rsync

Weil 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:

Code
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:

Code
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.