Um arquivo de configuração desaparece, um serviço não reinicia mais e o backup Borg parece reconfortante. No entanto, um arquivo visível no BorgBackup não prova que você poderá recuperar o arquivo certo no lugar certo.
A forma menos arriscada é restaurar em um diretório vazio, revisar o resultado e, em seguida, comparar antes de tocar no caminho ativo. Assim, você saberá se o repositório, a senha, o arquivo e os dados restaurados são realmente utilizáveis.
Preparar um diretório de restauração isolado
Este procedimento pressupõe um repositório Borg já inicializado e criptografado. Use a mesma conta, a mesma chave SSH e o mesmo método para fornecer a frase de senha que sua tarefa de backup. Se você estiver restaurando arquivos de sistema, a extração deve ter os direitos necessários para ler seus proprietários e permissões.
Antes de iniciar o Borg, observe quatro elementos: a URL exata do repositório, o nome do arquivo, o caminho a ser recuperado e um local de teste com espaço livre suficiente. Um disco montado em /srv ou /var/tmp é mais apropriado do que / ou /etc.
export BORG_REPO='ssh://[email protected]/./srv/borg/servidor1'
mkdir -p /srv/restore-borg-test
findmnt -T /srv/restore-borg-test
df -h /srv/restore-borg-test
findmnt deve mostrar o sistema de arquivos que receberá a extração. df -h evita preencher uma partição local com um arquivo maior do que o esperado. A documentação do BorgBackup detalha o formato dos repositórios e arquivos.
Listar o arquivo e verificar o repositório Borg
Comece pela leitura. O Borg deve abrir o repositório e mostrar os arquivos sem erros de chave, caminho ou autenticação. Em seguida, copie o nome exato do arquivo retido na variável ARCHIVE.
borg list
export ARCHIVE='2026-08-31T02:15:00'
borg list ::"$ARCHIVE"
borg check --repository-only
A última comando verifica a estrutura do repositório, mas não substitui uma restauração. Um controle com --verify-data relembra os dados e pode ser longo em um repositório remoto. Planeje para fora de um período de backup ou de alta atividade no disco.
borg check --verify-data
Extrair um arquivo no diretório de teste
Escolha um arquivo útil, como a configuração de um serviço. Os caminhos listados pelo Borg geralmente não começam com /. Primeiro, verifique se o arquivo solicitado realmente pertence ao arquivo, e em seguida simule a extração.
borg list ::"$ARCHIVE" etc/mon-service/config.yml
borg extract --dry-run ::"$ARCHIVE" etc/mon-service/config.yml
O modo --dry-run exibe o trabalho previsto sem criar o arquivo. Se não houver erro de descriptografia nem caminho ausente, vá para o diretório de teste antes da extração real. O comando borg extract então recria a árvore sob a pasta atual.
cd /srv/restore-borg-test
borg extract ::"$ARCHIVE" etc/mon-service/config.yml
stat etc/mon-service/config.yml
sha256sum etc/mon-service/config.yml
Comparar antes de colocar o arquivo em produção
O arquivo restaurado agora é legível fora da produção. Se ainda houver uma versão ativa, compare-as antes de qualquer cópia. Diferenças podem ser normais após uma modificação recente. Elas devem ser compreendidas, não apagadas por reflexo.
diff -u /etc/mon-service/config.yml
/srv/restore-borg-test/etc/mon-service/config.yml
Para um diretório, substitua diff -u por diff -ru. Mantenha a restauração de teste até o final do incidente. Copiar diretamente do arquivo para /etc, /var/lib ou um banco de dados pode substituir uma versão mais recente e complicar o retorno.
Para um backup em nuvem gerenciado com outra ferramenta, o mesmo princípio se aplica: o artigo sobre Rclone no Linux também aplica uma restauração em um local separado. O Borg é uma boa escolha quando você precisa de desduplicação e criptografia, mas eu sempre privilegiaria uma extração de teste regular em vez de um relatório de backup marcado como bem-sucedido.