Linux Sabe Mais

Comandos, exemplos e soluções para o dia a dia.

BIBLIOTECA LINUX
741 tutoriais · 1406 exemplos
Documentação em português
Aprender Linux · passo a passo

O comando rsync no Linux

Percebe a finalidade, lê a sintaxe e explora os exemplos antes de adaptares o comando ao teu sistema.

O que faz e quando utilizar

Simulação. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.

A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.

Como escrever o comando

rsync [opções] origem ... destino

Os elementos entre [ ] são opcionais e as reticências indicam que um argumento pode repetir-se. Estes sinais explicam a estrutura: não são texto para escrever literalmente. Na secção seguinte encontras exemplos completos.

O nome rsync identifica a ferramenta ou o interno da shell. As opções ajustam o comportamento; os restantes argumentos indicam os dados, nomes ou caminhos usados na operação.

Exemplos explicados

Começa pelos exemplos de consulta. Quando uma operação altera dados ou configurações, lê o aviso e confirma os argumentos antes de a executar.

1. Simulação

Simulação. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.

rsync -avhn /origem/ /destino/
2. Cópia local

Cópia local. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.

rsync -avh /origem/ /destino/
3. Por SSH

Por SSH. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.

rsync -avz -e ssh /origem/ utilizador@servidor:/destino/
4. Excluir cache

Excluir cache. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.

rsync -avh --exclude="cache/" /origem/ /destino/
5. Mostrar progresso

Mostrar progresso. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.

rsync -avh --info=progress2 /origem/ /destino/
6. Preservar ACL e xattrs

Preservar ACL e xattrs. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.

rsync -aAXHv /origem/ /destino/
7. Ver alterações

Ver alterações. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.

rsync -avhn --itemize-changes /origem/ /destino/
8. Sincronizar com eliminação (simulação)

Sincronizar com eliminação (simulação). A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.

rsync -avhn --delete /origem/ /destino/
9. Limitar banda

Limitar banda. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.

rsync -avh --bwlimit=5000 /origem/ /destino/
10. Checksum

Checksum. A barra final numa origem pasta/ copia o conteúdo, enquanto pasta pode incluir a própria pasta no destino. --delete apaga entradas no destino que não existam na origem. Antes de sincronizar dados reais, acrescenta --dry-run e lê as alterações propostas.

rsync -avhc /origem/ /destino/
11. Sincroniza uma árvore preservando atributos e apaga no destino entradas…

Sincroniza uma árvore preservando atributos e apaga no destino entradas ausentes da origem por causa de --delete.

--delete elimina dados no destino. Experimenta primeiro com --dry-run e confirma o sentido da sincronização.

rsync -rogpav --delete /home/ /tmp/copia-home/
12. Sincroniza uma pasta local para outra máquina através de SSH, com…

Sincroniza uma pasta local para outra máquina através de SSH, com destino remoto explicitado na forma conta@servidor:caminho.

--delete elimina dados no destino. Experimenta primeiro com --dry-run e confirma o sentido da sincronização.

rsync -rogpav -e ssh --delete /home/ utilizador@servidor.example:/backup/home/
13. Copia dados locais para um destino SSH com compressão e modo arquivo

Copia dados locais para um destino SSH com compressão e modo arquivo; a forma original estava incompleta.

--delete elimina dados no destino. Experimenta primeiro com --dry-run e confirma o sentido da sincronização.

rsync -az -e ssh --delete pasta/ utilizador@servidor.example:/backup/

Como interpretar

Os nomes de ficheiros, pastas, contas e pacotes são exemplos: substitui-os por elementos que existam no teu ambiente. Não escrevas os símbolos < e > à volta de nomes, porque a shell pode interpretá-los como redireções.

14. Copia uma árvore remota para uma pasta local

Copia uma árvore remota para uma pasta local; a origem remota tem de estar antes do destino local.

--delete elimina dados no destino. Experimenta primeiro com --dry-run e confirma o sentido da sincronização.

rsync -az -e ssh --delete utilizador@servidor.example:/home/local/ pasta-local/

Como interpretar

Os nomes de ficheiros, pastas, contas e pacotes são exemplos: substitui-os por elementos que existam no teu ambiente. Não escrevas os símbolos < e > à volta de nomes, porque a shell pode interpretá-los como redireções.

Erros frequentes e como os evitar

  • Distingue as opções de consulta das opções que alteram dados. Confirma os argumentos do exemplo antes de aplicar a operação a dados reais.
  • Nomes de contas, pacotes, dispositivos e caminhos são ilustrativos: têm de corresponder ao sistema onde vais trabalhar.
  • A distribuição e a versão instalada podem ter opções diferentes. Uma opção com o mesmo nome noutro programa pode ter outro significado.

Uma forma de praticar

Escolhe um dos exemplos acima e identifica o programa, cada opção e os argumentos. Explica por palavras tuas qual deverá ser o resultado. Se faltar um ficheiro, pacote ou dispositivo, resolve primeiro esse requisito; não acrescentes privilégios apenas para tentar eliminar uma mensagem de erro.

Testa primeiro uma variante de consulta, usando ficheiros de ensaio quando fizer sentido. Compara o resultado com a explicação e só depois acrescenta outra opção, para perceberes o efeito de cada alteração.