dockerbackup/README.md

2.3 KiB

DockerBackup

DockerBackup

Backup e restauração de containers Docker via interface web, com suporte a snapshots incrementais e restore seletivo.

⚠️ AVISO CRÍTICO: Aplicação em estágio inicial de desenvolvimento. Não use em produção — há risco de perda de dados.

Versão atual: 1.0.0


🗄️ Visão geral

O dockerbackup fornece:

  • Cadastro de profiles de backup por container
  • Backup full e incremental com GNU tar + --listed-incremental
  • Restore seletivo de snapshots, escolhendo quais containers restaurar
  • Suporte a dois escopos: somente volumes e container inteiro
  • Quando rodando dentro do Docker, usa a API nativa (getArchive/putArchive) sem helper

⚙️ Instalação

npm install

Requisitos

  • Docker Engine com acesso ao socket em /var/run/docker.sock
  • O diretório de backup configurado no profile precisa ser visível para o Docker daemon
  • Em Docker Desktop no Windows (fora de container), paths como C:\backups são convertidos automaticamente para /run/desktop/mnt/host/c/backups
  • O escopo container inteiro exige que o app esteja rodando em Docker

▶️ Execução

Com Docker Compose (recomendado)

docker compose up --build

Acesse http://localhost:3000.

Sem Docker

npm start

📋 Observações

  • O restore valida se o conjunto de mounts do container continua igual ao do backup selecionado
  • O catálogo de profiles e histórico de backups fica em ./data/store.json
  • Os arquivos .tar.gz são gravados no diretório configurado em cada profile
  • O arquivo docker-compose.example.yml foi mantido como referência equivalente ao compose principal