Zum Hauptinhalt springen

UGREEN NAS Smart-Home-Integration, kostenlos und Open Source

UGREEN NAS-Integration für Gladys Assistant

Überwache ein UGREEN NASync (UGOS Pro): Prozessor, Speicher, Temperaturen, Volumes, Festplatten.

Auf GitHub ansehenAlle externen Integrationen

Behalte in Gladys ein UGREEN NASync mit UGOS Pro im Blick: Prozessor, Arbeitsspeicher, Temperaturen, Netzwerk, Volumes und Festplatten, dazu Szenen, wenn ein Volume oder eine Festplatte Aufmerksamkeit braucht, und ein Dashboard-Widget.

Die Integration liest nur und ändert nie etwas am NAS – kein Herunterfahren, kein Neustart, keine Dateioperation.

Ohne die Hardware entwickelt: Rückmeldungen willkommen. Die API von UGOS Pro ist nicht dokumentiert; diese Integration folgt dem, was andere freie Projekte auf echten NAS auslesen. Wenn bei deinem NAS etwas fehlt oder nicht stimmt, eröffne ein Issue: https://github.com/guim31/gladys-ugreen-nas/issues.

Nicht mit UGREEN verbunden, weder von UGREEN unterstützt noch finanziert. UGREEN, NASync und UGOS sind Marken ihrer jeweiligen Inhaber.

Was du bekommst​

Sobald die Konfiguration steht, schlägt der Tab Entdecken die folgenden Geräte vor. Füge die hinzu, die du beobachten möchtest: Ohne dich wird nichts angelegt.

Das NAS​

  • Online: 1, solange das NAS antwortet, 0, sobald es nicht mehr antwortet.
  • Prozessor und Arbeitsspeicher: Auslastung in %.
  • Prozessortemperatur in °C (sofern die Firmware sie liefert).
  • Empfang und Senden: Netzwerkdurchsatz des NAS in Mbit/s.
  • Laufzeit in Tagen.
  • UGOS-Version.

Volumes​

Ein Gerät pro Volume (Volume 1, Volume 2 …):

  • Belegter Speicher in %;
  • Kapazität und Freier Speicher in GB;
  • Zustand: Intakt, Warnung, Wiederaufbau, Beeinträchtigt, Defekt (der schlechteste Wert aus Volume und zugehörigem Speicherpool);
  • Warnung: 1, wenn der Zustand Aufmerksamkeit erfordert, sonst 0 – praktisch für Szenen und den Verlauf.

Festplatten​

Ein Gerät pro Festplatte (Festplatten und M.2):

  • Temperatur in °C;
  • Zustand, so wie UGOS die Festplatte nach seinen Integritätsprüfungen bewertet: Intakt, Warnung, Kritisch, Ausfall (außerdem Nicht erkannt, Gesperrt);
  • Warnung: 1 bei Warnung, Kritisch oder Ausfall.

Die Integration startet nie einen SMART-Test und liest nie die SMART-Details: Diese Abfragen wecken Festplatten im Ruhezustand auf. Angezeigt wird der Zustand, den UGOS ohnehin schon führt.

Bevor du loslegst​

Ein eigenes Konto​

Lege auf dem NAS ein Konto für Gladys an (UGOS Pro → Systemsteuerung → Benutzer). Soweit wir wissen, bietet UGOS keine Rolle mit reinem Lesezugriff: Beginne mit einem normalen Benutzer. Wenn Volumes und Festplatten nicht erscheinen (die Aktion Verbindung testen meldet „Speicher mit diesem Konto nicht lesbar“), füge das Konto der Gruppe der Administratoren hinzu. Sein Passwort öffnet dann den Zugang zum NAS: Verwende es nur für Gladys.

Zwei-Faktor-Anmeldung​

Die Integration kann keinen Einmalcode eingeben: Nimm ein Konto ohne Zwei-Faktor-Anmeldung.

Konfiguration​

  1. Öffne den Tab Konfiguration der Integration.
  2. NAS-Adresse: seine IP-Adresse in deinem Netzwerk, zum Beispiel 192.168.1.50. Der Port der API, 9999, wird ergänzt. Eine vollständige Adresse funktioniert auch: http://192.168.1.50:9999.
  3. Benutzername und Passwort des oben genannten Kontos. Das Passwort wird mit dem Schlüssel des NAS verschlüsselt übertragen und nie in die Protokolle geschrieben.
  4. Aktualisierungsintervall: jede Minute (Standard), alle 2 oder 5 Minuten.
  5. Sprache der Namen und Zustände: Gladys teilt einer Integration deine Sprache nicht mit. Die Namen der Funktionen (beim Hinzufügen eines Geräts festgelegt), die Zustände und die Szenenvariablen verwenden diese hier.
  6. Speichere und füge die Geräte dann im Tab Entdecken hinzu.

Warum einfaches HTTP auf Port 9999: Dort stellt UGOS Pro seine API bereit, so wie die Weboberfläche und die anderen Projekte sie nutzen. Das Passwort wird nie im Klartext übertragen (RSA-Verschlüsselung, wie bei der Weboberfläche). Über HTTPS zeigt das NAS ein selbstsigniertes Zertifikat: Eine https://-Adresse funktioniert ebenfalls, das Zertifikat wird dann ohne Prüfung akzeptiert.

Szenen​

Die Integration fügt dem Szeneneditor in der Kategorie Integrationen drei Auslöser hinzu:

  • Volume beeinträchtigt: Ein Volume oder sein Speicherpool braucht Aufmerksamkeit (Warnung, Wiederaufbau, Beeinträchtigt oder Defekt). Wird nur erneut ausgelöst, wenn es sich verschlechtert, und wieder, nachdem es intakt war. Auswahl des Volumes optional. Variablen: NAS, Volume, Zustand.
  • Festplattenwarnung: UGOS stuft eine Festplatte als Warnung, Kritisch oder Ausfall ein. Gleiche Regeln. Auswahl der Festplatte optional. Variablen: NAS, Festplatte, Modell, Zustand, Temperatur (°C).
  • NAS nicht erreichbar: Das NAS hat auf zwei Abfragen nacheinander im Abstand von etwa 15 Sekunden nicht geantwortet. Einmal, bis es wieder antwortet. Variablen: NAS, Grund.

Die gesehenen Zustände werden unter /data gespeichert: Ein Neustart von Gladys oder der Integration wiederholt keine Meldung und verpasst keine. Die allererste Abfrage speichert nur die Zustände.

Dashboard-Widget​

Das Widget UGREEN-NAS zeigt die Anzeigen für Prozessor und Arbeitsspeicher, die Prozessortemperatur, dann die Volumes und Festplatten, die Aufmerksamkeit brauchen, jedes Volume mit Belegung und freiem Speicher, den Netzwerkdurchsatz und die Laufzeit. Die Schaltfläche Aktualisieren liest das NAS neu aus.

Verbindung testen​

Die Aktion Verbindung testen im Tab Konfiguration liest das NAS sofort aus und zeigt das Modell, die UGOS-Version und die Zahl der gefundenen Volumes und Festplatten – oder warum es nicht geklappt hat.

Einschränkungen​

  • Nur ein NAS pro Installation.
  • Nur mit nachgebildeten Antworten getestet, nicht an einem echten NAS (siehe oben).
  • Keine Aktion auf dem NAS. Eine Schaltfläche „NAS neu starten“ wurde bewusst weggelassen, denn sie bräuchte ein Administratorkonto, und ein Fehlgriff wäre zu teuer.
  • Nach einem abgelehnten Passwort versucht es die Integration nicht mehr von selbst (UGOS sperrt eine Adresse nach einigen fehlgeschlagenen Anmeldungen). Korrigiere das Passwort und speichere, oder nutze Verbindung testen, um es erneut zu versuchen.

Fehlerbehebung​

  • „antwortet nicht“: Prüfe die Adresse, ob das NAS eingeschaltet ist und ob Gladys den Port 9999 erreicht (Firewall, anderes Netzwerk).
  • „keine UGOS-Pro-API unter dieser Adresse“: Unter der Adresse antwortet etwas, aber nicht wie UGOS Pro. Prüfe den Port (9999); das alte UGOS (ohne Pro) wird nicht unterstützt.
  • „Benutzername oder Passwort abgelehnt“: Prüfe sie in UGOS und speichere die Konfiguration dann erneut.
  • Kein Volume, keine Festplatte: siehe „Ein eigenes Konto“ weiter oben.
  • Eine Temperatur fehlt: Manche Firmwares liefern keine, oder nicht, solange eine Festplatte im Ruhezustand ist.

Rückmeldungen​

Abgedeckte Modelle: die UGREEN-NASync-Reihe mit UGOS Pro (DXP2800, DXP4800, DXP4800 Plus, DXP6800 Pro, DXP8800 Plus, DXP480T Plus …), in der Theorie: Kein Modell konnte getestet werden. Eine Rückmeldung von deinem NAS – was funktioniert, was fehlt – ist der hilfreichste Beitrag: https://github.com/guim31/gladys-ugreen-nas/issues.

Konfigurationseinstellungen​

Diese Einstellungen fragt UGREEN NAS in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Dein UGREEN-NASsectionNeinGladys liest das NAS im lokalen Netzwerk über die UGOS-Pro-API (Port 9999). Lege ein eigenes Konto ohne Zwei-Faktor-Anmeldung an, trage es unten ein und füge NAS, Volumes und Festplatten im Tab „Entdecken“ hinzu. Nur lesend: Nichts wird geändert. Nicht mit UGREEN verbunden.
NAS-AdressestringJaIP-Adresse oder Name des NAS in deinem Netzwerk: 192.168.1.50 (Port 9999 wird ergänzt) oder http://192.168.1.50:9999.
BenutzernamestringJaEin Konto des NAS. Am besten ein eigenes; bleibt der Speicher leer, muss es Administrator sein.
PasswortsecretJaWird mit dem Schlüssel des NAS verschlüsselt gesendet und nie protokolliert.
AktualisierungsintervallselectNein
Sprache der Namen und ZuständeselectNeinGladys teilt der Integration deine Sprache nicht mit: Funktionsnamen, Zustände und Szenenvariablen nutzen diese.

So installierst du UGREEN NAS in Gladys​

  1. Öffne in Gladys Integrationen: UGREEN NAS erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-ugreen-nas:1.0.2) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-ugreen-nas.

UGREEN NAS benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

UGREEN NAS ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am