Ir para o conteúdo

BombVault

Drop a backup. Detonate a restore.

Backup and full disaster recovery for Unraid and other Docker hosts. Containers, VMs, folders, ZFS datasets and the flash drive, restored the way they were.

BombVault

Os teus dados do Unraid, selados num cofre. Larga um backup. Detona um restauro.

A visão geral: o cabeçalho de estado, o que precisa de ti, a proteção de cada secção, os destinos de armazenamento e o histórico. A visão geral: o cabeçalho de estado, o que precisa de ti, a proteção de cada secção, os destinos de armazenamento e o histórico.

O BombVault é uma aplicação web self-hosted para backup e recuperação total de desastres no Unraid e noutros anfitriões Docker, como o TrueNAS SCALE, o ZimaOS ou uma simples máquina Linux. Faz backup de containers Docker, VMs KVM/libvirt, pastas, conjuntos de dados ZFS e da unidade flash do Unraid. Corre como um único container Docker multi-arch, dá-te uma interface web num tema escuro, claro ou do sistema e trata de todo o ciclo de vida: fazer backup, agendar, verificar e restaurar.

Os restauros são automáticos. No Unraid, os containers reaparecem no separador Docker exatamente como antes, e as VMs são redefinidas no Gestor de VMs com os seus discos e a NVRAM UEFI voltados a ligar. Sem reinstalações manuais, sem reconfiguração, sem dramas. No TrueNAS, um container restaurado ao lado do original corre como um container Docker simples que o ecrã Apps não lista.

Assente no restic, por isso cada backup é deduplicado, incremental e encriptado por predefinição.

Guarda a tua APP_KEY em segurança

O BombVault deriva a palavra-passe do repositório restic a partir de um segredo de 32 bytes chamado APP_KEY. Perdê-lo, juntamente com o kit de recuperação, torna os backups encriptados irrecuperáveis. Gera um com openssl rand -hex 32 e guarda-o num local seguro. Consulta Configuração.

O que o BombVault protege

Cada container, VM, conjunto de pastas, a flash, cada conjunto de dados ZFS e as definições do próprio BombVault são uma entrada com uma página própria. As entradas do mesmo tipo formam uma secção, que ligas em Definições, Geral.

Secção O que é guardado
Containers Diretório appdata mais a definição do container (imagem, variáveis de ambiente, portas, etiquetas, volumes).
VMs Imagens de disco da VM, a definição XML e a NVRAM UEFI, com backup por SSH (sem montagem de libvirt).
Flash Toda a flash USB (/boot): sistema, licença, configuração do array, partilhas, rede e configuração de plugins.
Auto-backup O próprio /config do BombVault: a base de dados de definições, as credenciais dos seus destinos, o par de chaves SSH do libvirt, a chave e as chaves de anfitrião fixadas dos servidores ZFS e os certificados.
Pastas Qualquer pasta do servidor como conjunto de pastas, cada um com padrões de exclusão opcionais.
Conjuntos de dados ZFS Um conjunto de dados com todos os que estão abaixo dele, lido de um instantâneo ZFS e guardado como uma pasta. Vê Conjuntos de dados ZFS.

O restauro é a estrela

Depois de copiar os dados de volta a partir do instantâneo do restic, o BombVault reproduz a definição de container guardada contra a API do Docker, para que o container reapareça no separador Docker do Unraid como se sempre lá tivesse estado (mesma imagem, mesmas definições, mesmos mapeamentos de portas). As VMs têm o seu XML redefinido por SSH e os seus discos e a NVRAM UEFI voltados a ligar, mesmo depois de a VM ter sido eliminada.

Uma só janela restaura todos os tipos. Por predefinição escolhe Ao lado do original, que traz o backup de volta como cópia e deixa o original como está. Substituir o original faz primeiro backup do estado atual, para que uma restauração possa ser desfeita. Uma pasta ou um novo conjunto de dados ZFS são os outros destinos.

Quando um backup pára containers dependentes, estes voltam na ordem certa: o BombVault reinicia-os pela ordem depends_on do Compose e espera que cada um se declare saudável antes de iniciar os que dependem dele, para que nada avance à frente de uma base de dados ou de um gateway que ainda não esteja de pé. Vê Restauração e Comandos e outros containers.

Como funciona

Browser --HTTPS--> BombVault container
                   |- Go binary: JSON API + embedded React UI
                   |- Background worker (per-section scheduler + job executor)
                   |
                   |- /var/run/docker.sock  -> Docker API (container stop/inspect/recreate)
                   |- qemu+ssh://host       -> libvirt / KVM on the HOST over SSH (no mount)
                   |- /mnt/ -> /host/user   -> appdata, VM disks + restic repos (read/write)
                   |- /boot/ -> /host/boot  -> Unraid flash backup (whole USB)
                   |- /config               -> BombVault's own settings + sign-ins (self-backup)
                   '- <repo path>           -> restic repository (local or remote: rclone/s3/rest/sftp)

O BombVault usa o socket Docker para parar os containers antes de um backup e recriá-los depois de uma restauração. Para as VMs, corre virsh no host por SSH (qemu+ssh://) para encerrar uma VM de forma ordenada ou tirar um instantâneo a quente. Nunca monta um caminho do libvirt, por isso não pode atrapalhar o Gestor de VMs do host.

O BombVault é a camada de orquestração e de interface, não o motor de armazenamento. Todo o movimento de dados passa pelo restic.

Início rápido

Novo por aqui? Vai a Introdução para instalares o BombVault e correres o teu primeiro backup, e depois configura o Externo e recuperação. Os exemplos práticos percorrem as tarefas mais comuns do princípio ao fim, a página Definições lista todos os mosaicos, e as Funcionalidades são o catálogo curto de tudo o que o BombVault faz.

Cada secção pode copiar para vários destinos ao mesmo tempo, um BombVault emparelhado pode guardar as tuas cópias externas num servidor que recusa eliminações, e o Assistente de emergência recupera um servidor perdido a partir do kit de recuperação, através do teu grupo ou com a chave escrita à mão. Para levares a configuração para uma máquina nova, usa o cartão Exportar / importar configurações. Vê Externo e recuperação e Configuração.

A Aplicação Android leva todos os servidores do teu grupo para o telemóvel, com o registo de atividade de todos eles num só ecrã.

A documentação existe em 26 idiomas e a interface em 42. As páginas que ainda não têm tradução aparecem em inglês.

Palavras usadas aqui

Algumas palavras têm um significado fixo no BombVault e nestas páginas.

Palavra Significado
Entrada Uma coisa de que o BombVault faz backup: um container, uma VM, um conjunto de pastas, a unidade flash, um conjunto de dados ZFS com os que estão abaixo dele, ou as suas próprias definições. Cada uma tem uma página própria.
Secção Todas as entradas de um tipo, como os Containers. Ligas as secções em Definições, Geral.
Destino Um lugar para onde vão os backups: uma pasta neste servidor, uma partilha, um servidor teu ou um serviço de nuvem. Vê Destinos.
Local O destino neste servidor que guarda as pastas das secções.
Pasta própria O repositório para onde uma secção escreve primeiro os seus backups. Por predefinição fica neste servidor e pode estar num destino. Vê A pasta própria de uma secção.
Cópia Um backup copiado da pasta própria para outro destino com restic copy.
Repositório direto Um repositório num destino externo para onde as entradas fazem backup diretamente, sem uma cópia local pelo meio. Vê Repositórios diretos.
Credencial A chave ou palavra-passe guardada para um serviço S3 ou um rest-server. Uma delas é a predefinida. Vê Credenciais.
Localização por entrada Que destinos recebem os backups de uma entrada, definido na entrada ou como predefinição da sua secção. Vê Localização por entrada.
Réplica Uma cópia exata ao bloco de uma entrada ZFS num segundo servidor ZFS, feita com zfs send. Fica ao lado do backup e não o substitui. Vê Réplica.
Função Algo que uma instância do teu grupo faz por outra: Recetor, Recolhedor, Servidor ZFS ou Guardião da chave. Vê Instâncias e funções.
Nó Um BombVault sem interface web, por exemplo num VPS, a quem outra instância, a sua instância base, diz de que fazer backup, quando e para onde. Vê Nós.
Instância base A instância que adicionou um nó e o controla. Guarda a chave do nó e diz-lhe de que fazer backup, quando e para onde. Vê Nós.

Créditos

  • VolumeVault de @Darkdragon14 (Apache-2.0) deu ao BombVault a sua ideia de partida: backup com um clique e reinstalação automática de containers Docker. O BombVault é uma implementação separada, em Go e restic, que leva a ideia às VMs, ao flash e a mais.
  • restic é o motor de backup rápido, seguro e com deduplicação que o BombVault comanda.
  • rclone fornece os backends de nuvem.
  • A maioria dos glifos dos botões vem do conjunto gratuito Core Solid da Streamline (CC BY 4.0, fonte). Os restantes vêm do Font Awesome Free, Material Design Icons, Simple Icons e Tabler Icons, ou foram desenhados para o projeto.

Licença

Copyright (C) 2026 Junker der Provinz. O BombVault é software livre sob a GNU Affero General Public License v3.0 (LICENSE). Podes executá-lo, estudá-lo, partilhá-lo e alterá-lo. Se o distribuíres, ou se executares uma versão alterada como serviço de rede, tens de publicar o teu código-fonte sob a mesma licença e manter os avisos de copyright e de atribuição existentes.

O nome e a marca não estão licenciados. A AGPL cobre apenas o código-fonte: "BombVault", o seu logótipo e a sua identidade visual continuam reservados, por isso um fork tem de usar um nome e uma identidade visual próprios e não pode apresentar-se como BombVault.

Controlo do host equivalente a root

Através do socket Docker, o BombVault pode parar, remover e recriar containers e ler e escrever o appdata, e para o backup de VMs inicia sessão no host por SSH para correr virsh. Qualquer pessoa que consiga alcançar a interface web tem, na prática, root no host. Corre o BombVault apenas numa rede de confiança e não exposta, e define uma palavra-passe de acesso em Definições, Segurança. O kit de recuperação, os depósitos de chaves, o ZIP do flash e exportar um backup do flash ou um auto-backup exigem-na. Consulta Configuração para o modelo de segurança completo.