Produktionskonfiguration
Checkliste vor der Nutzung von NasDash als tägliches Dashboard.
Minimale Checkliste
- Gespeicherte Schlüssel und bestehendes
NASDASH_JWT_SECRETbleiben unverändert. - Das Administratorpasswort und die Passwörter aller zur Anmeldung verwendeten Leserkonten sind einzigartig.
- Privater Modus schützt sensible Informationen.
- Port
2504ist auf LAN/VPN oder lokalen Proxy begrenzt. - HTTPS und Proxy-Header
X-Forwarded-Proto: httpssind 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/healthwerden 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.