rsync¶
Gleicht Dateien und Verzeichnisse ab, lokal oder über SSH. Überträgt nur, was sich geändert hat, und ist damit das Standardwerkzeug für Backups und Deployments.

Syntax¶
rsync [OPTION]... QUELLE... ZIEL
Der abschließende Schrägstrich ist wichtig: /srv/www/ kopiert den Inhalt des Verzeichnisses, /srv/www das Verzeichnis selbst ins Ziel.
Optionen¶
| Option | Beschreibung |
|---|---|
-a |
Archivmodus: rekursiv, behält Rechte, Zeiten, Besitzer und Links |
-v |
Die übertragenen Dateien auflisten |
-z |
Während der Übertragung komprimieren |
-n, --dry-run |
Nur zeigen, was passieren würde |
--delete |
Dateien im Ziel löschen, die es in der Quelle nicht mehr gibt |
--progress |
Den Fortschritt pro Datei zeigen |
--exclude=MUSTER |
Dateien und Verzeichnisse überspringen, die zu MUSTER passen |
-e "ssh -p 2222" |
SSH mit besonderen Optionen nutzen |
Beispiele¶
Eine Webseite auf den Server kopieren:
rsync -av ~/projects/www/ nox@192.0.2.10:/srv/www/
sending incremental file list
created directory /srv/www
./
index.html
css/
css/style.css
img/
img/logo.png
sent 48,213 bytes received 115 bytes 32,218.67 bytes/sec
total size is 47,892 speedup is 1.00
Nach einer Änderung erneut ausführen:
rsync -av ~/projects/www/ nox@192.0.2.10:/srv/www/
sending incremental file list
index.html
sent 7,102 bytes received 41 bytes 14,286.00 bytes/sec
total size is 47,903 speedup is 6.71
Nur index.html hat sich geändert, also wird nur sie übertragen. Das ist die Stärke von
rsync.
Prüfen, was --delete entfernen würde:
rsync -av --delete --dry-run ~/projects/www/ nox@192.0.2.10:/srv/www/
sending incremental file list
deleting old/banner.png
index.html
sent 218 bytes received 30 bytes 496.00 bytes/sec
total size is 47,903 speedup is 193.16 (DRY RUN)
old/banner.png gibt es lokal nicht mehr und würde auf dem Server gelöscht. Ohne
--dry-run passiert das wirklich.
Eine große Datei mit Fortschritt kopieren:
rsync -a --progress db.sql.gz nox@192.0.2.10:/srv/backup/
sending incremental file list
db.sql.gz
30,000,000 100% 11.20MB/s 0:00:02 (xfr#1, to-chk=0/1)
sent 30,007,421 bytes received 35 bytes 8,573,559.14 bytes/sec
total size is 30,000,000 speedup is 1.00
Ein Backup vom Server holen, ohne das Cache-Verzeichnis:
rsync -av --exclude=cache/ nox@192.0.2.10:/srv/app/ ~/backup/app/
receiving incremental file list
./
config.php
data/
data/users.json
sent 69 bytes received 18,442 bytes 37,022.00 bytes/sec
total size is 18,201 speedup is 0.98
Wann brauche ich das?¶
- Für Backups auf einen anderen Server, regelmäßig per Cron oder systemd-Timer
- Um eine Webseite oder Anwendung auf einen Server zu bringen
- Um große Datenmengen zu verschieben, weil sich eine abgebrochene Übertragung einfach neu starten lässt
--delete immer erst mit --dry-run testen
Ein falscher Pfad oder ein fehlender Schrägstrich mit --delete kann das ganze
Zielverzeichnis löschen. Schau dir den Probelauf an, dann führe den echten Befehl aus.
Auf beiden Seiten installiert
rsync muss auf deinem Rechner und auf dem Server installiert sein. Sonst bekommst du
von der Gegenseite rsync: command not found.
Unterschiede zwischen Distributionen¶
| Debian | Ubuntu | RHEL | Arch | |
|---|---|---|---|---|
| Vorinstalliert | nein | ja | nein | nein |