Erste Schritte

Produktionskonfiguration

Checkliste vor der Nutzung von NasDash als tägliches Dashboard.

Minimale Checkliste

  • Gespeicherte Schlüssel und bestehendes NASDASH_JWT_SECRET bleiben unverändert.
  • Das Administratorpasswort und die Passwörter aller zur Anmeldung verwendeten Leserkonten sind einzigartig.
  • Privater Modus schützt sensible Informationen.
  • Port 2504 ist auf LAN/VPN oder lokalen Proxy begrenzt.
  • HTTPS und Proxy-Header X-Forwarded-Proto: https sind für fremde Netze eingerichtet.
  • Falls ein Socket-Proxy gewählt wird, bleibt er privat mit DELETE=0, sofern unnötig; Portainer/Dockhand-Zugangsdaten erhalten nur notwendige Umgebungsrechte.
  • Vollständige /app/data-Sicherung und Wiederherstellung sind getestet.
  • Vorheriger Image-Tag/Digest bleibt zum Zurückrollen erhalten.
  • Logs und /api/health werden nach Updates geprüft.

Port-Exposition reduzieren

Reverse Proxy auf demselben Rechner:

ports:
  - "127.0.0.1:2504:2504"

Reverse Proxy im selben Docker-Netzwerk: Entfernen Sie ports vollständig aus dem NasDash-Dienst und verwenden Sie expose: ["2504"]. Der Proxy muss dann nasdash:2504 über das interne Netzwerk erreichen.

Öffentlicher oder privater Modus

Neuinstallationen sind privat. Der öffentliche Modus erstellt bei Bedarf viewer, zunächst mit Lesezugriff auf alle Seiten und Widgets. Anonyme Besucher verwenden dessen Berechtigungen; prüfen Sie diese unter Einstellungen → Benutzer und Zugriff, bevor Sie den Zugang öffnen.

Der öffentliche Modus gewährt Besuchern keine Schreibrechte, kann aber Dienste und Widgets offenlegen, die für den Betrachter autorisiert sind. Er ersetzt keine Entscheidung über die Veröffentlichung. Für ein persönliches Homelab ist der private Modus hinter Tailscale oder HTTPS der sinnvollste Ausgangspunkt.

Einzelne Instanz

NasDash speichert seine Daten in JSON-Dateien und verwendet Caches im Arbeitsspeicher. Führen Sie keine mehreren Replikate aus, die auf denselben Volume schreiben. Eine serverless- oder Multi-Instance-Bereitstellung ist nicht das unterstützte Self-Hosted-Produktionsmodell.

Bei Anfragelimits werden weitergeleitete Client-Adressen standardmäßig ignoriert. Aktivieren Sie NASDASH_TRUST_PROXY=true nur hinter einem vertrauenswürdigen Proxy, der Client-Header überschreibt und direkten NasDash-Zugriff verhindert. Andernfalls bleibt NASDASH_TRUST_PROXY=false. Die Einstellung ändert nur die Identität für Limits, nicht HTTPS-Erkennung oder Authentifizierungscookies. Fehlgeschlagene Anmeldungen werden zusätzlich pro Konto begrenzt, unabhängig von Weiterleitungsheadern.