SSH & Avanzado 38 visualizações

Como usar rsync para sincronizar arquivos entre o servidor e o computador local

Ver no WHMCS

Como usar rsync para sincronizar arquivos entre o servidor e o seu computador

Oi, tudo bem? Aqui é a Sensei da GeHost! 🥋 Se você já usa (ou está começando a usar) acesso SSH na sua hospedagem, vai adorar conhecer o rsync — uma ferramentinha clássica e super confiável pra manter os arquivos do seu site sincronizados entre o servidor e o seu computador, sem precisar ficar arrastando pasta por pasta no FTP.

Vamos com calma, passo a passo, do jeitinho que a Sensei gosta de ensinar 😉

O que é o rsync e por que ele é tão bom?

O rsync ("remote sync") é um programa de linha de comando que copia arquivos entre dois lugares — no seu caso, entre o seu computador e a sua hospedagem — comparando o que já existe nos dois lados e transferindo só o que mudou. Isso torna o processo muito mais rápido que um upload comum, principalmente quando você já tem uma cópia do site localmente e só quer atualizar algumas coisas.

💡 Dica da Sensei: pense no rsync como aquele amigo organizado que só te avisa o que realmente mudou, em vez de te mandar a mochila inteira de novo toda vez.

Passo 1 — Confirme se o seu plano tem acesso SSH liberado

O rsync funciona por dentro de uma conexão SSH. Por isso, antes de tudo:

  • Verifique com o nosso suporte, pelo painel.gehost.com.br, se o acesso SSH já está liberado na sua conta de hospedagem;
  • Peça o usuário, o endereço de conexão y la porta que serão usados — esses dados são específicos da sua conta e o time te passa com segurança;
  • Tenha em mãos a senha (ou, se preferir, uma chave SSH configurada — se quiser saber mais sobre isso, é só chamar o suporte).

Se você usa outros recursos do cPanel no dia a dia, o caminho das pastas do seu site (como a public_html) é o mesmo que você já vê por lá:

Gerenciador de Arquivos do cPanel mostrando a árvore de pastas, incluindo a public_html

Passo 2 — Abra o terminal no seu computador

  1. Windows: use o PowerShell, o Terminal do Windows ou o WSL (caso tenha instalado). Também é possível usar programas como o WinSCP, que oferecem uma interface visual para conexões parecidas.
  2. Mac e Linux: o Terminal já vem pronto pra uso, sem precisar instalar nada extra na maioria dos casos.

Passo 3 — Baixando arquivos do servidor pro seu computador

O comando básico de rsync via SSH segue este formato:

rsync -avz -e ssh usuario@endereco-do-servidor:/caminho/no/servidor/ /caminho/no/seu/computador/

Explicando cada parte, com carinho:

  • -a — modo "arquivo", preserva permissões, datas e subpastas;
  • -v — modo "verboso", mostra na tela o que está sendo copiado;
  • -z — comprime os dados durante a transferência, deixando mais rápido;
  • -e ssh — diz pro rsync usar a conexão segura via SSH;
  • o usuário e o endereço do servidor são os dados que o suporte te passou no Passo 1.

Depois de digitar o comando e apertar Enter, o sistema vai pedir a senha (ou validar sua chave SSH, se você tiver configurado uma) e começar a trazer os arquivos.

Passo 4 — Enviando arquivos do seu computador pro servidor

É só inverter a ordem dos caminhos:

rsync -avz -e ssh /caminho/no/seu/computador/ usuario@endereco-do-servidor:/caminho/no/servidor/
⚠️ Atenção da Sensei: repare na barra ("/") no final das pastas — ela faz diferença! Com a barra, o rsync copia o conteúdo da pasta; sem a barra, ele copia a pasta inteira (criando mais um nível). Sempre confira com calma antes de confirmar o envio, principalmente ao sincronizar pastas importantes do site.

Passo 5 — Testando antes de enviar de verdade (modo simulação)

Ficou nervoso com a ideia de sobrescrever algum arquivo? A gente entende, e o rsync tem uma solução perfeita pra isso: o modo de simulação (dry-run). Basta adicionar --dry-run ao comando:

rsync -avz --dry-run -e ssh /caminho/no/seu/computador/ usuario@endereco-do-servidor:/caminho/no/servidor/

Assim, o rsync te mostra exatamente o que seria enviado ou alterado, sem mexer em nada de verdade. É o teste ideal antes de qualquer sincronização mais delicada.

Dicas extras da Sensei 🎋

  • Use --delete com bastante cuidado: essa opção apaga, do lado de destino, os arquivos que não existem mais na origem. Ótimo pra manter tudo espelhado, mas perigoso se usado no caminho errado — sempre teste antes com --dry-run.
  • Prefira sincronizar pastas específicas (como imagens, uploads ou uma pasta de backup) em vez do site inteiro de uma vez, principalmente enquanto está pegando confiança com o comando.
  • Antes de mexer em arquivos de sistemas como WordPress, é sempre uma boa ideia ter um backup à mão. Você pode gerar um pelo cPanel:
Tela de Backup do cPanel com opções de backup completo e parcial

Ficou com alguma dúvida?

Sem problema nenhum — SSH e rsync são recursos mais avançados, e é super normal ter perguntas no caminho. Se precisar confirmar se o seu plano tem SSH liberado, pegar os dados de acesso ou tirar qualquer dúvida técnica, é só chamar a gente pelo painel.gehost.com.br. A Sensei e o time estão por aqui pra te ajudar nessa jornada. 🙏

Precisa de Ajuda?

Nossa equipe está pronta para resolver suas dúvidas.