♻️ Manual do Script borg_restore.sh

📘 Descrição Geral

O script borg_restore.sh tem como objetivo restaurar backups criados com o BorgBackup, de forma simples, segura e compatível com o formato de repositórios criados pelo script borg_backup.sh.

Ele permite listar snapshots disponíveis, executar simulações de restauração (modo dry-run) e recuperar os arquivos com estrutura limpa — sem incluir caminhos absolutos desnecessários.

🧠 Objetivo

• Restaurar backups criados pelo BorgBackup.
• Listar snapshots existentes antes da restauração.
• Permitir uma simulação prévia (dry-run).
• Suportar criptografia opcional.
• Garantir compatibilidade com o Borg 1.x (Debian/Ubuntu padrão).
• Restaurar conteúdo direto, removendo hierarquia absoluta (--strip-components 3).

⚙️ Parâmetros de Execução

🧰 Exemplo de Uso

🔹 Exemplo 1 — Restauração simples

./borg_restore.sh /media/paulo/borg_backup/scripts/borg-repo /home/paulo/scripts/restaurado

🔹 Exemplo 2 — Restaurar snapshot específico

./borg_restore.sh /media/paulo/borg_backup/scripts/borg-repo /home/paulo/scripts/restaurado backup-2025-10-30

🔹 Exemplo 3 — Restauração automatizada (sem perguntas)

echo "s" | ./borg_restore.sh /media/paulo/borg_backup/scripts/borg-repo /home/paulo/scripts/restaurado backup-2025-10-30

🧱 Estrutura do Script

#!/bin/bash
# ======================================================
# Script: borg_restore.sh
# Objetivo: Restaurar backups feitos com BorgBackup
# Autor: Paulo SSPacheco
# Compatível com Borg 1.x
# ======================================================

🧩 Principais Funções

1️⃣ check_dependencies()

Garante que o BorgBackup está instalado. Caso não esteja, o script realiza a instalação automaticamente:

sudo apt update && sudo apt install -y borgbackup

2️⃣ listar_snapshots()

Lista todos os snapshots (backups) disponíveis no repositório informado:

borg list "$REPO"

Saída típica:

backup-2025-10-30    Thu, 2025-10-30 09:31:12 [c5d00a1cc5b...]
backup-2025-10-31    Fri, 2025-10-31 09:35:01 [a1f00e9e3cd...]

3️⃣ escolher_snapshot()

Se o usuário não especificar um snapshot, o script lista todos e pede que o operador escolha um manualmente.

Exemplo de prompt:

🔍 Nenhum snapshot especificado.
Abaixo estão os backups disponíveis:
📜 Listando backups disponíveis em: /media/paulo/borg_backup/scripts/borg-repo
backup-2025-10-30  Thu, 2025-10-30 09:31:12
Digite o nome do snapshot a restaurar (ex: backup-2025-10-30):

4️⃣ dry_run_restore()

Executa uma simulação de restauração sem alterar nada no disco. Permite revisar o que será restaurado antes da execução real.

borg extract --dry-run --list --strip-components 3 "$REPO::$SNAPSHOT"

Se tudo estiver correto, o usuário confirma:

Deseja continuar com a restauração real? (s/n):

5️⃣ real_restore()

Executa a restauração real no diretório de destino. Os arquivos são extraídos sem incluir o caminho completo original, graças à opção --strip-components 3.

borg extract --progress --list --strip-components 3 "$REPO::$SNAPSHOT"

✅ Ao final, o script exibe:

✅ Restauração concluída com sucesso!
Arquivos restaurados em: /home/paulo/scripts/restaurado

🧩 Organização dos Arquivos Restaurados

Durante o backup, o Borg grava caminhos absolutos como:

home/paulosspacheco/scripts/arquivo1.sh

A opção --strip-components 3 remove os três primeiros diretórios (home, usuario, scripts) para restaurar apenas os arquivos desejados diretamente no destino.

Exemplo final:

/home/paulo/scripts/restaurado/
 ├── borg_backup.sh
 ├── borg_restore.sh
 └── outros_arquivos.sh

🧱 Estrutura do Repositório de Backup

O repositório é criado automaticamente pelo borg_backup.sh e segue o formato:

/media/paulo/Novo volume/borg_backup/
 └── scripts/
     └── borg-repo/
         ├── config
         ├── index.1234567890
         ├── data/
         └── integrity/

Cada execução de backup cria um snapshot incremental:

backup-2025-10-30
backup-2025-10-31
backup-2025-11-01

⚙️ Compatibilidade e Requisitos

⚠️ Cuidados Importantes

• Verifique o ponto de montagem do disco externo antes da restauração.
• Evite restaurar sobre diretórios já existentes (pode sobrescrever arquivos).
• Sempre revise o conteúdo da simulação (--dry-run) antes da restauração real.
• Caso use criptografia, mantenha as chaves e senhas seguras.

🧾 Fluxo Completo de Execução

check_dependencies   # Verifica Borg instalado
escolher_snapshot    # Seleciona snapshot (ou usa argumento)
dry_run_restore      # Simulação (dry-run)
real_restore         # Restauração real dos arquivos

🧩 Exemplo de Execução Real

======================================================
♻️  Restaurador genérico de backups BorgBackup
======================================================
Repositório ....: /media/paulo/Novo volume/borg_backup/scripts/borg-repo
Destino ........: /home/paulo/scripts/restaurado
Snapshot .......: backup-2025-10-30
Criptografia ...: none
======================================================

🧪 Etapa 1: Simulação (dry-run)
borg_backup.sh
borg_restore.sh
borg_backup_pasta_corrente.sh
Deseja continuar com a restauração real? (s/n): s

⚙️  Etapa 2: Iniciando restauração real...
✅ Restauração concluída com sucesso!
Arquivos restaurados em: /home/paulo/scripts/restaurado

🧩 Teste Seguro (Dry Run Manual)

Você também pode testar manualmente, sem alterar nada:

cd /home/paulo/scripts/restaurado
borg extract --dry-run --list /media/paulo/borg_backup/scripts/borg-repo::backup-2025-10-30

🔗 Referências

• 📘 Site oficial do BorgBackup: https://www.borgbackup.org/

• 📖 Documentação detalhada: https://borgbackup.readthedocs.io/en/stable/

• 💡 Guia de comandos Borg (CLI):

  man borg
  

• 💬 Comunidade e suporte: https://github.com/borgbackup/borg/discussions

🧾 Histórico de Versões

✅ Autor

Paulo SSPacheco 💻 Automação e Infraestrutura Linux 📅 Outubro de 2025