Integrationen

Tailscale

Konfigurieren Sie das Widget mit OAuth und unterscheiden Sie zwischen Widget, Remote-Zugriff und Auth Key.

Drei verschiedene Anwendungsfälle werden häufig verwechselt:

AnwendungsfallErforderliche KennungKonfigurationsort
Geräte des Tailnets im Widget anzeigenOAuth Client ID + OAuth Client SecretNasDash, gemeinsame Integrationsverbindung
NasDash remote über Tailscale aufrufenKein Secret in NasDashTailscale-Client auf jedem Rechner
Neue Maschine automatisch registrierenTailscale Auth KeyAuf dieser Maschine, nicht im Widget

Widget-Kennung erstellen

  1. Öffnen Sie die OAuth-Konsole.
  2. Erstellen Sie einen Client nur mit nötigen Leserechten, etwa devices:core:read.
  3. Kopieren Sie Client-ID und Geheimnis sofort.
  4. Speichern Sie unter Einstellungen → Integrationen eine Tailscale-Verbindung mit Tailnet, Client-ID und Geheimnis.
  5. Alle Tailscale-Widgets nutzen die zuletzt gespeicherte Tailscale- oder Headscale-Verbindung; speichern Sie die gewünschte zuletzt. Es gibt keine Auswahl pro Widget.

Das Tailnet kann sein DNS-Name oder die in Ihrer Konsole angezeigte Identität sein. OAuth-Clients und deren Bereiche werden in der offiziellen Tailscale-Dokumentation erklärt.

Keinen Auth Key in das Widget einfügen

Ein Schlüssel, der in der Regel mit tskey-auth- beginnt, wird verwendet, um eine Maschine mit dem Tailnet zu verbinden. Das Widget erwartet ein OAuth-Client-Secret, das normalerweise als tskey-client-... angezeigt wird, zusammen mit der Client ID.

NasDash über Tailscale aufrufen

  1. Installieren Sie Tailscale auf dem Host, auf dem NasDash läuft, und auf der Client-Maschine.
  2. Verbinden Sie beide mit demselben Tailnet.
  3. Stellen Sie sicher, dass der NasDash-Port auf der Tailscale-IP erreichbar ist, oder verwenden Sie einen privaten Reverse Proxy.
  4. Öffnen Sie http://IP_TAILSCALE:2504.

Für diese Methode ist es nicht erforderlich, das Widget zu aktivieren. Schützen Sie NasDash dennoch mit starken Passwörtern und geeigneten Tailscale-ACLs.

Rotation

Erstellen Sie einen neuen OAuth-Client, ersetzen Sie das Secret in NasDash, überprüfen Sie das Widget und widerrufen Sie anschließend den alten Client. Eine Sicherung von /app/data enthält die verschlüsselte Konfiguration; schützen Sie diese wie ein Secret.

Headscale

Erstellen Sie unter Einstellungen → Integrationen eine Headscale-Verbindung mit Server-URL und API-Schlüssel. Speichern Sie sie zuletzt, damit alle Tailscale-Widgets sie nutzen. Der Fernzugriff auf NasDash erfordert weiterhin eine eigene Netzwerkeinrichtung.