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.2.5
- Visualizador de snapshot de backup: botão de ícone em cada linha de backup abre um modal com a lista completa de arquivos do archive, refletindo o estado final após restore (incluindo cadeia full + incrementais).
- Extração seletiva de arquivos: dentro do modal de snapshot é possível selecionar um ou mais arquivos individualmente (ou todos de uma vez) e baixá-los como
.tar.gz. - Busca de arquivos no snapshot: campo de filtro em tempo real para localizar arquivos pelo nome dentro do modal.
- Abas por container: quando um backup contém múltiplos containers, o modal exibe abas para navegar entre eles.
- Suporte à cadeia incremental: a listagem de arquivos mescla automaticamente full + incrementais, garantindo que a visão do snapshot corresponda ao estado real restaurado.
- Volumes de container remoto: ao clicar em um container para selecionar volumes no modal de criação de perfil, a busca de mounts agora utiliza a conexão correta (TCP remoto) quando a origem selecionada é uma conexão Docker remota (porta 2375), corrigindo o erro
ENOENT /var/run/docker.sockque ocorria ao usar origens remotas. - Agrupamento por Docker Compose na lista de containers: containers do modal de criação de profile agora são agrupados visualmente por projeto Compose, com cabeçalho identificando o stack. Containers sem Compose aparecem em grupo separado "Containers avulsos".
- Novos tipos de Storage Location: além do armazenamento local, agora é possível cadastrar destinos remotos: FTP, SFTP, WebDAV e Google Drive.
- Campos dinâmicos por tipo de storage: o modal de criação/edição de Storage Location exibe apenas os campos relevantes ao tipo selecionado (host, porta, usuário, senha, caminho remoto, modo passivo, chave privada SSH, URL WebDAV, credenciais OAuth Google Drive).
- Badge de tipo na listagem: cada Storage Location exibe um badge colorido com seu tipo (Local, FTP, SFTP, WebDAV, Google Drive) e o endereço de destino na tabela.
- Dropdown de profile atualizado: o seletor de Storage Location nos Backup Profiles passa a exibir o tipo de cada location junto ao nome.
- Aba Source (Origens): nova aba acima de Storage Locations para gerenciar origens de conexão Docker, com suporte a Unix socket, conexão direta (TCP porta 2375) e Docker Agent
- Cascade de exclusão de source: ao remover uma origem, todos os profiles e backups associados são automaticamente removidos
- Seleção de source no profile: cada backup profile pode ser vinculado a uma origem Docker específica
- Contagem de arquivos totais antes do inicio do backup para todos os escopos (container inteiro e volumes), corrigindo a barra de progresso que mostrava 0 no total
- Container alvo agora e parado antes do backup de volumes e reiniciado apos conclusao, evitando inconsistencias nos dados arquivados
- Botão
Logna aba Backup Runs: cada run exibe agora um botão que abre um modal com o log completo do backup por container, incluindo saída do tar, avisos e erros ocorridos durante a execução. - Endpoint
GET /api/backups/:backupId: novo endpoint que retorna os dados completos de um backup (incluindo logs) a partir do seu ID. - Logs persistidos por container no backup: o array de logs gerado durante o backup (
pushLog) é agora salvo emcontainerBackup.logse persistido nostore.json, disponível para consulta posterior.
- Dropdowns estilizados como campos de texto: todos os elementos
<select>dentro de.form-fielde o.settings-selectpassaram a usar o mesmo estilo visual dos inputs de texto (borda, padding, tipografia), com ícone de seta customizado via SVG. - Tela Sobre — posição do autor: o texto
Desenvolvido por Alexander Sabino em 2026foi movido para logo abaixo da descrição da aplicação. - Tela Sobre — changelog limitado: a seção de changelog exibe agora apenas as últimas 4 entradas de versão.
- Restore incremental não apagava arquivos deletados entre backups:
tar -xzfsem--listed-incrementalnão honra informações de deleção embutidas no archive incremental. Corrigido: archives commode === 'incremental'agora são extraídos comtar --listed-incremental=/dev/null -xzvf, que instrui o tar a ler o snapshot embutido e remover arquivos que foram deletados entre o backup anterior e o incremental. O archive full continua usando extração simples. - Estatísticas do restore sempre zeradas: o objeto
restoreStatsera criado mas nunca preenchido. Corrigido: o comandotarpassou a usar o flag-v(verbose), que imprime cada arquivo extraído no stdout; o callbackonOutputagora recebe o parâmetrostreamNamee incrementarestoreStats.createda cada linha do stdout, resultando no total real de arquivos restaurados no toast de conclusão. - Path não-nativo (fora do Docker) referenciava
restorePathsindefinido: a variávelrestorePathsera usada no filtro de mounts do path não-nativo sem ter sido declarada nesse escopo. Corrigido: o path não-nativo agora computarestorePathsNonNativea partir dechain[0].backupPaths(igual à lógica do path nativo).
- Restore incremental não aplicava o archive incremental (bug crítico): o
tarfrequentemente retorna código de saída1durante a extração em volumes (avisos de permissão/ownership que não são erros fatais). Como o script do helper era gerado comset -ee comandos encadeados por&&, qualquer exit code1do archive full abortava a cadeia antes de aplicar os archives incrementais. Corrigido: removidoset -ee a junção por&&; cada comandotaragora usa; RC=$?; [ $RC -le 1 ] || exit $RCpara aceitar código0ou1como sucesso e falhar apenas em>= 2(erros fatais do tar). - Path não-nativo (fora do Docker) montava volumes em
/restore/mN: o caminho de restore fora do Docker montava volumes em/restore/m0,/restore/m1etc. e extraía com-C /restore, mas os archives gerados pelo helper atualizado têm paths reais (a0/...,var/lib/gitea/...). Corrigido: o path não-nativo agora monta cada volume no seu path real (igual ao path nativo) e extrai com-C /, tornando os dois paths consistentes.
- Restore de volumes não restaurava arquivos (bug crítico):
putArchiveem container parado escreve na camada overlay do container, não nos volumes nomeados. Ao iniciar, o volume montado (vazio após a limpeza) sobrepunha a camada, tornando os arquivos restaurados invisíveis. Corrigido: o restore de volumes agora usa um helper container que monta cada volume no seu path real (ex:gitea_data:/var/lib/gitea) e extrai os archives diretamente lá comtar -xzf ... -C /. - Backup via helper BusyBox gerava archive com paths incompatíveis: containers sem GNU tar (Alpine/BusyBox) criavam o archive montando volumes em
/payload/m0,/payload/m1etc., gerando entradas comopayload/m0/arquivo. Isso era incompativel com o restore que esperava paths no formato real (var/lib/gitea/arquivo). Corrigido: o helper agora monta cada volume no seu path real no container (ex:/var/lib/gitea), gerando o mesmo formato de archive que o GNU tar nativo.
- Bug crítico no restore de backups: o comando
tar --listed-incremental=/dev/nullera usado na extração, o que apagava arquivos já restaurados pelo backup full ao aplicar incrementais subsequentes, deixando os volumes vazios. Substituído por extração simples (tar -xzf), que sobrepõe corretamente o full + cada incremental. - Restore via helper container agora emite logs: o
runHelperdo restore passou a receberonOutput, de modo que cada linha dotare das etapas de limpeza aparece no log de progresso. - Limpeza de volumes antes do restore (caminho Docker nativo): antes de aplicar os archives via
putArchive, um helper container monta os mesmos volumes do container alvo e remove o conteúdo anterior, garantindo estado consistente pós-restore. - Limpeza antes do restore de container inteiro (caminho Docker nativo): o container é iniciado temporariamente para executar a limpeza do filesystem antes de restaurar via
putArchive.
- Log de progresso do restore na aba Backups: a aba Backups agora exibe o card de progresso (com barras de progresso, etapa atual e log detalhado) durante a execução de um restore, da mesma forma que a aba Profiles já fazia. O card desaparece e a tabela é atualizada ao término.
- Atualização automática da aba Backups após restore: ao concluir o restore com a aba Backups visível, a tabela é recarregada automaticamente para refletir o estado atual dos backups.
- Aba Agendamentos: nova aba que permite criar e gerenciar agendamentos de backup, com suporte a execução única, diária, semanal e mensal.
- Formulário de agendamento: o usuário informa o profile, o tipo de backup (full ou incremental), a frequência, a data/hora de início e se o agendamento está ativo. Para backups incrementais, é possível escolher o backup full base ou usar "Auto" (mais recente disponível).
- Scheduler no backend: loop que roda a cada 60 segundos e dispara automaticamente os backups agendados no horário correto, calculando a próxima execução após cada run recorrente. Agendamentos do tipo "única vez" são desativados automaticamente após execução.
- API de agendamentos: novas rotas
GET /api/schedules,POST /api/schedules,PATCH /api/schedules/:id/toggleeDELETE /api/schedules/:id. - Toggle ativo/inativo: o agendamento pode ser pausado ou reativado diretamente na tabela sem precisar editar o formulário.
- 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.gze a pasta de cada profile agora são deletados corretamente do disco, da mesma forma que acontece ao excluir um profile individualmente.
- Crédito do desenvolvedor na aba Sobre: exibe o texto "Desenvolvido por Alexander Sabino em 2026" ao final da aba Sobre.
- 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
.btncorreto, 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.gzde cada backup registrado no store são deletados do disco antes de remover o registro. Em seguida, a pasta do profile (incluindo arquivos.snare 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).
- 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.
- 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.mddo GitHub, sem necessidade de atualização manual na interface.
- 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-stoppeddescomentado para garantir que o container reinicie automaticamente após uma atualização via botão da aba Sobre.
- 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âmetropathe retorna os subdiretórios não-ocultos do caminho informado, junto ao caminho pai e ao caminho atual.
- Progresso do backup: contador de arquivos processados ultrapassava o total porque
find -type fcontava apenas arquivos regulares, enquanto otar -vemite uma linha por entrada (incluindo diretórios e symlinks). Corrigido removendo-type fdo comandofind. - 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.jsondiretamente do repositório viaraw.githubusercontent.com.
- 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/logine/api/auth-statussão públicos - Atualização automática: endpoint
POST /api/updateexecutagit pulle reinicia o container
- 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).
- Abas Servers e Naming Rules removidas da interface.
- Cadastro de profiles de backup por container
- Backup full e incremental com GNU tar +
--listed-incremental - Restore seletivo de snapshots
- Suporte a escopos
somente volumesecontainer inteiro - Suporte a Docker API nativa (
getArchive/putArchive) quando rodando dentro de container
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 volumesecontainer inteiro - Quando rodando dentro do Docker, usa a API nativa (
getArchive/putArchive) sem helper
npm install- 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:\backupssão convertidos automaticamente para/run/desktop/mnt/host/c/backups - O escopo
container inteiroexige que o app esteja rodando em Docker
docker compose up --buildAcesse http://localhost:3000.
npm start- 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.gzsão gravados no diretório configurado em cada profile - O arquivo
docker-compose.example.ymlfoi mantido como referência equivalente ao compose principal