Nextcloud Smart-Home-Integration, kostenlos und Open Source

Überwache deine Nextcloud: Updates, aktive Benutzer, freier Speicher, Dateien, Last.

• Veröffentlicht von guim31
• Geräte
• Version 1.0.1
• Erfordert Gladys >=5.1.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Nextcloud ist in vielen Haushalten die selbst gehostete Cloud: Dateien, Fotos, Kalender und Kontakte auf dem eigenen Server. Diese Integration überwacht deine Nextcloud aus Gladys, nur lesend, über ihre Monitoring-API (die App „Monitoring“, serverinfo, mit Nextcloud ausgeliefert und aktiviert): Ist sie online, wartet ein Update, wie viel Speicher ist frei, wer nutzt sie. Szenen können reagieren, wenn eine neue Version von Nextcloud oder ihrer Apps erscheint. Ein Dashboard-Widget fasst alles zusammen. Alles bleibt in deinem lokalen Netzwerk.

Gegen eine echte Nextcloud 32 getestet (32.0.9, SQLite), durch die automatischen Tests und während der Entwicklung; noch nicht auf einer echten Gladys-Installation. Rückmeldungen sind in den Issues willkommen.

Was du brauchst

• Gladys Assistant 5.1.0 oder neuer.
• Nextcloud mit aktivierter App Monitoring (serverinfo): Die App ist standardmäßig aktiv. Jede noch gepflegte Version funktioniert; die Systemlast braucht Nextcloud 28 oder neuer.
• Nextcloud vom Gladys-Rechner aus erreichbar (die Adresse, die du zu Hause im Browser eingibst).
• Einer der beiden Zugänge unten. Nie dein Hauptpasswort.

Erste Schritte

1. Gladys Zugang geben

Wähle einen der beiden:

• Ein serverinfo-Token (empfohlen): ein selbst gewähltes Geheimnis, das nur die Monitoring-API öffnet und kein Konto. Erzeuge einen langen Zufallstext (ein Passwortmanager kann das) und setze ihn auf dem Server mit occ, der Kommandozeile von Nextcloud (der Befehl steht auch unten in Verwaltungseinstellungen → System):

  occ config:app:set serverinfo token --value <dein-token>

  Mit Docker: docker exec -u www-data <container> php occ config:app:set serverinfo token --value <dein-token>. Mit Nextcloud AIO: docker exec --user www-data -it nextcloud-aio-nextcloud php occ config:app:set serverinfo token --value <dein-token>.

• Ein Administratorkonto und ein App-Passwort: Die Monitoring-API ist den Mitgliedern der Gruppe admin vorbehalten. Melde dich als Administrator an, öffne Persönliche Einstellungen → Sicherheit → Geräte & Sitzungen, gib Gladys als App-Namen ein und klicke auf Neues App-Passwort erstellen. Kopiere es: Nextcloud zeigt es nur einmal. Du kannst es dort jederzeit widerrufen, ohne dein Passwort anzufassen.

2. Die Integration konfigurieren

In Gladys, Integrationen → Nextcloud → Konfiguration:

• Adresse: die Adresse deiner Nextcloud wie im Browser, mit ihrem Pfad, falls vorhanden: https://cloud.example.com, http://192.168.1.20:8080, https://example.org/nextcloud. Ein kopierter Link wie https://cloud.example.com/index.php/apps/files/ wird auch verstanden. Eine Umleitung von HTTP auf HTTPS unter derselben Adresse wird befolgt, eine Umleitung auf eine andere Adresse nie (deine Zugangsdaten gingen dorthin).
• serverinfo-Token: das oben gesetzte Token, oder:
• Administratorkonto und App-Passwort: der Anmeldename eines Administrators und das oben erstellte App-Passwort. Sind Token und Konto beide ausgefüllt, wird das Token genutzt.
• Name (optional): der Name des Geräts in Gladys; leer: Nextcloud.
• Selbstsignierte Zertifikate akzeptieren: für eine HTTPS-Adresse, deren Zertifikat nicht von einer Zertifizierungsstelle signiert ist (ein NAS, ein lokaler Name). Nur für deinen eigenen Server.
• Aktualisierungsintervall: 1 Minute (Standard) bis 15 Minuten.
• Sprache der Namen und Texte: die Namen der Funktionen beim Hinzufügen des Geräts und die Texte des Geräts (standardmäßig Französisch).

Speichere, dann Verbindung testen: Nextcloud wird gelesen und das Ergebnis angezeigt (Version, Update, Benutzer, Dateien, freier Speicher und wie gelesen wurde).

3. Das Gerät hinzufügen

Öffne den Tab Entdecken der Integration und klicke beim Nextcloud-Gerät auf Zu Gladys hinzufügen.

Das Gerät

Ein Gerät pro Nextcloud, alle Funktionen nur lesend:

• Online: Nextcloud antwortet (0 nach zwei fehlgeschlagenen Abfragen in Folge oder im Wartungsmodus).
• Nextcloud-Version: die installierte Version (32.0.9).
• Nextcloud-Update verfügbar: 1, wenn Nextcloud eine neue Version von sich gefunden hat (ihre eigene tägliche Prüfung, die der Verwaltungsseiten).
• App-Updates: die Anzahl installierter Apps mit einem Update im App Store.
• Aktive Benutzer (5 Min.), Aktive Benutzer (1 Stunde), Aktive Benutzer (24 Stunden): die Benutzer, die sich in dieser Zeit angemeldet oder Nextcloud genutzt haben.
• Benutzer: die Konten, die sich mindestens einmal angemeldet haben.
• Dateien: die Anzahl der Dateien (ein Zähler, den Nextcloud alle 3 Stunden aktualisiert).
• Freigaben: die Anzahl der Freigaben (öffentliche Links, Benutzer, Gruppen, E-Mail …).
• Freier Speicher: freier Speicher des Datenordners, in GB.
• Datenbankgröße: in MB.
• Systemlast: die durchschnittliche Last der letzten Minute pro Prozessor-Thread: 100 %, wenn alle Threads beschäftigt sind (darüber als 100 % angezeigt).
• Belegter Arbeitsspeicher: der genutzte Arbeitsspeicher des Servers, in %.
• PHP-Version: die PHP-Version, mit der Nextcloud läuft.
• Speicher-Cache: die Speicher-Caches, die Nextcloud nutzt (APCu, Redis …), oder Keiner: Die eigenen Prüfungen von Nextcloud empfehlen einen.

Eine Funktion erscheint, sobald Nextcloud ihr einen Wert gegeben hat: Auf einem System, das ihn nicht liefert (keine Thread-Anzahl, freier Speicher unbekannt), fehlt sie einfach.

Dashboard

Das Widget Nextcloud zeigt auf einen Blick: den freien Speicher, die aktiven Benutzer der letzten 5 Minuten, die Anzahl wartender Updates (Nextcloud und ihre Apps, orange, wenn es welche gibt). Dann eine Liste, das Wichtigste zuerst: die neue Nextcloud-Version, die zu aktualisierenden Apps, eine Systemlast oder ein Arbeitsspeicher über 80 %, ein fehlender Speicher-Cache; dann die aktiven Benutzer über 1 Stunde und 24 Stunden, Benutzer, Dateien, Freigaben, Datenbank, PHP-Version.

Tasten: Aktualisieren liest Nextcloud neu; Nextcloud öffnen öffnet die Verwaltungsübersicht, wenn die Adresse HTTPS ist (das Dashboard öffnet nur sichere Links).

Szenen

Auslöser

• Nextcloud-Update verfügbar: Nextcloud hat eine neue Version von sich gefunden. Einmal pro Version: Eine schwankende Prüfung oder ein Neustart melden sie nicht erneut. Übergebene Informationen: server_name (der Gerätename), installed_version, new_version.
• Nextcloud-App-Updates verfügbar: Für installierte Apps sind neue Updates erschienen, ein Ereignis für alle bei derselben Abfrage gefundenen, einmal pro App-Version. Übergebene Informationen: server_name, apps (die neuen mit ihrer Version: calendar 5.5.4, deck 1.15.0), count (wie viele neue), total (Apps, die auf ein Update warten).

Was beim allerersten Start der Integration schon wartet, wird gespeichert, nicht gemeldet: Die Funktionen und das Widget zeigen es.

Für freien Speicher, Benutzer oder Last braucht es keinen Auslöser: Nutze die Funktionen in einer Szenenbedingung („Freier Speicher unter 20 GB“, „Online wird 0“).

Szenen-Ideen

• Nextcloud-Update verfügbar → schick dir eine Nachricht mit den Variablen new_version und installed_version: „Nextcloud 32.0.10 ist verfügbar (installiert: 32.0.9)“.
• Nextcloud-App-Updates verfügbar → eine Benachrichtigung mit apps auf dein Handy, höchstens einmal pro Woche mit einer Bedingung auf die Uhrzeit.
• Freier Speicher unter 20 GB → eine Nachricht, bevor die Foto-Sicherungen der Handys scheitern.
• Online wird nachts 0 → schalte die Steckdose des NAS ein oder schick eine Nachricht.

Fehlerbehebung

• „Token, Benutzername oder App-Passwort abgelehnt“: Das Token ist nicht das mit occ gesetzte, oder das App-Passwort wurde widerrufen oder falsch abgeschrieben. Der Brute-Force-Schutz von Nextcloud bremst die Anfragen einer Adresse, die scheitert: Nach einer Ablehnung versucht Gladys es erst nach 30 Minuten wieder, oder sofort, wenn du die Konfiguration speicherst oder auf Verbindung testen klickst.
• „Dieses Konto ist kein Administrator“: Das Konto ist gültig, aber nicht in der Gruppe admin. Nutze einen Administrator oder das serverinfo-Token.
• „Zu viele Fehlversuche“: Der Brute-Force-Schutz blockiert die Adresse von Gladys. Korrigiere die Zugangsdaten, warte, oder setze ihn auf dem Server zurück: occ security:bruteforce:reset <Adresse von Gladys>. Erreicht Gladys Nextcloud über einen Reverse Proxy, setze trusted_proxies in Nextcloud, sonst teilt sich das ganze Haus eine blockierte Adresse.
• „Die App Monitoring (serverinfo) ist deaktiviert“: Aktiviere sie unter Apps → Deaktivierte Apps oder mit occ app:enable serverinfo.
• „Im Wartungsmodus“: Ein Update oder occ maintenance:mode --on läuft. Online ist 0, bis es vorbei ist.
• „Keine Nextcloud unter dieser Adresse“: Die Adresse oder ihr Pfad stimmt nicht (eine unter /nextcloud laufende Nextcloud braucht ihn in der Adresse).
• „Leitet auf eine andere Adresse um“: Gib die endgültige Adresse ein, die dein Browser anzeigt.
• „Zertifikat abgelehnt“: Aktiviere Selbstsignierte Zertifikate akzeptieren.
• Das Gerät zeigt „Aktualisieren“ in Entdecken: Eine Funktion ist hinzugekommen (das erste App-Update, der nun bekannte freie Speicher). Aktualisiere es, um sie zu bekommen.
• Mehr Details in den Protokollen der Integration, mit LOG_LEVEL=debug.

Grenzen

• Eine Nextcloud pro Installation.
• Nur lesend: kein Wartungsmodus, kein Update, keine Dateioperation aus Gladys.
• Gelesen alle 1 bis 15 Minuten: Eine Änderung erscheint bei der nächsten Abfrage. Jede Abfrage ist eine leichte Anfrage; es gibt kein Kontingent. Die App-Updates stammen aus der App-Store-Liste, die Nextcloud eine Stunde lang aufbewahrt: Daher geht nicht bei jeder Abfrage eine Anfrage an den App Store.
• Die Dateianzahl wird von Nextcloud alle 3 Stunden aktualisiert.
• Keine Festplattentemperaturen, kein Netzwerkverkehr, keine Kontingente pro Benutzer: Die Monitoring-API liefert sie nicht.
• Die Integration speichert in /data nur die Adresse, die gesehenen Funktionen und die schon gemeldeten Versionen; das Token und das App-Passwort bleiben in der Gladys-Konfiguration und erscheinen nie in den Protokollen.

Nextcloud ist eine Marke der Nextcloud GmbH. Diese Integration ist weder mit der Nextcloud GmbH verbunden noch von ihr unterstützt oder gesponsert.

Konfigurationseinstellungen

Diese Einstellungen fragt Nextcloud in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Deine Nextcloud	section	Nein	Gladys liest die Monitoring-API von Nextcloud (die App „Monitoring“, serverinfo, standardmäßig aktiviert), nur lesend. Dafür braucht Gladys das serverinfo-Token oder ein Administratorkonto mit App-Passwort: nie dein Hauptpasswort.
Adresse	string	Ja	Adresse deiner Nextcloud wie im Browser, mit ihrem Pfad, falls vorhanden (https://example.org/nextcloud).
Zugang	section	Nein	Entweder ein selbst gewähltes serverinfo-Token, gesetzt mit occ (Befehl unten in Verwaltungseinstellungen, System), oder ein Administratorkonto und ein App-Passwort (Persönliche Einstellungen, Sicherheit). Sind beide ausgefüllt, gilt das Token.
serverinfo-Token	secret	Nein	Empfohlen: Es öffnet nur die Monitoring-API und kein Konto.
Administratorkonto	string	Nein	Anmeldename eines Kontos der Gruppe admin, falls kein Token.
App-Passwort	secret	Nein	Für Gladys erstellt unter Persönliche Einstellungen, Sicherheit. Nie dein Hauptpasswort.
Name	string	Nein	Name des Geräts in Gladys. Leer: Nextcloud.
Optionen	section	Nein
Selbstsignierte Zertifikate akzeptieren	boolean	Nein	Für eine HTTPS-Adresse, deren Zertifikat nicht von einer Zertifizierungsstelle signiert ist (ein NAS, ein lokaler Name). Nur für deinen eigenen Server aktivieren.
Aktualisierungsintervall	select	Nein	Wie oft Nextcloud gelesen wird: jedes Mal eine leichte Anfrage.
Sprache der Namen und Texte	select	Nein	Namen der Funktionen beim Hinzufügen des Geräts und Texte des Geräts.

So installierst du Nextcloud in Gladys

1. Öffne in Gladys Integrationen: Nextcloud 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-nextcloud:1.0.1) 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-nextcloud.

Nextcloud 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

Nextcloud 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.

• Alle Integrationen durchsuchen, native und aus der Community
• Deine eigene externe Integration bauen und veröffentlichen
• Quellcode auf GitHub — Quelle dieser Dokumentation

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 🙂