Solução da comunidade

Serviço Duplicati indisponível no ZimaOS: reponha a base de dados de definições danificada sem eliminar as cópias de segurança

Page 3 of a long January 2026 thread had moved from remote-login and storage problems into a Duplicati startup failure. Logs showed a missing SETTINGS_ENCRYPTION_KEY. A community reply advised recreating only the Duplicati config database with a valid key while preserving sources and backups; the original poster then confirmed they could get into Duplicati.

Na página 3, este longo tópico de suporte já não era principalmente sobre o início de sessão remoto. O problema acionável passou a ser um contentor Duplicati que estava em execução, mas abria como Serviço indisponível. O respetivo registo deu a pista fundamental: a base de dados de definições tinha sido criada sem um SETTINGS_ENCRYPTION_KEY válido, e alterar posteriormente as variáveis de ambiente não tinha corrigido o estado de configuração já criado.

A solução da comunidade foi deliberadamente restrita: remover/recriar o contentor Duplicati, limpar apenas a respetiva base de dados de configuração, manter intactas a pasta de destino das cópias de segurança e as pastas de origem e, em seguida, recriar o Duplicati uma única vez com uma chave de encriptação das definições real. O autor original respondeu mais tarde: «Consegui entrar», confirmando que o procedimento de recuperação restabeleceu o acesso.

Aplicação Duplicati do ZimaOS a mostrar um erro de arranque de Serviço indisponível
O contentor Duplicati de origem aparecia no ZimaOS, mas a respetiva WebUI não conseguia iniciar corretamente.

O Registo do Duplicati Identificou a Chave de Encriptação das Definições em Falta

O registo de origem terminava com:

Missing encryption key, unable to encrypt your settings database
Please set a value for SETTINGS_ENCRYPTION_KEY and recreate the container

Esta é uma evidência muito mais forte do que especular sobre portas ou sobre o acesso remoto ao ZimaOS. A falha estava na camada da aplicação/configuração do Duplicati.

A Chave das Definições Não é Igual à Palavra-passe de Encriptação das Cópias de Segurança

  • SETTINGS_ENCRYPTION_KEY protege a base de dados local de definições do Duplicati;
  • a palavra-passe de encriptação das cópias de segurança protege o conteúdo das cópias;
  • a palavra-passe de início de sessão da WebUI é outra credencial independente.

Mantenha estes segredos documentados num gestor de palavras-passe, em vez de reutilizar um valor de teste fraco como 1234.

Definições da aplicação Duplicati no ZimaOS a mostrar volumes de configuração, de cópia de segurança e de origem, além de SETTINGS_ENCRYPTION_KEY
A configuração de origem misturava definições da aplicação, armazenamento de cópias de segurança e pastas de origem, tornando especialmente importante eliminar apenas o caminho de configuração durante a recuperação.

Não Elimine o Destino das Cópias de Segurança

A fonte advertia explicitamente para não mexer nos dados das cópias de segurança nem nas pastas de origem. A reposição visava apenas a base de dados de configuração do Duplicati no caminho de configuração AppData. Remover um contentor não implica eliminar automaticamente as cópias de segurança quando estas estão armazenadas numa pasta do anfitrião mapeada separadamente.

Recrie o Contentor com uma Chave Válida

  1. pare/remova o contentor Duplicati avariado;
  2. faça uma cópia de segurança e limpe apenas a base de dados de configuração do Duplicati;
  3. defina um SETTINGS_ENCRYPTION_KEY forte;
  4. recrie o contentor uma única vez;
  5. abra a WebUI e verifique se a configuração é iniciada normalmente.

Como se trata de uma resolução de problemas da comunidade, reveja os mapeamentos de volumes atuais antes de eliminar qualquer diretório de configuração.

Não Misture Instalações da Loja de Aplicações e Instalações Manuais do Docker

Anteriormente, no mesmo tópico, o utilizador criou acidentalmente um segundo contentor Duplicati manualmente, enquanto também utilizava a Loja de Aplicações. Isso criou ambiguidades de portas e de configuração. Escolha um método de implementação e mantenha um único caminho de configuração principal.

O Duplicati É uma Cópia de Segurança de Arquivo, Não um Espelho Navegável

A discussão de origem esclareceu posteriormente que o Duplicati armazena blocos e metadados. Não é suposto o destino ter o aspeto de uma cópia normal de todas as pastas de origem; os restauros são efetuados através do Duplicati.

Teste um restauro de um único ficheiro e um restauro de uma pasta antes de confiar na cópia de segurança para dados de produção.

Não Confunda o Duplicati com o Backup do ZimaOS

O ZimaOS também dispõe do seu próprio sistema de cópias de segurança agendadas e versionadas. O Duplicati é útil quando pretende especificamente o formato de arquivo encriptado e o suporte a destinos do Duplicati; a aplicação Backup integrada é mais simples quando as respetivas origens e destinos suportados correspondem aos requisitos.

Consulte o fluxo de trabalho atual do Backup do ZimaOS.

Perguntas Frequentes sobre o Serviço Indisponível do Duplicati

O utilizador de origem confirmou que o acesso foi restabelecido?

Sim. Depois da resolução de problemas relacionada com a configuração e a chave, o autor original disse que conseguiu entrar no Duplicati.

Devo eliminar os meus ficheiros de cópia de segurança do Duplicati para corrigir a WebUI?

Não. A solução de origem visava apenas a base de dados de configuração avariada, não o destino das cópias de segurança nem os dados de origem.

SETTINGS_ENCRYPTION_KEY é a palavra-passe da cópia de segurança?

Não. Protege a base de dados local de definições do Duplicati e é independente da encriptação do conteúdo das cópias de segurança.