Vaultwarden Smart-Home-Integration, kostenlos und Open Source

Überwache deinen Vaultwarden-Server: Erreichbarkeit, Version, Updates und Konten.
Überwache deinen Vaultwarden-Server in Gladys: ein Gerät „Vaultwarden“ (erreichbar oder nicht, Antwortzeit, Version, Update verfügbar und neueste Version, und mit dem Admin-Token die Benutzer, Organisationen, offenen Einladungen, deaktivierten Konten und die letzte Aktivität), ein Dashboard-Widget und Szenen-Auslöser, wenn der Server unerreichbar wird, zurückkommt oder eine neue Version erscheint.
Vaultwarden ist der schlanke, selbst gehostete Server, der mit den Bitwarden-Apps kompatibel ist. Diese Integration überwacht den Server nur von außen: keine Anmeldung bei einem Konto, kein geöffneter Tresor, kein gelesenes Passwort. Getestet wurde sie gegen ein echtes Vaultwarden 1.37.5 in Docker, mit und ohne Admin-Token, mit angelegten, eingeladenen und deaktivierten Konten und gestopptem Server. Rückmeldungen sind im Gladys-Forum oder in den Issues willkommen.
Was du brauchst
- Gladys Assistant 5.1.0 oder neuer.
- Einen Vaultwarden-Server, den Gladys erreicht: die Adresse, mit der du den Web-Tresor öffnest.
- Optional: den Admin-Token des Servers (die Variable
ADMIN_TOKEN, die die Seite/adminöffnet) für die Kontenzahlen. - Optional: Internetzugang von Gladys zu GitHub für die Update-Prüfung.
Einrichtung
- Installiere die Integration in Gladys und öffne ihre Konfiguration.
- Fülle Vaultwarden-Adresse aus:
https://vault.example.comoder192.168.1.20:8080für eine http-Adresse in deinem Netz. Läuft Vaultwarden unter einem Unterpfad (DOMAINendet auf/vault), gib ihn mit ein. - Optional: Fülle Admin-Token (optional) aus, um die Kontenzahlen zu erhalten.
- Drücke Verbindung testen: Es zeigt die Version, ob sie aktuell ist, und die Konten.
- Füge im Tab Entdecken das Gerät Vaultwarden hinzu.
Die weiteren Einstellungen:
- Selbstsigniertes Zertifikat akzeptieren: nur für eine https-Adresse, deren Zertifikat nicht von einer bekannten Stelle signiert ist.
- Nach Updates suchen (standardmäßig an): vergleicht die installierte Version mit der neuesten Veröffentlichung auf GitHub, alle 6 Stunden gelesen (GitHub erlaubt 60 anonyme Anfragen pro Stunde).
- Aktualisierungsintervall: wie oft der Server geprüft wird (30 s bis
15 min, standardmäßig 1 min). Eine Prüfung sind zwei kleine Anfragen:
/aliveund/api/version. - Sprache der Namen: Sprache der Funktionsnamen und der Daten, beim Hinzufügen des Geräts festgelegt.
Der Admin-Token
Gib den Token im Klartext ein, so wie auf der Seite /admin. Enthält
ADMIN_TOKEN einen Argon2-Hash ($argon2id$…), ist es das Passwort, das du
gehasht hast, nicht der Hash.
Mit dem Token meldet sich Gladys an der Admin-Seite an und liest die
Kontenliste (/admin/users) höchstens alle 5 Minuten, wobei die Sitzung bis
zu ihrem Ablauf erhalten bleibt. Es wird nur gezählt: Benutzer,
Organisationen, offene Einladungen, deaktivierte Konten, letzte Aktivität.
Kein Tresorinhalt ist so lesbar: Die Admin-Seite selbst sieht die
Passwörter nie, sie werden auf deinen Geräten verschlüsselt.
Ein abgelehnter Token wird erst wieder versucht, wenn du die Konfiguration
änderst oder Verbindung testen drückst: Ein Werkzeug wie fail2ban
überwacht diese Anmeldungen oft. Gladys bewahrt den Token wie jedes geheime
Feld auf und schreibt ihn nie in die Protokolle. Über eine http://-Adresse und mit Selbstsigniertes Zertifikat akzeptieren reist er ungeschützt oder zu einem nicht geprüften Server: Nimm lieber https oder beschränke das auf ein Netz, dem du vertraust.
Die Geräte
Ein Gerät Vaultwarden mit:
| Funktion | Art | Wann |
|---|---|---|
| Erreichbar | 0 / 1 | immer |
| Antwortzeit | ms | solange erreichbar |
| Version | Text | sobald gelesen |
| Update verfügbar | 0 / 1 | mit Nach Updates suchen |
| Neueste Version | Text | mit Nach Updates suchen |
| Benutzer | Zahl | mit dem Admin-Token (ohne Einladungen) |
| Organisationen | Zahl | mit dem Admin-Token |
| Offene Einladungen | Zahl | mit dem Admin-Token |
| Deaktivierte Konten | Zahl | mit dem Admin-Token |
| Letzte Aktivität | Text | mit dem Admin-Token (Datum und Uhrzeit) |
Die Integration liest den Server mit einem eigenen Timer: Die Werte werden veröffentlicht, wenn sie sich ändern, und ohnehin alle 12 Stunden. Admin-Token hinzufügen oder entfernen oder die Update-Prüfung ein- oder ausschalten ändert die Funktionen: Gladys bietet dann im Tab Entdecken an, das Gerät zu Aktualisieren.
Dashboard
Das Widget Vaultwarden zeigt in einer Liste: den Server (mit dem Namen, den du dem Gerät in Gladys gegeben hast) und seine Antwortzeit, oder Nicht erreichbar in Rot; die Version, als aktuell markiert oder mit der zu installierenden Version; und mit dem Admin-Token die Konten. Seine Einstellung Konten anzeigen blendet die Kontenzeilen aus.
Szenen
Auslöser
- Vaultwarden wird unerreichbar: Der Server antwortet nicht mehr auf seine Zustandsprüfung, nachdem er geantwortet hat. Variablen: der Servername, die installierte Version.
- Vaultwarden ist wieder erreichbar: Der Server antwortet wieder, nach Vaultwarden wird unerreichbar (ein Server, der beim Start der Integration schon aus ist, löst keinen der beiden aus). Variablen: der Servername, die installierte Version, die Ausfallzeit in Minuten.
- Ein Vaultwarden-Update ist verfügbar: Eine neuere Version als die installierte erscheint auf GitHub, einmal pro Version. Variablen: der Servername, die installierte Version, die neue Version, der Link zu ihren Versionshinweisen. Eine Version, die beim Start der Integration schon erschienen ist, zeigt Update verfügbar an, ohne den Auslöser.
Szenen-Ideen
- Eine Nachricht senden, wenn der Passwort-Server nicht mehr antwortet, und eine weitere mit der Ausfallzeit, wenn er zurückkommt.
- Den Link zu den Versionshinweisen per Nachricht erhalten, wenn eine neue Version erscheint.
- Offene Einladungen in einer Bedingung nutzen, um an eine Einladung zu erinnern, die niemand angenommen hat.
Fehlerbehebung
- „Vaultwarden antwortet nicht“: Prüfe Adresse und Port und ob Gladys sie
erreicht (Firewall,
127.0.0.1aus einem Container). - „Kein Vaultwarden-Server unter dieser Adresse“: Die Adresse führt zu einem anderen Dienst (eine Seite des Reverse Proxy, ein anderer Port) oder der Unterpfad fehlt.
- „Zertifikat abgelehnt“: Wenn das Zertifikat deines ist, aktiviere Selbstsigniertes Zertifikat akzeptieren.
- „Admin-Token abgelehnt“: Gib den Token im Klartext ein, nicht seinen Argon2-Hash. Mit
DISABLE_ADMIN_TOKENhat der Server keinen Token zu prüfen: Lass das Feld leer. - „Die Admin-Seite von Vaultwarden ist deaktiviert“: Der Server hat kein
ADMIN_TOKEN: Lass den Token leer. - „Zu viele Admin-Anmeldungen“: Vaultwarden begrenzt die Anmeldungen an der
Admin-Seite (
ADMIN_RATELIMIT_*); die Integration versucht es 5 Minuten später erneut.
Grenzen
- Ein Vaultwarden-Server pro Installation der Integration.
- Die Admin-Seite kennt keinen Nur-Lese-Token: Mit dem Admin-Token, den du Gladys gibst, ließe sich der Server verwalten. Lass ihn leer, wenn dich nur Erreichbarkeit und Version interessieren.
- Ist
DISABLE_ADMIN_TOKENgesetzt (Admin-Seite durch einen Proxy statt durch einen Token geschützt), gibt es keine Kontenzahlen. - Update verfügbar vergleicht Versionsnummern: Ein
testing-Image, das nach der letzten Veröffentlichung gebaut wurde, gilt als diese Version. - Der Update-Auslöser wird nicht gespeichert: Eine Version, die erschienen ist, während die Integration gestoppt war, zeigt Update verfügbar an, ohne den Auslöser.
- Nicht mit dem Vaultwarden-Projekt oder mit Bitwarden Inc. verbunden. Bitwarden ist eine Marke von Bitwarden Inc.
Konfigurationseinstellungen
Diese Einstellungen fragt Vaultwarden in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Vaultwarden-Server | section | Nein | Gladys überwacht den Server von außen: Zustand, Version, neueste Veröffentlichung. Gladys öffnet keinen Tresor und liest kein Passwort. |
| Vaultwarden-Adresse | string | Nein | Die Adresse, mit der du den Web-Tresor öffnest: https://vault.example.com oder 192.168.1.20:8080 (http). |
| Admin-Token (optional) | secret | Nein | Der Token der Seite /admin, im Klartext (nicht sein Argon2-Hash). Ergänzt die Kontenzahlen. Leer lassen, um nur den Server zu überwachen. |
| Selbstsigniertes Zertifikat akzeptieren | boolean | Nein | Nur für eine https-Adresse, deren Zertifikat nicht von einer bekannten Stelle signiert ist. |
| Nach Updates suchen | boolean | Nein | Vergleicht die Version mit der neuesten Veröffentlichung auf GitHub, alle 6 Stunden gelesen. |
| Aktualisierungsintervall | select | Nein | Wie oft der Server geprüft wird: zwei kleine Anfragen. Die Admin-Statistiken werden höchstens alle 5 Minuten gelesen. |
| Sprache der Namen | select | Nein | Sprache der Funktionsnamen und der Daten, beim Hinzufügen eines Geräts festgelegt. |
So installierst du Vaultwarden in Gladys
- Öffne in Gladys Integrationen: Vaultwarden erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-vaultwarden:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-vaultwarden.
Vaultwarden 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
Vaultwarden 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