O que é o rsync e por que ele é seu melhor amigo pra sincronizar arquivos
Olá! Sensei da GeHost aqui. 🙂 Se você já precisou copiar arquivos de um servidor pra outro (ou fazer um backup manual) e ficou com medo de reenviar tudo de novo do zero, o rsync foi feito pra você. Ele é um comando que compara os arquivos da origem com os do destino e transfere só o que mudou — muito mais rápido e seguro do que copiar tudo toda vez.
Neste guia vamos usar o rsync junto com o SSH, que é o "túnel seguro" por onde os arquivos vão viajar, criptografados, entre os dois servidores.
Antes de começar: o que você precisa ter em mãos
- Acesso SSH liberado nos servidores de origem e destino. Se você não sabe se tem esse acesso, é só chamar o suporte da GeHost pelo painel do cliente e pedir a liberação.
- Um terminal para rodar os comandos: no Linux e no Mac já vem pronto; no Windows você pode usar o PowerShell, o WSL ou um programa como o PuTTY.
- O endereço (IP ou domínio), o usuário e a senha (ou chave SSH) de cada servidor envolvido. Esses dados ficam com você — a GeHost nunca vai pedir sua senha por chat ou e-mail.
💡 Dica da Sensei: não sabe se o rsync já está instalado no seu servidor? Digite rsync --version no terminal. Se aparecer um número de versão, está tudo certo!
Passo a passo: sincronizando arquivos com rsync + SSH
Passo 1 — Teste a conexão SSH primeiro
Antes de mexer com o rsync, confirme que você consegue entrar no servidor de destino normalmente:
- Abra o terminal.
- Digite: ssh usuario@endereco-do-servidor
- Informe a senha (ou, se estiver usando chave, ela vai conectar sozinha).
- Se você "entrar" no servidor de destino, a conexão está funcionando. Digite exit para sair e voltar ao terminal local.
Passo 2 — Rode o comando básico de sincronização
O formato mais comum do rsync com SSH é este:
rsync -avz -e ssh /caminho/da/pasta/local/ usuario@endereco-do-servidor:/caminho/de/destino/
Repare que a pasta de origem tem uma barra "/" no final — isso é importante! Ela diz ao rsync "copie o conteúdo desta pasta", e não a pasta em si dentro da outra.
Passo 3 — Entenda os principais parâmetros usados
- -a (archive): mantém permissões, datas e a estrutura das pastas igualzinha.
- -v (verbose): mostra na tela o que está sendo transferido, passo a passo.
- -z (compress): comprime os dados durante a transferência, deixando tudo mais rápido.
- -e ssh: diz ao rsync para usar o SSH como "veículo" da transferência.
Passo 4 — Sincronizando uma pasta específica (exemplo prático)
Digamos que você queira sincronizar a pasta do seu site local com o servidor. O comando ficaria assim:
rsync -avz -e ssh ./meu-site/ usuario@endereco-do-servidor:/caminho/do/site/
Pronto! O rsync vai olhar arquivo por arquivo e enviar apenas o que for novo ou diferente.
Passo 5 — Simule antes de executar de verdade (recomendado!)
Ficou nervoso de rodar o comando "de verdade"? Existe um modo de simulação:
rsync -avz --dry-run -e ssh ./meu-site/ usuario@endereco-do-servidor:/caminho/do/site/
Com o --dry-run, o rsync mostra tudo o que seria feito, mas não altera nada de verdade. É a rede de segurança perfeita para quem está começando.
Passo 6 — (Avançado) Automatizando com chave SSH
Se você for sincronizar arquivos com frequência, digitar a senha toda vez cansa. Uma chave SSH permite conectar sem senha, de forma segura:
- Gere uma chave no seu computador: ssh-keygen -t ed25519
- Copie a chave pública para o servidor de destino: ssh-copy-id usuario@endereco-do-servidor
- Pronto — nas próximas vezes, o rsync vai conectar automaticamente pela chave.
Esse comando também pode ser agendado (por exemplo, com o cron) para rodar sozinho em horários definidos por você — mas essa é uma configuração mais avançada, e se tiver dúvida, é sempre bom confirmar cada detalhe com o suporte antes de automatizar algo que grava dados.
Dicas de segurança e boas práticas
🔒 Nunca compartilhe sua senha ou sua chave privada SSH com ninguém — nem mesmo com o suporte. Pedidos legítimos da GeHost jamais pedem essa informação.
🧪 Sempre teste com --dry-run antes de sincronizar pastas importantes, principalmente se for usar o parâmetro --delete (que apaga no destino o que não existe mais na origem).
💾 Sincronizar não substitui backup. Mantenha sempre uma cópia de segurança separada dos seus arquivos importantes.
Erros comuns e como resolver
- "Permission denied": geralmente é usuário, senha ou caminho de pasta incorretos — confira os três com calma.
- "Connection refused" ou conexão travando: pode ser que o acesso SSH ainda não esteja liberado para o seu usuário — fale com o suporte da GeHost.
- Arquivos não aparecem no destino: confira se você esqueceu a barra "/" no final da pasta de origem, como explicamos no Passo 2.
Precisa de uma mãozinha?
Se em algum passo você travar, sem problema — faz parte de aprender algo novo! Acesse o painel.gehost.com.br e abra um chamado com nosso suporte que a gente te ajuda a destravar. 💚
