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

Sincronizando Arquivos entre o Computador e o Servidor com Rsync

Oi! Aqui é a Sensei da GeHost 🧘‍♀️ Hoje vamos falar de uma ferramenta clássica de quem mexe com hospedagem: o rsync. Ele serve pra copiar arquivos entre o seu computador e o servidor de um jeito muito mais esperto que um simples "arrastar e soltar" — porque ele só transfere o que mudou, economizando tempo e dados. Vamos com calma, passo a passo.

O que é o rsync e por que usar

Imagina que você tem uma pasta com o site inteiro no seu computador e quer manter uma cópia idêntica no servidor (ou vice-versa). Se você copiar tudo de novo toda vez, além de demorar, vai reenviar arquivos que nem mudaram. O rsync compara os dois lados e transfere só as diferenças. É rápido, seguro e é o queridinho de quem trabalha com backups e deploys.

💡 Dica da Sensei: pense no rsync como um "espelho inteligente" — ele olha os dois lados antes de mexer em qualquer coisa.

Pré-requisitos antes de começar

• Acesso SSH habilitado na sua hospedagem. Isso não vem ativado por padrão em todos os planos — confira no painel.gehost.com.br ou abra um chamado com o suporte pra confirmar se o seu tem essa liberação e pegar os dados de conexão (endereço, usuário e porta).
• Um terminal no seu computador:
  • No Mac e no Linux, o rsync já vem instalado.
  • No Windows, o caminho mais tranquilo é usar o WSL (Subsistema Linux do Windows) ou um cliente como o Git Bash.

⚠️ Importante: os planos de hospedagem da GeHost funcionam em ambiente cPanel compartilhado — ou seja, você acessa a sua conta via SSH, mas não é um acesso de servidor completo (root). Isso é mais que suficiente pra sincronizar arquivos do seu site.

Passo a passo

Passo 1 — Confirme os dados de acesso

Com o suporte ou no painel, anote:

• O endereço do servidor (algo como seudominio.com.br ou o que constar no seu contrato/painel);
• Seu usuário de hospedagem;
• A porta SSH (se for diferente da padrão, o suporte informa).

Passo 2 — Teste a conexão via SSH

Antes de sincronizar arquivos, é bom garantir que a conexão em si está funcionando. No terminal, digite:

ssh seuusuario@seudominio.com.br

Se pedir senha (ou chave, caso você já tenha configurado uma) e você conseguir entrar, ótimo — está tudo certo pra seguir.

Passo 3 — Rode o rsync

Agora vem a parte boa. Os comandos básicos são:

Para enviar arquivos do seu computador para o servidor (upload):

rsync -avz --progress /caminho/da/pasta/local/ seuusuario@seudominio.com.br:/caminho/da/pasta/no/servidor/

Para baixar arquivos do servidor para o seu computador (download):

rsync -avz --progress seuusuario@seudominio.com.br:/caminho/da/pasta/no/servidor/ /caminho/da/pasta/local/

💡 Dica da Sensei: repare na barra "/" no final dos caminhos de pasta. Ela faz diferença! Com a barra, o rsync copia o conteúdo da pasta; sem ela, copia a pasta inteira dentro da pasta de destino. Um detalhe pequeno que evita bastante confusão.

Passo 4 — Entenda as opções principais

1. -a (archive): preserva permissões, datas e estrutura de pastas — é o modo "completo e fiel".
2. -v (verbose): mostra na tela o que está sendo transferido, pra você acompanhar.
3. -z (compress): comprime os dados durante a transferência, deixando mais rápido.
4. --progress: exibe uma barrinha de progresso de cada arquivo.
5. --delete: apaga no destino os arquivos que não existem mais na origem (use com cautela!).
6. -n (dry-run): simula a transferência sem mexer em nada de verdade — ótimo pra testar antes.

⚠️ Cuidado com o --delete: ele deixa os dois lados idênticos, inclusive apagando o que não existir mais na origem. Antes de usar, sempre rode com -n primeiro pra ver o que seria apagado.

Passo 5 — Exemplo prático com dry-run

Pra simular uma sincronização com exclusão, sem apagar nada de verdade ainda:

rsync -avzn --delete --progress /caminho/local/ seuusuario@seudominio.com.br:/caminho/servidor/

Se a lista que aparecer fizer sentido pra você, é só rodar de novo sem o -n.

Erros comuns (e como resolver)

• "Permission denied": geralmente é usuário/senha errados ou a chave SSH não configurada. Confira os dados com o suporte.
• "Connection refused": pode ser a porta SSH errada, ou o acesso SSH ainda não estar habilitado no seu plano — vale abrir um chamado.
• Arquivos não aparecem depois da sincronização: revise o caminho de destino (ex.: se é dentro de public_html ou não) — um caminho errado copia pro lugar errado, não some o arquivo.

Quando chamar o suporte

Se em algum momento a conexão SSH não abrir, ou você não tiver certeza se o seu plano possui esse recurso habilitado, é só chamar a equipe da GeHost pelo painel do cliente. A gente confere os dados de acesso com você com todo o cuidado.

🧘 Última dica da Sensei: antes de qualquer sincronização importante, faça um backup. O rsync é confiável, mas um comando digitado no caminho errado acontece com todo mundo — inclusive comigo, no começo. Backup é sempre seu paraquedas.