Como usar o rsync para sincronizar arquivos entre seu computador e o servidor
Oi! Aqui é a Sensei da GeHost 🥋 Hoje vou te ensinar a usar o rsync, uma ferramenta de linha de comando que sincroniza pastas entre o seu computador e o seu servidor — só enviando o que mudou, de um jeito rápido e seguro. É ótimo pra quem já usa SSH e quer parar de subir arquivo por arquivo na mão.
Esse guia é da categoria SSH & Avançado — ou seja, ele pressupõe que você já tem (ou vai pedir) acesso SSH liberado na sua hospedagem. Nem todo plano vem com SSH habilitado por padrão: se você não sabe se o seu tem, é só perguntar pro nosso suporte pelo painel.gehost.com.br que a gente confirma pra você.
O que é o rsync, afinal?
Pensa assim: em vez de você arrastar uma pasta inteira toda vez que muda um arquivozinho (o que é lento e reenvia tudo de novo), o rsync compara o que já está no servidor com o que está no seu computador e manda só a diferença. Resultado: sincronizações muito mais rápidas, principalmente quando o site já é grande.
Passo 1 — Confira se você tem acesso SSH
Antes de mais nada, você precisa ter as credenciais de acesso SSH da sua hospedagem (usuário, senha ou chave, e a porta de conexão). Se você ainda não tem isso, é só abrir um chamado no painel pedindo a liberação do SSH pro seu plano.
💡 Dica da Sensei: se você ainda não tem SSH liberado, sem problema — dá pra continuar subindo e organizando arquivos pelo Gerenciador de Arquivos do cPanel (mostrado acima), direto no painel. O rsync é um "upgrade" pra quem já manja um pouco mais de terminal.
Passo 2 — Tenha o rsync instalado no seu computador
- Linux e macOS: o rsync já costuma vir instalado. Você pode conferir abrindo o Terminal e digitando
rsync --version. - Windows: a forma mais simples é usar o WSL (Subsistema Windows para Linux) ou um terminal como o Git Bash, que trazem o rsync junto.
Passo 3 — Monte o comando básico
A estrutura geral do comando é essa aqui:
rsync -avz -e ssh /caminho/da/pasta/local/ usuario@seudominio.com.br:/caminho/no/servidor/
Repara nas partes:
- -avz — são as "opções mágicas": a (archive, preserva permissões e estrutura), v (verbose, mostra o que está acontecendo) e z (compacta os dados durante o envio, deixando mais rápido).
- -e ssh — avisa pro rsync usar o SSH como "canal seguro" de transporte.
- usuario@seudominio.com.br — troque pelo seu usuário de SSH e pelo endereço do seu domínio/servidor (o suporte te passa esses dados certinhos quando libera o acesso).
- Os dois caminhos no fim são: a pasta de origem (no seu computador) e a pasta de destino (no servidor, normalmente dentro de
public_html).
⚠️ Atenção à barrinha "/" no final da pasta de origem! Se você colocar/minha-pasta/(com barra no final), o rsync copia o conteúdo de dentro da pasta. Se colocar/minha-pasta(sem a barra), ele copia a pasta inteira pra dentro do destino. É um detalhe pequeno que muda tudo — sempre confira antes de rodar!
Passo 4 — Faça primeiro um "teste seco" (dry-run)
Antes de mandar de verdade, você pode simular o envio pra ver exatamente o que vai acontecer, sem alterar nada de fato. Basta acrescentar a opção -n (ou --dry-run):
rsync -avzn -e ssh /caminho/da/pasta/local/ usuario@seudominio.com.br:/caminho/no/servidor/
O terminal vai listar tudo que seria enviado, apagado ou alterado. Confira com calma — se estiver tudo certo, é só tirar o n e rodar de verdade.
Passo 5 — Sincronize de verdade
Conferiu e ficou tudo certinho? Agora sim, rode sem o -n:
rsync -avz -e ssh /caminho/da/pasta/local/ usuario@seudominio.com.br:/caminho/no/servidor/
O terminal vai pedir sua senha de SSH (ou usar sua chave, se você tiver configurado uma) e começar a transferir só o que for novo ou diferente.
Extra — quer também "espelhar" e remover o que não existe mais na origem?
Se o seu objetivo é deixar o servidor idêntico à pasta do seu computador (inclusive apagando lá o que você já apagou aqui), use a opção --delete:
rsync -avz --delete -e ssh /caminho/da/pasta/local/ usuario@seudominio.com.br:/caminho/no/servidor/
🚨 Cuidado redobrado com o--delete! Ele apaga do servidor tudo que não existir mais na pasta de origem. Sempre rode primeiro com-n(dry-run) pra ver a lista do que seria removido, antes de confirmar de verdade. Backup nunca é demais — se tiver dúvida, faça um backup da sua conta pelo painel antes de sincronizar algo mais delicado.
Resumindo pra você não esquecer
- Confirme que tem SSH liberado no seu plano (peça pro suporte se não tiver).
- Instale/confira o rsync no seu computador.
- Monte o comando com
-avz -e ssh. - Fique de olho na barra "/" no final da pasta de origem.
- Rode com
-nprimeiro pra testar, sem medo. - Só use
--deletecom muita atenção — e com backup feito.
Prontinho! Com isso você já sincroniza seus arquivos de um jeito bem mais profissional e rápido. Qualquer dúvida no meio do caminho, é só chamar a gente pelo painel — a Sensei e o time GeHost estão sempre por aqui 💚