Sabinvs
/
dockerbackup
mirror of https://github.com/asabino2/dockerbackup.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
dockerbackup/README.md

8.1 KiB
Raw Blame History

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: 0.0.9

<EFBFBD> Changelog

[0.0.9] — 2026-05-09

Corrigido

  • Exclusão em cascata de Storage Location não removia arquivos do disco: ao excluir um Storage Location (que por consequência exclui os profiles vinculados), os arquivos .tar.gz e a pasta de cada profile agora são deletados corretamente do disco, da mesma forma que acontece ao excluir um profile individualmente.

Adicionado

  • Crédito do desenvolvedor na aba Sobre: exibe o texto "Desenvolvido por Alexander Sabino em 2026" ao final da aba Sobre.

[0.0.8] — 2026-05-09

Corrigido

  • Botões dos modais: botões "Marcar todos" e "Confirmar seleção" do modal de seleção de volumes (e de todos os outros dialogs modais) agora usam o sistema de design .btn correto, com estilos primário e secundário consistentes com o restante da interface.
  • Exclusão de arquivos de backup em disco: ao excluir um profile, todos os arquivos .tar.gz de cada backup registrado no store são deletados do disco antes de remover o registro. Em seguida, a pasta do profile (incluindo arquivos .snar e outros arquivos não catalogados) também é removida. A deleção agora cobre backups feitos com diferentes diretórios (ex.: após troca de Storage Location).

[0.0.7] — 2026-05-09

Adicionado

  • Exclusão em cascata de Storage Location: ao excluir um local de armazenamento, o sistema busca automaticamente todos os profiles vinculados e seus respectivos backups e os exclui junto. Antes de confirmar, o usuário recebe um aviso detalhado listando os nomes dos profiles afetados e a quantidade de backups que serão removidos.
  • Rota GET /api/storage-locations/:id/impact: nova rota que retorna, sem fazer alterações, quantos profiles e backups serão impactados pela exclusão de um local de armazenamento.

[0.0.6] — 2026-05-09

Adicionado

  • Seletor de temas: nova seção na aba Configurações com 11 temas visuais (Padrão, Escuro, Amanhecer, Floresta, Oceano, Púrpura, Rosa, Laranja, Grafite, Safira, Alto Contraste). O tema selecionado é aplicado imediatamente e salvo no navegador.
  • Changelog dinâmico: a aba Sobre agora busca e exibe o changelog diretamente do README.md do GitHub, sem necessidade de atualização manual na interface.

Corrigido

  • Botões Run/Editar/Excluir: estilizados usando o sistema de design existente (.btn). Run ficou azul/primário, Editar em cinza/secundário e Excluir em vermelho com borda.
  • docker-compose.yml: restart: unless-stopped descomentado para garantir que o container reinicie automaticamente após uma atualização via botão da aba Sobre.

[0.0.5] — 2026-05-09

Adicionado

  • Navegador de diretórios: no modal de criação/edição de Storage Location, o campo Diretório ganhou um botão de pesquisa (ícone de pasta). Ao clicar, abre um popup que lista os diretórios do servidor, permitindo navegar hierarquicamente e selecionar o caminho desejado sem precisar digitá-lo manualmente.
  • Rota GET /api/browse-dirs: nova rota protegida que aceita o parâmetro path e retorna os subdiretórios não-ocultos do caminho informado, junto ao caminho pai e ao caminho atual.

[0.0.4] — Correções de bugs

Corrigido

  • Progresso do backup: contador de arquivos processados ultrapassava o total porque find -type f contava apenas arquivos regulares, enquanto o tar -v emite uma linha por entrada (incluindo diretórios e symlinks). Corrigido removendo -type f do comando find.
  • Aba Sobre — última versão: a verificação da versão mais recente era feita no browser, falhando dentro do Docker por restrições de rede/CORS. A requisição foi movida para o backend, que lê o package.json diretamente do repositório via raw.githubusercontent.com.

[0.0.3] — Settings, About, i18n e autenticação

Adicionado

  • Configurações: nova aba com seletor de idioma (10 idiomas) e controle de acesso por usuário/senha
  • Sobre: nova aba com logo, descrição, versão atual, verificação de última versão via GitHub e botão de atualização automática
  • i18n: suporte a 10 idiomas — Português (pt-BR), English, Español, Deutsch, Polski, Italiano, Русский, 中文, 日本語, فارسی
  • Autenticação opcional: todas as rotas da API protegidas por token SHA-256 quando habilitado; endpoints /api/login e /api/auth-status são públicos
  • Atualização automática: endpoint POST /api/update executa git pull e reinicia o container

[0.0.2] — 2026-05-09

Adicionado

  • Storage Locations: nova seção para cadastrar locais de armazenamento (nome + diretório). Agora o diretório de backup é selecionado via dropdown ao criar/editar um profile, em vez de ser digitado manualmente.
  • Backup Incremental — seleção de base: ao executar um backup incremental com múltiplos backups full disponíveis, um modal é exibido para o usuário escolher qual será usado como base. Com apenas um full disponível, é selecionado automaticamente.
  • Bloqueio de incremental sem full: o botão de backup incremental é bloqueado com mensagem de aviso caso não exista nenhum backup full realizado para o profile.
  • Agrupamento na aba Backups: backups incrementais são exibidos agrupados e indentados abaixo do seu respectivo backup full, com badges visuais distintos (verde para Full, amarelo para Incremental).

Removido

  • Abas Servers e Naming Rules removidas da interface.

[0.0.1] — inicial

  • Cadastro de profiles de backup por container
  • Backup full e incremental com GNU tar + --listed-incremental
  • Restore seletivo de snapshots
  • Suporte a escopos somente volumes e container inteiro
  • Suporte a Docker API nativa (getArchive/putArchive) quando rodando dentro de container

<EFBFBD>🗄️ 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