Como usar rsync para sincronizar arquivos entre seu computador e o servidor
Se você já usa o Gerenciador de Arquivos do cPanel ou um FTP para subir arquivos, sabe como isso pode ser lento quando você só alterou uns poucos arquivos dentro de uma pasta cheia. É aí que entra o rsync: uma ferramenta de linha de comando que compara os arquivos dos dois lados e transfere só o que mudou. Resultado: sincronizações muito mais rápidas e seguras.
Este guia é para quem já tem acesso SSH liberado na hospedagem e se sente confortável abrindo um terminal. Vamos com calma, passo a passo. 🙂
Não sabe se seu plano tem acesso SSH habilitado? Consulte o suporte GeHost ou o painel do cliente antes de começar — nem todo plano vem com SSH ativado por padrão.
1. O que você precisa antes de começar
- Acesso SSH liberado na sua hospedagem, com usuário e senha (ou chave SSH) em mãos.
- O endereço do servidor (domínio ou IP) — você encontra essa informação no seu painel de cliente ou nos dados de acesso enviados pelo suporte.
- Um terminal com rsync instalado:
- Linux e macOS: o rsync já costuma vir instalado.
- Windows: use o WSL (Subsistema Windows para Linux) ou um terminal como o Git Bash, que traz o rsync.
2. Teste a conexão SSH primeiro
Antes de qualquer sincronização, confirme que a conexão SSH está funcionando. No terminal, digite:
ssh seuusuario@seudominio.com.br
Troque seuusuario pelo seu usuário de hospedagem e seudominio.com.br pelo domínio (ou IP) do seu servidor. Se pedir senha e você conseguir entrar, está tudo certo para o próximo passo.
3. Enviando arquivos do seu computador para o servidor
O comando básico do rsync tem esta cara:
rsync -avz --progress -e ssh /caminho/da/pasta/local/ seuusuario@seudominio.com.br:/caminho/no/servidor/
Vamos entender cada parte:
- -a (archive): preserva permissões, datas e estrutura de pastas.
- -v (verbose): mostra na tela o que está sendo transferido.
- -z (compress): comprime os dados durante a transferência, deixando tudo mais rápido.
- --progress: exibe uma barra de progresso do envio.
- -e ssh: diz ao rsync para usar SSH como canal seguro de transporte.
Atenção com a barra "/" no final da pasta! Se você colocar/pasta/local/(com barra no final), o rsync envia o conteúdo da pasta. Se colocar/pasta/local(sem barra), ele envia a pasta inteira dentro do destino. Esse pequeno detalhe muda bastante o resultado — vale testar com calma antes de repetir em produção.
4. Baixando arquivos do servidor para o seu computador
Para fazer o caminho inverso, basta inverter a ordem origem/destino:
rsync -avz --progress -e ssh seuusuario@seudominio.com.br:/caminho/no/servidor/ /caminho/da/pasta/local/
5. Simule antes de sincronizar de verdade (--dry-run)
Uma das melhores práticas do rsync é rodar um "ensaio" antes da transferência real, para ver exatamente o que vai ser alterado:
rsync -avz --dry-run -e ssh /caminho/local/ seuusuario@seudominio.com.br:/caminho/no/servidor/
Isso mostra a lista de arquivos que seriam enviados/alterados, sem mexer em nada de fato. Se o resultado fizer sentido, é só remover o --dry-run e rodar o comando de verdade.
6. Ignorando arquivos e pastas (--exclude)
Quer deixar de fora pastas de cache, logs ou arquivos de configuração local? Use --exclude:
rsync -avz --progress --exclude 'node_modules' --exclude '*.log' -e ssh /caminho/local/ seuusuario@seudominio.com.br:/caminho/no/servidor/
7. Removendo do destino o que não existe mais na origem (--delete)
Por padrão, o rsync só adiciona e atualiza arquivos — ele nunca apaga nada no destino sozinho. Se você quiser que o destino fique espelhado exatamente igual à origem (inclusive apagando o que não existe mais localmente), use a flag --delete:
rsync -avz --delete -e ssh /caminho/local/ seuusuario@seudominio.com.br:/caminho/no/servidor/
Cuidado redobrado com --delete! Essa flag apaga arquivos no destino que não existem na origem. Sempre rode primeiro com --dry-run --delete juntos para ver o que seria removido, e mantenha um backup atualizado antes de usar em pastas importantes.
8. Dicas finais da Sensei 💛
- Prefira chave SSH em vez de senha sempre que possível — é mais seguro e evita digitar senha toda hora.
- Sempre confira o caminho de destino com atenção antes de rodar o comando — um caminho errado pode sobrescrever a pasta errada.
- Antes de sincronizar arquivos de um site em produção, faça um backup pelo cPanel (você encontra a opção de Backup no seu painel de hospedagem).
- Se tiver qualquer dúvida sobre o caminho correto das pastas no servidor (como o
public_html), fale com o suporte GeHost antes de rodar comandos que alteram arquivos em massa.
E é isso! Com esses passos você já sincroniza arquivos entre seu computador e o servidor de forma rápida, segura e sem depender de subir tudo de novo pelo FTP. Qualquer dúvida, nosso suporte está por aqui para ajudar. 🚀
