Como usar o rsync pelo SSH para sincronizar arquivos entre servidores
Oi, tudo bem? Aqui é a Sensei da GeHost 🧘♀️ e hoje eu vou te ensinar a usar uma ferramenta que, depois que você pega o jeito, vira sua queridinha: o rsync. Ele serve pra copiar e manter arquivos "espelhados" entre dois lugares — por exemplo, do seu computador pra hospedagem, ou de uma conta pra outra — de um jeito rápido, seguro e sem duplicar tudo do zero toda vez. Bora com calma, passo a passo, que não tem mistério nenhum.
O que é o rsync e por que ele é tão bom
O rsync é um programinha que compara os arquivos de origem e destino e transfere só o que mudou — diferente de simplesmente copiar tudo de novo. Isso economiza tempo, banda e sua paciência. Quando ele passa pelo SSH, a conexão inteira viaja criptografada, então é uma forma segura de mover arquivos entre servidores ou entre o seu computador e a hospedagem.
💡 Dica da Sensei: pensa no rsync como aquele amigo organizado que, ao invés de trazer a mudança inteira de novo, só traz as caixas que faltam. Muito mais rápido!
Antes de começar: o que você precisa ter em mãos
- Acesso SSH habilitado na sua conta de hospedagem. Nem todo plano tem esse acesso liberado por padrão — se você não sabe se o seu tem, é só falar com o nosso suporte pelo painel.gehost.com.br que a gente confirma e libera pra você.
- Um terminal no seu computador (no Mac/Linux já vem pronto; no Windows você pode usar o PowerShell mais recente, o WSL ou um programa como o PuTTY/Git Bash).
- Os dados de acesso SSH da sua conta (usuário e, de preferência, uma chave SSH — vou te explicar já já por que ela é melhor que senha).
- Saber o caminho das pastas que você quer sincronizar (por exemplo, a pasta do seu site).
Se você tiver dúvida sobre qual é o caminho da sua pasta de site, dá uma espiadinha no Gerenciador de Arquivos do cPanel — geralmente é dentro da pasta public_html.
Passo a passo: sincronizando arquivos com rsync via SSH
- Abra o terminal no seu computador.
- Teste a conexão SSH primeiro, só pra garantir que o acesso está funcionando. O comando geral é: ssh usuario@endereco -p porta (o endereço e a porta corretos você confere no seu painel ou pede pro nosso suporte confirmar). Se pedir senha e conectar, beleza, já sabemos que o caminho está livre.
- Rode o rsync apontando origem e destino. A estrutura básica é: rsync -avz -e ssh /pasta/origem/ usuario@endereco:/pasta/destino/
- -a = modo "arquivo", preserva permissões, datas e subpastas.
- -v = modo "detalhado", mostra o que está acontecendo na tela.
- -z = comprime os dados durante a transferência (mais rápido em conexões lentas).
- -e ssh = diz pro rsync viajar dentro de uma conexão SSH segura.
- Confira a barrinha "/" no final dos caminhos. Isso muda tudo no rsync: colocar "/" no final da pasta de origem copia o conteúdo dela; sem a barra, ele copia a pasta inteira dentro do destino. Vale a pena testar num ambiente de teste antes se você não tiver certeza.
- Espere a transferência terminar e leia o resumo que aparece no final — ele mostra quantos arquivos foram enviados e o tamanho total.
- Rode de novo sempre que precisar atualizar. Da próxima vez, o rsync vai ser bem mais rápido, porque só manda o que mudou desde a última sincronização.
Rodando "no seco" antes (simulação)
Se você quer ter certeza do que vai acontecer antes de mexer em algo de verdade, adicione a opção --dry-run no comando. Ele mostra tudo que seria copiado, movido ou apagado, sem executar nada de fato. É tipo um ensaio geral — eu recomendo demais pra quem está começando.
💡 Dica da Sensei: sempre que for sincronizar algo importante (tipo os arquivos do seu site no ar), faça o --dry-run primeiro. Assim você confere com calma antes de confirmar de verdade.
Cuidado com a opção que apaga arquivos
Existe uma opção chamada --delete, que faz o destino ficar idêntico à origem — inclusive apagando no destino o que não existe mais na origem. Ela é poderosa, mas também é a que mais causa sustos quando usada sem atenção. Se você não tiver 100% de certeza do que está fazendo, é melhor não usar essa opção, ou testar antes com --dry-run.
Usando chave SSH em vez de senha (mais prático e mais seguro)
Digitar senha toda hora cansa, né? Uma chave SSH resolve isso: você gera um par de chaves no seu computador (uma pública e uma privada), cadastra a chave pública na sua conta de hospedagem, e a partir daí o terminal reconhece você automaticamente, sem pedir senha. Além de mais prático, é mais seguro. Se você quiser configurar isso, é só chamar o nosso suporte pelo painel.gehost.com.br que a gente te ajuda a habilitar certinho.
Erros comuns (e como resolver sem pânico)
- "Connection refused" ou conexão não abre: confira se o acesso SSH está mesmo habilitado na sua conta e se o endereço/porta usados estão corretos. Se persistir, fala com o suporte.
- "Permission denied": geralmente é usuário, senha ou chave SSH incorretos, ou a pasta de destino não tem permissão pro seu usuário gravar ali.
- Comando trava/demora muito: pode ser um volume grande de arquivos ou conexão lenta — é normal em primeiras sincronizações grandes; nas próximas vezes será bem mais rápido.
- Sumiu um arquivo no destino que eu não esperava: confira se você usou a opção --delete sem querer — foi ela quem fez a "faxina".
💡 Dica da Sensei: guarde o comando que funcionou pra você (com os caminhos certinhos) num bloco de notas. Assim, da próxima vez, é só copiar, colar e ajustar — sem precisar montar tudo de novo do zero.
E é isso! Com esses passos você já consegue manter seus arquivos sincronizados entre servidores com tranquilidade. Se em algum momento travar em algo técnico mais fundo (tipo liberar o acesso SSH ou configurar a chave), pode chamar a gente pelo painel.gehost.com.br — estamos por aqui pra ajudar. 🌱
