Sincronizar uma pasta grande entre dois servidores (retomável, em segundo plano)

Última atualização: 2026-07-08

Você tem uma pasta grande — dezenas de gigabytes — em um servidor e quer uma cópia exata em outro. Você não pode vigiar um terminal por horas, e uma transferência que morre no meio do caminho não deveria recomeçar do zero. relayium sync foi feito para isso: um espelho incremental unidirecional que pula o que já está lá, retoma um arquivo enviado pela metade de onde parou e verifica cada arquivo de ponta a ponta.

Este guia configura uma transferência sem supervisão e com autorrecuperação: autorize o emissor uma vez, execute o processo à escuta em segundo plano e conduza relayium sync a partir de um laço de repetição dentro do tmux para que ele continue através das quedas de conexão até que a pasta inteira chegue.

Por que relayium sync se encaixa nesta tarefa

sync é um espelho incremental unidirecional sobre o protocolo nativo (instale relayium nas duas pontas). Três propriedades o tornam seguro para executar e reexecutar sem supervisão:

Pula os arquivos que já estão lá: um arquivo cuja cópia no receptor coincide em tamanho e hora de modificação não é enviado de novo.
Retoma arquivos parciais: se um arquivo foi transferido pela metade quando a conexão caiu, a próxima execução continua a partir do deslocamento de bytes já em disco em vez de reiniciá-lo.
Verifica cada arquivo: cada arquivo é verificado com SHA-256 de ponta a ponta, então se sabe que um espelho concluído está intacto.
Por causa disso, o comando é idempotente — executá-lo novamente só faz o trabalho que resta, que é exatamente o que permite a um laço de repetição concluir uma transferência enorme.

Pré-requisitos

Instale relayium nos dois servidores (sync fala o protocolo nativo, então ele precisa estar presente em cada ponta):

# nos DOIS servidores
curl -fsSL https://relayium.com/install.sh | sh

Este guia usa daemon direto (relayium://), então os dois servidores não precisam de acesso SSH entre si.
Abra a porta do processo à escuta (9031 por padrão) para o emissor no firewall ou grupo de segurança do receptor.

Autorizar o emissor uma vez (no receptor)

O receptor aprova a máquina emissora uma vez; a aprovação é escrita em disco e permanece válida entre reinicializações, então você nunca a repete. Inicie o processo à escuta em um terminal e aponte --dir para o diretório pai — relayium sync /root/workspace reproduz workspace/... no receptor, então --dir /root deposita os arquivos em /root/workspace/.

Na primeira conexão do emissor (próxima seção), serve mostra seu endereço e sua impressão digital e pede que você o aprove; responda y e ele é lembrado para sempre:

# no RECEPTOR (em primeiro plano, para aprovar interativamente)
relayium serve --dir /root --port 9031

# no RECEPTOR, na primeira conexão:
Incoming push from 203.0.113.9:52140
  fingerprint: 9f2c41ab…
Accept and remember this peer? [y/N] y

Para uma configuração totalmente sem supervisão, pule o prompt: execute relayium id no emissor para imprimir sua impressão digital, e então relayium authorize <impressão digital> no receptor.
--dir é o pai da pasta que você está sincronizando, não a pasta em si — caso contrário os arquivos caem um nível fundo demais (por exemplo /root/workspace/workspace).

Executar o processo à escuta em segundo plano (no receptor)

Uma vez autorizada a impressão digital, pare o serve em primeiro plano (Ctrl-C) e relance-o desacoplado para que sobreviva ao seu logout. Ele carrega a impressão digital salva e aceita o emissor em silêncio — sem prompt desta vez:

# no RECEPTOR
nohup relayium serve --dir /root --port 9031 > ~/relayium-serve.log 2>&1 &

serve trata as conexões uma de cada vez e continua rodando, então está pronto para cada reconexão do laço de repetição abaixo.
Para uma caixa de entrada sempre ativa, execute-o sob systemd em vez disso (Restart=always, --config-dir /etc/relayium).

Executar o sync em um laço de repetição sob tmux (no emissor)

Transferências longas são interrompidas: uma sessão caída, uma rede instável, uma reinicialização. A solução não é uma ferramenta sofisticada; é um laço que reexecuta sync até ter sucesso, mais um multiplexador de terminal para que sobreviva ao seu logout. Aqui o tmux é mais limpo que o nohup: não há redirecionamento de saída para errar, e você pode reconectar para acompanhar o progresso.

Inicie uma sessão do tmux, depois execute o espelho em um laço until — ele tenta de novo a cada 10 segundos até que sync retorne sucesso, e então sai sozinho:

# no EMISSOR
tmux new -s xfer      # apt install -y tmux se estiver faltando

until relayium sync /root/workspace relayium://203.0.113.43:9031; do echo "$(date) retrying"; sleep 10; done

Desanexe com Ctrl-b e depois d; o laço continua rodando depois que você fecha o terminal. Reanexe com tmux attach -t xfer.
Cada tentativa faz menos: os arquivos já transferidos são pulados, um arquivo enviado pela metade é retomado — então o laço converge e termina.
O progresso imprime uma linha por arquivo concluído, então um arquivo grande é transferido em silêncio até terminar. O silêncio não é um travamento (veja solução de problemas).

Verificar e finalizar

A transferência está completa quando o laço until termina e você volta a um prompt de shell normal. Confirme que os dois lados coincidem, depois pare o processo à escuta:

# compare os totais nos DOIS servidores
du -sh /root/workspace

# no RECEPTOR, depois de verificado
pkill -f 'relayium serve'

Cada arquivo foi verificado com SHA-256 na chegada, então tamanhos coincidentes mais uma saída limpa significam uma cópia intacta.

Solução de problemas

Algumas coisas que parecem problemas mas normalmente não são — e a que normalmente é (uma porta bloqueada).

A ausência de saída não é um travamento. O progresso só é impresso quando cada arquivo termina, então um arquivo grande é transferido em silêncio. Verifique o estado real no emissor com ss -tnp | grep 9031 — ESTAB significa que está conectado e transferindo; SYN-SENT significa que não consegue alcançar o processo à escuta.
SYN-SENT significa que a porta está bloqueada. Abra 9031/TCP para o emissor no receptor (grupo de segurança na nuvem, ou ufw allow 9031/tcp). Esta é a causa mais comum de uma transferência que nunca começa.
Prefira tmux mais um laço de uma única linha em vez de um nohup de várias linhas. Colar em uma shell um comando de várias linhas com aspas e um redirecionamento > frequentemente quebra no redirecionamento ou deixa você em um prompt de continuação >.
Ao limpar processos, faça uma correspondência precisa (pkill -f 'relayium sync'), não pkill relayium — uma correspondência ampla pode matar um processo relayium não relacionado rodando na mesma máquina.
Não existe opção de exclusão — em vez disso, escolha as origens. O sync aceita -i e -p (identidade e porta SSH), --delete, --watch e --config-dir, e nada que filtre um caminho no meio da árvore. Para deixar para trás um diretório regenerável como um virtualenv de Python, sincronize os subdiretórios que você realmente quer: o sync aceita várias origens de uma vez, e cada uma chega sob o --dir do receptor com o próprio nome. relayium sync /root/workspace/src /root/workspace/data relayium://203.0.113.43:9031 contra serve --dir /root/workspace as reconstrói em /root/workspace/src e /root/workspace/data, e o venv nunca é percorrido.
Links simbólicos e arquivos especiais são pulados — sync transfere apenas arquivos regulares. Trate separadamente quaisquer links simbólicos importantes.

Perguntas frequentes

O que acontece se a transferência for interrompida no meio do caminho?

Nada se perde. Reexecute relayium sync — ele pula os arquivos que já estão no receptor e retoma um arquivo enviado pela metade a partir do deslocamento de bytes já em disco. O laço until deste guia faz isso automaticamente até que a pasta inteira seja espelhada.

Em que isso difere do rsync?

Ambos fazem espelhamento incremental unidirecional, mas relayium sync roda sobre uma conexão TLS fixada sem exigir conta SSH (daemon direto), autentica as duas máquinas pela impressão digital do certificado e verifica cada arquivo com SHA-256. É o mesmo motor de transferência dos outros modos do relayium.

O sync apaga no receptor os arquivos que removi da origem?

Só se você pedir. Por padrão sync apenas adiciona e atualiza. Passe --delete para espelhar as exclusões, e o receptor precisa executar serve com --allow-delete para que sejam respeitadas — caso contrário a exclusão é ignorada e reportada de volta.

Posso manter duas pastas sincronizadas continuamente?

Sim. Adicione --watch e sync continua rodando, reespelhando a qualquer mudança sob a origem. Para uma movimentação única de uma pasta grande você não precisa dele — o laço de repetição mais um sync simples bastam.

Preciso abrir uma porta?

Para daemon direto, sim — a porta do processo à escuta (9031 por padrão) precisa ser alcançável a partir do emissor. Se você preferir não abrir uma porta e já tiver SSH entre os servidores, sync também funciona sobre SSH: relayium sync /path user@host:/path (relayium precisa estar instalado no remoto).

Espelhe uma pasta entre dois dos seus próprios servidores — incremental, retomável, sem precisar vigiar.

Obter a CLI