Ir al contenido principal

Versión 1.2.1

Resumen​

Versión 1.2.1 es una versión menor que introduce mejoras significativas en la gestión de notificaciones de backup, mejora las capacidades de registro de auditoría, corrige la detección de próxima ejecución/retrasado en casos extremos y añade funcionalidad de backup y restauración de base de datos. Esta versión se enfoca en mejorar la experiencia del usuario con la configuración de notificaciones.

Nuevas Características​

Gestión mejorada de notificaciones de backup​

  • Sistema de herencia y valores por defecto a nivel de servidor: Configure Destinos adicionales por defecto (Eventos de notificación, Correos electrónicos y temas NTFY) a nivel de servidor que todas las copias de seguridad heredan automáticamente. Los backups pueden anular estos valores por defecto cuando sea necesario, con indicadores visuales claros que muestren el estado de herencia.
  • Jerarquía visual mejorada: Los backups ahora se agrupan por servidor con filas de encabezado de servidor distintas. Los valores heredados se marcan claramente con iconos de enlace, y los valores anulados se pueden revertir fácilmente a la herencia.
  • Operaciones masivas: El botón "Sincronizar con todos" limpia todas las anulaciones de backup para que todas las copias de seguridad hereden de los valores por defecto del servidor. El botón "Limpiar todos" limpia todos los Destinos adicionales mientras mantiene la estructura de herencia.
  • Funcionalidad de prueba: Se agregaron botones de Probar correo electrónico y Probar notificación directamente en la página de Configuración de Notificaciones de backup. Los botones de prueba están disponibles tanto para la configuración individual de backup como para operaciones de Edición masiva, lo que le permite verificar la entrega de notificaciones antes de aplicar cambios.
  • Compatibilidad con códigos QR: Se agregó botón de código QR para temas NTFY para compartir fácilmente temas de notificación con dispositivos móviles.

Mejoras en Plantillas de Notificación​

  • Nueva variable {log_text}: Se añadió la variable {log_text} a las plantillas de notificación, proporcionando acceso a los mensajes de texto de registro para su uso en mensajes de notificación. La variable contiene el texto completo de advertencias y errores combinados, formateado como texto sin formato con un elemento por línea.
  • Migración automática de plantillas: El sistema incluye un mecanismo de actualización diferida que detecta y actualiza automáticamente las plantillas por defecto antiguas cuando se leen por primera vez después de una actualización. Las plantillas personalizadas se conservan sin cambios.

Gestión de Bases de Datos​

  • Funcionalidad de Backup de base de datos: Los administradores ahora pueden crear backups de toda la base de datos desde la página de Configuración de Mantenimiento de base de datos. Admite formatos binarios (.db) y texto SQL (.sql) para mayor flexibilidad.
  • Funcionalidad de Restauración de base de datos: Restaure la base de datos desde archivos de backup creados anteriormente con creación automática de backup de seguridad, validación de integridad y reversión en caso de fallo. Todas las sesiones se cierran después de la restauración por razones de seguridad.

Detección de Clave Maestra​

  • Detección automática de cambio de clave maestra: Después de iniciar sesión, el sistema comprueba automáticamente si el archivo .duplistatus.key ha cambiado. Si se detecta, todas las contraseñas cifradas se borran y un cuadro de diálogo modal informa a los usuarios que las contraseñas deben reconfigurarse. Esto previene errores al restaurar desde Backups o migrar a un nuevo Sistema.

Mejoras en la supervisión de backups​

  • Exportación CSV mejorada: Se agregó la columna "Marca de tiempo del último backup (BD)" al archivo CSV generado por el botón "Descargar CSV" en la configuración de supervisión de backups. Esto permite a los usuarios comparar la marca de tiempo real del último backup de la base de datos con la marca de tiempo "Último backup" configurada.
  • Información sobre "Próxima ejecución": Al pasar el cursor sobre el valor "Próxima ejecución" en cada fila, ahora se muestra una información sobre herramientas que muestra la marca de tiempo del último backup de la base de datos, formateada de la misma manera que la pantalla "Próxima ejecución".

Mejoras en el Registro de Auditoría​

  • Entradas individuales de auditoría de notificaciones: Cada notificación y correo electrónico enviado ahora genera una entrada de log de auditoría separada con detalles sobre el canal, la configuración y el resultado (éxito o fallo). Esto incluye notificaciones de prueba, proporcionando una mejor trazabilidad para la entrega de notificaciones.
  • Registro de fallos robusto: Todas las operaciones de logging de auditoría para fallos de notificaciones ahora están envueltas en bloques try-catch para evitar que los errores de logging de auditoría rompan los flujos de notificaciones. El sistema intenta recuperar la configuración SMTP si no está inmediatamente disponible al registrar fallos de correo electrónico.
  • Logging de auditoría mejorado para actualizaciones de configuración: Las entradas de log de auditoría email_config_updated y ntfy_config_updated ahora solo se registran cuando hay cambios reales en la configuración. Cuando se detectan cambios, el log de auditoría incluye valores antiguos y nuevos para cada campo modificado, facilitando el seguimiento de qué cambió específicamente.

Mejoras en la documentación​

  • El estilo de la documentación se ha actualizado para alinearse con la apariencia y la experiencia del usuario de la aplicación. La barra lateral también ha sido revisada para mejorar la visibilidad y facilitar la navegación.

🐛 Correcciones de Errores​

  • Marcas de tiempo del log de auditoría corregidas: Las marcas de tiempo en el visor de log de auditoría ahora se muestran correctamente en la zona horaria del navegador del usuario en lugar de GMT. Las marcas de tiempo de SQLite (almacenadas en UTC) ahora se analizan correctamente como UTC y se convierten a la zona horaria local del navegador para su visualización.
  • Cálculo de "Próxima ejecución" corregido y detección de retrasos mejorada: La columna "Próxima ejecución" en la configuración de supervisión de backups ahora calcula y muestra con precisión la siguiente fecha de backup esperada, teniendo en cuenta tanto la programación del backup como la marca de tiempo del último backup. Esto se aplica tanto a trabajos de backup programados como ejecutados manualmente, lo que resulta en una detección de retrasos más confiable.

🚀 Notas de Migración​

Desde la Versión 1.1.x​

Al actualizar a la versión 1.2.1:

  1. Plantillas de notificación: El sistema actualizará automáticamente las plantillas de notificación por defecto para incluir la nueva variable {log_text} la primera vez que se acceda a ellas después de actualizar. Las plantillas personalizadas permanecerán sin cambios. Si desea utilizar la nueva variable {log_text} en sus propias plantillas, deberá actualizarlas o restaurar las plantillas por defecto manualmente.

  2. Cambios de Clave Maestra: Si restaura desde un backup o migra a un nuevo sistema con un archivo .duplistatus.key diferente, el sistema detectará automáticamente esto y le solicitará que reconfigure las contraseñas cifradas (contraseñas SMTP y contraseñas del servidor Duplicati).

  3. Backup/Restauración de base de datos: Nueva funcionalidad de backup y restauración de base de datos disponible en la página de Configuración de Mantenimiento de base de datos. Se recomienda crear un backup antes de actualizar, aunque no se requieren cambios de esquema de base de datos para esta versión.

  4. No se requiere migración de base de datos: Esta versión no requiere cambios en el esquema de la base de datos.

Puntos finales de API​

Los siguientes puntos finales de API se han introducido en esta versión.

Puntos finales de autenticación y seguridad​

  • GET /api/auth/admin-must-change-password - Verificar si el usuario administrador debe cambiar la contraseña

Puntos finales de gestión de base de datos​

  • GET /api/database/backup - Crear backup de base de datos (formato binario o SQL)
  • POST /api/database/restore - Restaurar base de datos desde archivo de backup

Puntos finales de gestión de backup​

  • GET /api/backups/last-timestamps - Obtener las marcas de tiempo del último backup para todas las combinaciones de servidor-backup

Soporte​

Obtener Ayuda​

Informar de Errores​

Cuándo reportar errores, incluya:

  • Versión: 1.2.1
  • Sistema operativo y versión
  • Versión de Docker/podman
  • Tipo de contenedor (Docker o podman/Pod)
  • Mensajes de error y logs
  • Pasos para reproducir

Registro de cambios​

Cambios de la Versión 1.2.1​

  • Agregado: Sistema de valores predeterminados a nivel de servidor e herencia para notificaciones de backup
  • Agregado: Funcionalidad de correo electrónico de prueba y notificación de prueba en la configuración de Notificaciones de backup
  • Agregado: Botón de código QR para temas NTFY
  • Agregado: Columna "Marca de tiempo del último backup (BD)" a la exportación CSV de supervisión de backups
  • Agregado: Información sobre herramientas para el texto "Próxima ejecución" en la configuración de supervisión de backups
  • Agregado: Entradas de log de auditoría individuales para cada notificación y correo electrónico enviados
  • Agregado: Robustez mejorada del registro de auditoría para fallos de notificación
  • Agregado: Variable {log_text} en plantillas de notificación con migración automática de plantillas
  • Agregado: Detección automática de cambios de archivo de clave maestra
  • Agregado: Funcionalidad de backup de base de datos (formatos binario y SQL)
  • Agregado: Funcionalidad de restauración de base de datos con backups de seguridad y validación de integridad
  • Agregado: Punto final de API GET /api/auth/admin-must-change-password para verificar el requisito de cambio de contraseña de administrador
  • Agregado: Punto final de API GET /api/database/backup para crear backups de base de datos
  • Agregado: Punto final de API POST /api/database/restore para restaurar la base de datos desde backup
  • Agregado: Punto final de API GET /api/backups/last-timestamps para recuperar marcas de tiempo del último backup
  • Cambiado: Registro de auditoría mejorado para actualizaciones de configuración de correo electrónico y NTFY (solo registra cambios reales)
  • Cambiado: Los formularios de cambio de contraseña ya no requieren confirmación cuando se muestran contraseñas sin enmascarar.
  • Cambiado: Las contraseñas se borran de forma segura de la memoria cuando se cierran los formularios de cambio de contraseña.
  • Cambiado: Se incluyó un botón de alternancia de visualización de contraseña en el formulario de recopilación de backups.
  • Cambiado: La variable {server_alias} ahora muestra el nombre del servidor entre corchetes
  • Cambiado: Documentación actualizada, estilo alineado con la aplicación y barra lateral refactorizada.
  • Corregido: Marcas de tiempo del log de auditoría que se mostraban en GMT en lugar de la zona horaria del navegador
  • Corregido: Registro de auditoría de fallos de correo electrónico y NTFY
  • Corregido: Pantalla de "Próxima ejecución" en la configuración de supervisión de backups que mostraba fechas incorrectas

Licencia​

Este proyecto está licenciado bajo la Licencia Apache 2.0.

Copyright © 2025 Waldemar Scudeller Jr.