Backup and restore

Onde fica no painel: System › Admin › Backup (/backup) aparece apenas quando o módulo DDoS & BGP está ativado; para uma instalação padrão, use a linha de comando abaixo.

O que é incluído no backup

sudo nexcmp backup cria um arquivo compactado contendo:

Parte	Conteúdo
data/**/*.db	Todos os bancos de dados SQLite em /var/lib/nexcmp, copiados com a API de backup online do SQLite — consistente mesmo com o painel em execução
files.tar	Todos os outros arquivos em /var/lib/nexcmp (arquivos de configuração, uploads de marca, secrets/), exceto bancos de dados e a pasta updates/
etc/	Uma cópia de /etc/nexcmp (configurações do instalador, ID da instância, porta e bind)

O arquivo compactado contém suas chaves mestras

secrets/ armazena a chave que criptografa chaves de API, credenciais de pagamento e senhas SMTP armazenadas no banco de dados. O arquivo é criado com permissões 0600. Armazene-o criptografado e fora do servidor. Sem essas chaves, um banco de dados restaurado não poderá descriptografar seus segredos.

Criar um backup

sudo nexcmp backup                 # writes to /var/backups/nexcmp
sudo nexcmp backup /mnt/nas/nexcmp # or to another directory

O comando exibe o caminho do arquivo, por exemplo /var/backups/nexcmp/nexcmp-backup-20261030-120000.tar.zst.

Agende o backup

echo '17 3 * * * root /usr/local/bin/nexcmp backup /var/backups/nexcmp && find /var/backups/nexcmp -name "nexcmp-backup-*" -mtime +14 -delete' | sudo tee /etc/cron.d/nexcmp-backup

Copie a pasta para fora da máquina (armazenamento de objetos, NAS, outro servidor).

Restauração

Restaure em um servidor onde o NexCMP da mesma versão (ou mais recente) esteja instalado.

1. Instale o NexCMP com o instalador usando a mesma licença e domínio, mas não execute o assistente de configuração.
2. Pare os serviços:

   sudo systemctl stop nexcmp-vmd nexcmp

3. Descompacte o arquivo em um diretório temporário:

   sudo mkdir /root/restore && sudo tar --zstd -xf nexcmp-backup-20261030-120000.tar.zst -C /root/restore

4. Restaure os arquivos:

   sudo tar -xf /root/restore/files.tar -C /var/lib/nexcmp
   sudo cp -a /root/restore/data/. /var/lib/nexcmp/
   sudo cp -a /root/restore/etc/. /etc/nexcmp/
   sudo chown -R nexcmp:nexcmp /var/lib/nexcmp

5. Inicie os serviços e verifique:

   sudo systemctl start nexcmp nexcmp-vmd
   sudo nexcmp status

6. Entre em https://<domain>/admin com o administrador do sistema do qual foi feito o backup.

Faça um ensaio

Execute os passos 1 a 6 em um servidor reserva uma vez, antes de precisar. Um backup que você nunca restaurou é apenas uma esperança.

Não incluído

• Configuração do nginx e certificados (regenerados pelo instalador; os certificados Let's Encrypt são reemitidos).
• Seus servidores CloudStack / Proxmox VE e as máquinas virtuais neles — faça o backup deles com suas próprias ferramentas.