Integración externa - TrueNAS

Desarrollo
1

cover-truenas

¡Hola a todos!

Synology, Unraid, UGREEN, QNAP… faltaba TrueNAS, el NAS de todos aquellos que lo han montado con ZFS. Hago mucho autoalojamiento (Sonarr & Radarr, fue un placer), y esta serie es para aquellos que tienen un NAS o un servidor en casa: esta monitoriza el NAS localmente, sin cloud.

Qué hace

  • El NAS: en línea, procesador, memoria, temperatura del procesador, tiempo de funcionamiento, versión, « actualización disponible », número de alertas activas y su nivel más alto.
  • Un dispositivo por pool ZFS: estado (en línea, errores, degradado, fallo…), espacio utilizado, espacio libre, capacidad, días desde el último scrub y sus errores.
  • Un dispositivo por disco: temperatura y estado SMART.
  • Un dispositivo por aplicación y por VM: en marcha o no, estado. Un interruptor Encendido/Apagado opcional, desactivado por defecto.
  • Dos disparadores: « Pool degradado » y « Nueva alerta TrueNAS » (filtrable por nivel, con el texto de la alerta).
  • Dos acciones « Reiniciar/Apagar el NAS », desactivadas por defecto (marcar en la configuración).
  • Un widget: medidores de procesador y memoria, problemas en la parte superior, luego pools, aplicaciones y VM.
  • En francés, inglés, alemán y español.

La parte divertida

Pool degradado → mensaje a toda la casa y una luz que se pone roja
Nueva alerta de nivel Error o superior → notificación con el texto de la alerta
Primer domingo del mes, un pool sin scrub desde 35 días → recordatorio

Instalación

:warning: Gladys 5.1 mínimo.

Llega a la tienda en el próximo paso del indexador. Mientras tanto: Integraciones → Instalar desde GitHub, con GitHub - guim31/gladys-truenas: TrueNAS pools, disks, alerts and apps for Gladys Assistant · GitHub

  1. En TrueNAS: Credentials → Users → Add, un usuario gladys con el rol Read-only Administrator (ni shell ni compartir necesarios).
  2. Conectado con este usuario: menú de usuario en la parte superior derecha → API Keys → Add, y copie la clave (TrueNAS solo la muestra una vez). Para iniciar y detener aplicaciones y VM, se necesitan además los permisos APPS_WRITE y VM_WRITE; para reiniciar o apagar el NAS, un administrador completo.
  3. En Gladys: la dirección del NAS y la clave, marque Aceptar un certificado auto-firmado (TrueNAS genera uno por defecto), luego Probar la conexión.
  4. Pestaña Descubrimiento: añada el NAS, los pools, los discos y las aplicaciones.

Pequeñas reservas honestas

  • HTTPS solo: TrueNAS revoca una clave de API enviada en HTTP simple, por lo que la integración rechaza una dirección en http:// antes de enviar cualquier cosa.
  • TrueNAS 25.04 o más reciente solo (Community Edition, ex-SCALE): ni TrueNAS CORE ni SCALE 24.10, que no tienen esta API. Un NAS por instalación.
  • Los textos de las alertas permanecen en inglés, tal como los escribe TrueNAS. Datasets, comparticiones y instantáneas no se leen.
  • Desarrollado sin TrueNAS. Es un sistema completo, que no he podido ejecutar para la ocasión: la integración se prueba en respuestas reconstruidas a partir del código fuente de TrueNAS (25.04, 25.10 y 26.0 beta). Solo la conexión cifrada se ha verificado de verdad. Los gráficos de procesador, memoria y temperatura, las temperaturas de los discos en 25.04 y el inicio/parada de las aplicaciones están por confirmar. Si tienes un TrueNAS, tus comentarios son más que bienvenidos, y el repositorio contiene un pequeño script de prueba de solo lectura si quieres ayudarme.

Como las anteriores, desarrollado con Claude Code. Proyecto independiente, no afiliado a iXsystems.

Repositorio: GitHub - guim31/gladys-truenas: TrueNAS pools, disks, alerts and apps for Gladys Assistant · GitHub