Integrationen

Gluetun (VPN)

Einen Gluetun-VPN-Tunnel anzeigen, wo der Verkehr austritt, seinen weitergeleiteten Port und die Container dahinter.

Das VPN-Widget zeigt, ob der Tunnel steht, Stadt und Land, wo der Verkehr austritt, die öffentliche Adresse, das Austrittsnetz und den Port, den der VPN-Anbieter weiterleitet. Es listet die Container, die über Gluetun laufen, und warnt, wenn einige ihr Netzwerk verloren haben. Administratoren können den Tunnel nach einer Bestätigung neu starten.

Den Steuerserver von Gluetun öffnen

Gluetun antwortet auf seinem Steuerserver, Port 8000 im Container. Veröffentlichen Sie ihn und geben Sie NasDash einen API-Schlüssel, dessen Rolle nur liest, was das Widget braucht:

gluetun-auth.toml
[[roles]]
name = "nasdash"
routes = ["GET /v1/vpn/status", "GET /v1/publicip/ip", "GET /v1/portforward"]
auth = "apikey"
apikey = "REPLACE_WITH_A_LONG_RANDOM_KEY"
services:
  gluetun:
    image: qmcgaw/gluetun
    ports:
      - 8000:8000
    volumes:
      - ./gluetun-auth.toml:/gluetun/auth/config.toml:ro

Die reine Leserolle lässt GET /v1/vpn/settings aus, das private Schlüssel und Passwörter liefert und von NasDash nie angefragt wird. Ergänzen Sie optional PUT /v1/vpn/status, damit Administratoren den Tunnel neu starten können. Ohne diese Berechtigung funktionieren die Messwerte weiterhin.

Verbinden

  1. Öffnen Sie Einstellungen → Integrationen → VPN-Tunnel → Gluetun.
  2. Geben Sie die Adresse des Steuerservers ein, zum Beispiel http://nas.example.com:8000.
  3. Wählen Sie API-Schlüssel und fügen Sie den Schlüssel ein (oder Benutzer und Passwort, oder Keine, wenn Ihr Steuerserver keine Authentifizierung hat).
  4. Speichern und die Verbindung testen.

NasDash 0.3.6 unterstützt mehrere gespeicherte Gluetun-Verbindungen. Geben Sie jeder unter Einstellungen → Integrationen einen eigenen Namen und wählen Sie die Verbindung in den Einstellungen des jeweiligen VPN-Widgets. Das Hinzufügen erstellt einen separaten Eintrag; das Bearbeiten eines bestehenden Eintrags aktualisiert diese Verbindung.

Dienste hinter dem Tunnel

Wenn NasDash einen Docker-Host hat (Einstellungen → Integrationen → Docker), listet das Widget die Container, die das Netzwerk von Gluetun teilen (network_mode: service:gluetun), gestoppte durchgestrichen. Nur Besucher, die Container lesen dürfen, sehen die Liste.

Wird der Gluetun-Container neu erstellt, bleiben diese Container ohne Netzwerk, bis sie ebenfalls neu erstellt werden. Das Widget nennt sie in einer Warnung. Erstellen Sie sie zusammen mit Gluetun neu:

docker compose up -d --force-recreate gluetun qbittorrent

Neu starten

Die Schaltfläche stoppt und startet die VPN-Verbindung neu, die dann einen anderen Server nutzen kann. Gluetun vergisst die Austrittsadresse, wenn der Tunnel stoppt, und fragt sie einmal ab, sobald er wieder steht; schlägt das fehl, zeigt das Widget den Tunnel als verbunden, die Adresse noch unbekannt. Gluetun verbindet sich bei fehlgeschlagener Zustandsprüfung bereits selbst neu, die Schaltfläche dient vor allem der Fehlersuche.

Anzeige und Zugriff

Öffentliche Adresse, weitergeleiteter Port und Dienstliste lassen sich in den Widget-Einstellungen einzeln ausblenden. Besucher brauchen die Berechtigung VPN (Einstellungen → Benutzer und Zugriff). Adresse und Schlüssel verlassen den NasDash-Server nie. Die öffentliche Demo zeigt einen fiktiven Tunnel.