Pular para o conteúdo principal

Versão 1.2.1

Visão geral​

Versão 1.2.1 é uma versão menor que introduz melhorias significativas no gerenciamento de notificações de backup, melhora as capacidades de registro de auditoria, corrige a detecção de próxima execução/atrasado em casos extremos e adiciona funcionalidade de backup e restauração do banco de dados. Esta versão se concentra em melhorar a experiência do usuário com Configurações de Notificação.

Novos Recursos​

Gerenciamento Aprimorado de Notificações de Backup​

  • Sistema de padrões e herança no nível do servidor: Configure destinos adicionais padrão (eventos de notificação, e-mails e tópicos NTFY) no nível do servidor que todos os backups herdam automaticamente. Os backups podem substituir esses padrões quando necessário, com indicadores visuais claros mostrando o status de herança.
  • Hierarquia visual melhorada: Os backups agora são agrupados por servidor com linhas de cabeçalho de servidor distintas. Os valores herdados são claramente marcados com ícones de link, e os valores substituídos podem ser facilmente revertidos para herança.
  • Operações em massa: O botão "Sincronizar com todos" limpa todas as substituições de backup para fazer com que todos os backups herdem dos padrões do servidor. O botão "Limpar tudo" limpa todos os destinos adicionais mantendo a estrutura de herança.
  • Funcionalidade de teste: Adicionados botões de testar e-mail e testar notificação diretamente na página de Configurações de Notificações de backup. Os botões de teste estão disponíveis tanto para configurações de backup individual quanto para operações de edição em massa, permitindo que você verifique a entrega de notificações antes de aplicar as alterações.
  • Suporte a código QR: Adicionado botão de código QR para tópicos NTFY para compartilhar facilmente tópicos de notificação com dispositivos móveis.

Aprimoramentos de Modelo de Notificação​

  • Nova variável {log_text}: Adicionada variável {log_text} aos modelos de notificação, fornecendo acesso a mensagens de texto de log para uso em mensagens de notificação. A variável contém o texto completo de avisos e erros combinados, formatado como texto simples com um item por linha.
  • Migração automática de modelos: O sistema inclui um mecanismo de atualização lenta que detecta e atualiza automaticamente os modelos padrão antigos quando são lidos pela primeira vez após uma atualização. Os modelos personalizados são preservados inalterados.

Gerenciamento de Banco de Dados​

  • Funcionalidade de backup do banco de dados: Os administradores agora podem criar backups de todo o banco de dados na página de Configurações de Manutenção do banco de dados. Suporta ambos os formatos binário (.db) e texto SQL (.sql) para flexibilidade.
  • Funcionalidade de restauração do banco de dados: Restaure o banco de dados a partir de arquivos de backup criados anteriormente com criação automática de backup de segurança, validação de integridade e reversão em caso de falha. Todas as sessões são limpas após a restauração por segurança.

Detecção de Chave Mestra​

  • Detecção automática de alteração de chave mestra: Após o login, o sistema verifica automaticamente se o arquivo .duplistatus.key foi alterado. Se detectado, todas as senhas criptografadas são limpas e um popup modal informa aos usuários que as senhas precisam ser reconfiguradas. Isso previne erros ao restaurar de backups ou migrar para um novo sistema.

Melhorias no monitoramento de backup​

  • Exportação CSV aprimorada: Adicionada coluna "Data e hora do último backup (BD)" ao arquivo CSV gerado pelo botão "Baixar CSV" nas configurações de monitoramento de backup. Isso permite que os usuários comparem o data e hora real do último backup do banco de dados com o data e hora configurado de "Último backup".
  • Dica de ferramenta de Próxima execução: Passar o mouse sobre o valor "Próxima execução" em cada linha agora exibe uma dica de ferramenta mostrando o data e hora do último backup do banco de dados, formatado da mesma forma que a exibição de "Próxima execução".

Melhorias de Registro de Auditoria​

  • Entradas individuais de auditoria de notificações: Cada notificação e e-mail enviado agora gera uma entrada separada no log de auditoria com detalhes sobre o canal, configuração e resultado (sucesso ou falha). Isso inclui notificações de teste, fornecendo melhor rastreabilidade para entrega de notificações.
  • Registro robusto de falhas: Todas as operações de log de auditoria para falhas de notificação agora estão encapsuladas em blocos try-catch para evitar que erros de log de auditoria interrompam fluxos de notificação. O sistema tenta recuperar a configuração SMTP se ela não estiver imediatamente disponível ao registrar falhas de e-mail.
  • Log de auditoria melhorado para atualizações de configuração: As entradas de log de auditoria email_config_updated e ntfy_config_updated agora registram apenas quando há alterações reais na configuração. Quando alterações são detectadas, o log de auditoria inclui valores antigos e novos para cada campo modificado, facilitando o rastreamento do que especificamente mudou.

Melhorias na documentação​

  • O estilo da documentação foi atualizado para se alinhar com a aparência e a sensação do aplicativo. A barra lateral também foi revisada para melhorar a visibilidade e facilitar a navegação.

🐛 Correções de Bugs​

  • Data e hora do log de auditoria corrigidas: Os data e hora no visualizador de log de auditoria agora exibem corretamente no fuso horário do navegador do usuário em vez de GMT. Os data e hora do SQLite (armazenados em UTC) agora são analisados corretamente como UTC e convertidos para o fuso horário local do navegador para exibição.
  • Cálculo de "Próxima execução" corrigido e detecção de atraso: A coluna "Próxima execução" nas configurações de monitoramento de backup agora calcula e exibe com precisão a próxima data de backup esperada, levando em conta tanto o agendamento de backup quanto o data e hora do último backup. Isso se aplica a trabalhos de backup agendados e executados manualmente, resultando em detecção de atraso mais confiável.

🚀 Notas de Migração​

Da Versão 1.1.x​

Quando atualizar para a versão 1.2.1:

  1. Modelos de notificação: O sistema atualizará automaticamente os modelos de notificação padrão para incluir a nova variável {log_text} na primeira vez em que forem acessados após a atualização. Os modelos personalizados permanecerão inalterados. Se você deseja usar a nova variável {log_text} em seus próprios modelos, será necessário atualizá-los ou restaurar os modelos padrão manualmente.

  2. Alterações de Chave Mestra: Se você restaurar de um backup ou migrar para um novo sistema com um arquivo .duplistatus.key diferente, o sistema detectará automaticamente isso e solicitará que você reconfigure as senhas criptografadas (senhas SMTP e senhas do servidor Duplicati).

  3. Backup/Restauração do banco de dados: A nova funcionalidade de backup e restauração do banco de dados está disponível na página Configurações de Manutenção do banco de dados. É recomendado criar um backup antes de atualizar, embora nenhuma alteração de esquema de banco de dados seja obrigatória para esta versão.

  4. Não é Necessária Migração de Banco de Dados: Esta versão não requer alterações no esquema do banco de dados.

Pontos de Extremidade da API​

Os seguintes endpoints de API foram introduzidos nesta versão.

Endpoints de Autenticação e Segurança​

  • GET /api/auth/admin-must-change-password - Verificar se o usuário administrador deve alterar a senha

Endpoints de Gerenciamento de Banco de Dados​

  • GET /api/database/backup - Criar backup do banco de dados (formato binário ou SQL)
  • POST /api/database/restore - Restaurar banco de dados a partir do arquivo de backup

Endpoints de Gerenciamento de Backup​

  • GET /api/backups/last-timestamps - Obter últimos timestamps de backup para todas as combinações de servidor-backup

Suporte​

Obtendo Ajuda​

Relatando Bugs​

Quando reportar bugs, por favor inclua:

  • Versão: 1.2.1
  • Sistema operacional e versão
  • Versão do Docker/podman
  • Tipo de container (Docker ou podman/Pod)
  • Mensagens de erro e logs
  • Passos para reproduzir

Changelog​

Alterações da Versão 1.2.1​

  • Adicionado: Sistema de padrões em nível de servidor e herança para notificações de backup
  • Adicionado: Funcionalidade de testar e-mail e testar notificação nas configurações de Notificações de backup
  • Adicionado: Botão de código QR para tópicos NTFY
  • Adicionado: Coluna "Data e hora do último backup (BD)" para exportação CSV de monitoramento de backup
  • Adicionado: Dica de ferramenta para texto "Próxima execução" nas configurações de monitoramento de backup
  • Adicionado: Entradas de log de auditoria individuais para cada notificação e e-mail enviado
  • Adicionado: Robustez aprimorada do log de auditoria para falhas de notificação
  • Adicionado: Variável {log_text} para modelos de notificação com migração automática de modelo
  • Adicionado: Detecção automática de alterações de arquivo de chave mestra
  • Adicionado: Funcionalidade de backup do banco de dados (formatos binário e SQL)
  • Adicionado: Funcionalidade de restauração do banco de dados com backups de segurança e validação de integridade
  • Adicionado: Endpoint de API GET /api/auth/admin-must-change-password para verificar requisito de alteração de senha do admin
  • Adicionado: Endpoint de API GET /api/database/backup para criar backups do banco de dados
  • Adicionado: Endpoint de API POST /api/database/restore para restaurar banco de dados a partir de backup
  • Adicionado: Endpoint de API GET /api/backups/last-timestamps para recuperar data e hora do último backup
  • Alterado: Log de auditoria aprimorado para atualizações de configuração de e-mail e NTFY (registra apenas alterações reais)
  • Alterado: Formulários de alteração de senha não exigem mais confirmação ao exibir senhas sem máscara.
  • Alterado: Senhas são apagadas com segurança da memória quando formulários de alteração de senha são fechados.
  • Alterado: Incluído alternância de visualização de senha no formulário de coleta de backups.
  • Alterado: Variável {server_alias} agora mostra o nome do servidor entre colchetes
  • Alterado: Documentação atualizada, estilo alinhado com a aplicação e barra lateral refatorada.
  • Corrigido: Data e hora do log de auditoria exibindo em GMT em vez do fuso horário do navegador
  • Corrigido: Log de auditoria de falha de e-mail e NTFY
  • Corrigido: Exibição de "Próxima execução" nas configurações de monitoramento de backup mostrando datas incorretas

Licença​

Este projeto está licenciado sob a Apache License 2.0.

Copyright © 2025 Waldemar Scudeller Jr.