UGREEN NAS für Home Assistant (Marketplace-Integration)

Installationen: 1.476 teilen Analysedaten
GitHub-Sterne: 270
Verbindung: Funktioniert lokal
Pflege: In den letzten 6 Monaten aktualisiert
Version: v2026.10.1, 24. Oktober 2026
Kategorie: Computer und Netzwerk, NAS und Server
Art: Marketplace-Integration
Voraussetzung: Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain: ugreen
Quelle: github.com/Tom-Bom-badil/home-assistant_ugreen-nas
Probleme: Problem melden

Unabhängiges Verzeichnis, erstellt vom Entwickler von Vulpo. Steht in keiner Verbindung zu Home Assistant oder der Open Home Foundation.

Screenshots Aus der README von Tom-Bom-badil/home-assistant_ugreen-nas.

Überblick

UGREEN NAS ist eine lokale Integration, die Einstellungen und Betriebsdaten von UGreen-Netzwerkspeichern (NAS) auf Basis von UGOS überwacht. Sie liest Daten aus der API, die UGOS bereits bereitstellt und die auch von der Weboberfläche und den Apps genutzt wird, daher wird nichts zusätzlich auf dem NAS installiert und es ist kein SSH-Zugang nötig. Sie fügt Home Assistant Tasten, Auswahl-Entitäten, Sensoren und Text-Entitäten hinzu. Home Assistant kann das NAS im Netzwerk erkennen und anbieten, es hinzuzufügen, und die Einrichtung erfolgt in der Oberfläche mit der Adresse des NAS, dem Port, dem Admin-Login und einer optionalen HTTPS-Verbindung. Konten mit Zwei-Faktor-Authentifizierung werden unterstützt, indem Home Assistant mit einem einzigen Authenticator-Code als vertrauenswürdiges Gerät registriert wird. Erweiterte Optionen legen die Abfrageintervalle für häufig und seltener wechselnde Werte, die Rate der Keepalive-Pings und das Layout eines fertigen Beispiel-Dashboards fest.

Zusammenfassung der README und des Codes von Tom-Bom-badil/home-assistant_ugreen-nas, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Unterstützt

Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Wird automatisch erkannt Home Assistant entdeckt sie im Netzwerk und bietet an, sie hinzuzufügen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.

Stellt bereit

Sensoren

Einrichtung

Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.

UGREEN NAS einrichten

IP-Adresse oder HostnameDie IP-Adresse oder der Hostname deines UGREEN NAS (z. B. 192.168.1.100).
PortDer Port für die Verbindung (Standard: 9999 für HTTP, 9443 für HTTPS).
Admin BenutzernameDein NAS Admin Benutzername.
Admin PasswortDein NAS Admin Passwort (keine Sonderzeichen - UGOS Bug!).
Eindeutiger Gerätename (Standard: UGREEN NAS)Muss mit einem Buchstaben beginnen; danach sind Buchstaben, Zahlen und Leerzeichen erlaubt.
HTTPS verwendenHTTPS für die Verbindung benutzen.
Konto verwendet Zwei-Faktor-Authentifizierung (2FA)Aktiviere dies nur, wenn für das oben angegebene NAS-Konto 2FA eingeschaltet ist. Im nächsten Schritt wirst du nach einem Code gefragt, mit dem Home Assistant als vertrauenswürdiges Gerät registriert wird und danach keinen Code mehr benötigt.

Home Assistant als vertrauenswürdiges Gerät registrieren

Authenticator-CodeDer aktuelle 6-stellige Code aus deiner Authenticator-App. Codes laufen schnell ab, bestätige also zügig.

Nach der Einrichtung

IP-Adresse oder HostnameDie IP-Adresse oder der Hostname deines UGREEN NAS.
PortDer Port für die Verbindung (Standard: 9999 für HTTP, 9443 für HTTPS).
Admin BenutzernameDein NAS Admin Benutzername.
Admin PasswortDein NAS Admin Passwort (keine Sonderzeichen - UGOS Bug!).
Eindeutiger Gerätename (Standard: UGREEN NAS)Muss mit einem Buchstaben beginnen; danach sind Buchstaben, Zahlen und Leerzeichen erlaubt.
HTTPS verwendenVerschlüsselte HTTPS-Verbindung benutzen (erfordert HTTPS-Port).
Vertrauenswürdiges Gerät für Zwei-Faktor-Authentifizierung (2FA) registrierenFür normale Änderungen deaktiviert lassen. Aktiviere und speichere nur, wenn das NAS-Konto 2FA verwendet und Home Assistant noch nicht registriert ist oder erneut registriert werden muss. Im nächsten Schritt wirst du nach einem Code gefragt.
Auslese-Intervall für Status-Entitäten (5s)Wie oft sollen sich häufig ändernde Werte ausgelesen werden?
Auslese-Intervall für Konfigurations-Entitäten (60s)Wie oft sollen sich seltener ändernde Werte ausgelesen werden?
Keepalive-API-Pings (20s)Wie oft soll ein API-Keepalive-Ping per WebSocket gesendet werden?
[Beispiel-Dashboard] Maximale Anzahl Disk-Spalten pro Zeile (5)Anzahl der Disk-Kacheln dieses NAS, die auf dem Dashboard nebeneinander angezeigt werden.
[Beispiel-Dashboard] Maximale Anzahl Pool-Spalten pro Zeile (2)Anzahl der Pool-Kacheln dieses NAS, die auf dem Dashboard nebeneinander angezeigt werden.
[Beispiel-Dashboard] Maximale Anzahl Volume-Spalten pro Zeile (2)Anzahl der Volume-Kacheln dieses NAS, die auf dem Dashboard nebeneinander angezeigt werden.
[Beispiel-Dashboard] Name der Bilddatei (default_picture.png)Individuelle Dashboard-Bilddatei für dieses NAS im Ordner www/community/ugreen/.
Authenticator-CodeDer aktuelle 6-stellige Code. Codes laufen schnell ab, bestätige also zügig.