92 lines
2.6 KiB
Markdown
92 lines
2.6 KiB
Markdown
---
|
|
title: Howto Rsync
|
|
categories: network
|
|
...
|
|
|
|
**rsync** permet de réaliser des copies et synchronisations, depuis ou vers un serveur distant, ou encore localement. **rsync** propose de nombreuses options pour configurer le comportement avant/pendant/après les transfers.
|
|
|
|
* [https://rsync.samba.org/](https://rsync.samba.org/)
|
|
* [https://fr.wikipedia.org/wiki/Rsync](https://fr.wikipedia.org/wiki/Rsync)
|
|
|
|
|
|
## Installation
|
|
|
|
~~~
|
|
# apt install rsync
|
|
|
|
$ rsync --version
|
|
rsync version 3.1.2 protocol version 31
|
|
~~~
|
|
|
|
## Utilisation de base
|
|
|
|
Copier un fichier `foo.txt` vers un serveur distant `example.com` :
|
|
|
|
~~~
|
|
$ rsync /tmp/foo.txt example.com:/tmp/
|
|
~~~
|
|
|
|
Copier tout un dossier vers un serveur distant, avec `-r` ou `--recursive` :
|
|
|
|
~~~
|
|
$ rsync --recursive /tmp/bar example.com:/tmp/
|
|
~~~
|
|
|
|
Copier un dossier depuis le serveur vers son poste :
|
|
|
|
~~~
|
|
$ rsync -r example.com:/tmp/bar /tmp/
|
|
~~~
|
|
|
|
La synchronisation peut se faire localement :
|
|
|
|
~~~
|
|
$ rsync -r /tmp/bar/ /tmp/bar2/
|
|
~~~
|
|
|
|
|
|
|
|
Liste des paramètres les plus communs :
|
|
|
|
* `-n`, `--dry-run` = les actions ne sont pas réalisées, juste listées
|
|
* `-z`, `--compress` = compresse les fichiers pour accélerer le transfer
|
|
* `-v`, `--verbose` : mode verbeux
|
|
* `-q`, `--quiet` : pas de sortie en stdout
|
|
* `-h`, `--human-readable` : les infos sont lisibles par un humain
|
|
* `-d`, `--dirs` : Copie les dossiers sans avoir besoin de lui indiquer qu'il faut le faire récursivement
|
|
|
|
|
|
## Commandes avancées
|
|
|
|
* `-4`, `--ipv4` : Utiliser une connexion IPv4
|
|
* `-6`, `--ipv6` : Utiliser une connexion IPv6
|
|
* `-P`, `--progress` : suivre la progression du transfère d'un fichier
|
|
* `-r`, `--recursive` : Mode récursif
|
|
* `-a`, `--archive` : archive, repecter les liens symboliques
|
|
* `--delete` : supprimer les données distantes qui sont absentes depuis la source
|
|
* `-e` : pour exécuter une commande shell
|
|
|
|
Exemples :
|
|
|
|
`-e` : Faire un rsync sur une serveur distant, avec un port ssh particulier :
|
|
|
|
~~~
|
|
user@serveur-A:~$ rsync -avn /home/user/ -e "ssh -p SSH_PORT" "user@serveur-B:/home/user/"
|
|
~~~
|
|
|
|
## FAQ
|
|
|
|
### connection unexpectedly closed
|
|
|
|
Si l'on obtient un erreur ressemblant à :
|
|
|
|
~~~
|
|
Write failed: Broken pipe
|
|
rsync: connection unexpectedly closed (128109911 bytes received so far) [receiver]
|
|
rsync error: error in rsync protocol data stream (code 12) at io.c(601) [receiver=3.0.7]
|
|
rsync: connection unexpectedly closed (128109911 bytes received so far) [generator]
|
|
rsync error: unexplained error (code 255) at io.c(601) [generator=3.0.7]
|
|
~~~
|
|
|
|
Cela peut venir dans certains cas d'un routeur coupant agressivement les sessions en cas d'inactivité. Dans ce cas, une solution est d'ajouter l'option suivante en Rsync Over SSH : `-e "ssh -o ServerAliveInterval=5"`
|