Externe Integration - TrueNAS

Entwicklung
1

cover-truenas

Hallo zusammen!

Synology, Unraid, UGREEN, QNAP… es fehlte TrueNAS, das NAS für alle, die ihres selbst mit ZFS aufgebaut haben. Ich betreibe viel Selbsthosting (Sonarr & Radarr, das war ein Vergnügen), und diese Serie ist für alle, die ein NAS oder einen Server zu Hause haben: Diese überwacht das NAS lokal, ohne Cloud.

Was es kann

  • Das NAS: online, Prozessor, Speicher, Prozessortemperatur, Laufzeit, Version, „Update verfügbar“, Anzahl der aktiven Alarme und deren höchstes Niveau.
  • Ein Gerät pro ZFS-Pool: Status (online, Fehler, degradiert, ausgefallen…), belegter Speicherplatz, freier Speicherplatz, Kapazität, Tage seit dem letzten Scrub und dessen Fehler.
  • Ein Gerät pro Festplatte: Temperatur und SMART-Status.
  • Ein Gerät pro Anwendung und pro VM: läuft oder nicht, Status. Ein Ein-/Ausschalter als Option, standardmäßig deaktiviert.
  • Zwei Auslöser: „Pool degradiert“ und „Neuer TrueNAS-Alarm“ (filterbar nach Level, mit dem Alarmtext).
  • Zwei Aktionen „NAS neu starten / ausschalten“, standardmäßig deaktiviert (im Konfigurationsmenü aktivieren).
  • Ein Widget: Prozessor- und Speicheranzeigen, Probleme zuerst, dann Pools, Anwendungen und VMs.
  • Auf Französisch, Englisch, Deutsch und Spanisch.

Das coole Ding

Pool degradiert → Nachricht an das ganze Haus und eine Lampe, die rot wird
Neuer Alarm auf Fehlerlevel oder höher → Benachrichtigung mit dem Alarmtext
Erster Sonntag im Monat, ein Pool ohne Scrub seit 35 Tagen → Erinnerung

Installation

:warning: Gladys 5.1 mindestens.

Sie kommt im Store beim nächsten Indexer-Durchlauf. Bis dahin: Integrationen → Von GitHub installieren, mit GitHub - guim31/gladys-truenas: TrueNAS pools, disks, alerts and apps for Gladys Assistant · GitHub

  1. In TrueNAS: Credentials → Users → Add, ein Benutzer gladys mit der Rolle Read-only Administrator (keine Shell oder Freigabe nötig).
  2. Angemeldet mit diesem Benutzer: Benutzermenü oben rechts → API Keys → Add, und kopieren Sie den Schlüssel (TrueNAS zeigt ihn nur einmal an). Zum Starten und Stoppen von Anwendungen und VMs sind zusätzlich die Rechte APPS_WRITE und VM_WRITE erforderlich; zum Neustarten oder Herunterfahren des NAS ein vollständiger Administrator.
  3. In Gladys: die NAS-Adresse und der Schlüssel, Akzeptieren eines selbstsignierten Zertifikats (TrueNAS generiert eines standardmäßig) aktivieren, dann Verbindung testen.
  4. Tab Entdeckung: NAS, Pools, Festplatten und Anwendungen hinzufügen.

Kleine ehrliche Vorbehalte

  • Nur HTTPS: TrueNAS widerruft einen API-Schlüssel, der über einfaches HTTP gesendet wird, daher lehnt die Integration eine Adresse in http:// ab, bevor etwas gesendet wird.
  • Nur TrueNAS 25.04 oder neuer (Community Edition, ehemals SCALE): weder TrueNAS CORE noch SCALE 24.10, die diese API nicht haben. Ein NAS pro Installation.
  • Die Alarmtexte bleiben auf Englisch, so wie TrueNAS sie schreibt. Datasets, Freigaben und Snapshots werden nicht gelesen.
  • Entwickelt ohne TrueNAS. Es ist ein vollständiges System, das ich für die Gelegenheit nicht zum Laufen bringen konnte: Die Integration wird an Antworten getestet, die aus dem Quellcode von TrueNAS (25.04, 25.10 und 26.0 Beta) rekonstruiert wurden. Nur die verschlüsselte Verbindung wurde tatsächlich überprüft. Die Prozessor-, Speicher- und Temperaturdiagramme, die Festplattentemperaturen in 25.04 und das Starten/Stoppen von Anwendungen müssen bestätigt werden. Wenn Sie ein TrueNAS haben, sind Ihre Rückmeldungen mehr als willkommen, und das Repository enthält ein kleines Skript zum Testen im Lesemodus, falls Sie mir helfen möchten.

Wie die vorherigen, entwickelt mit Claude Code. Unabhängiges Projekt, nicht mit iXsystems verbunden.

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