NasDash verstehen

Architektur und Daten

Verständnis von Containern, API-Routen und zu schützenden Dateien.

Übersicht

Browser
   | HTTPS or private HTTP
   v
Optional reverse proxy
   |
   v
NasDash / Next.js :2504
   +-- /app/data                         persistent store
   +-- Glances / Netdata / Beszel / Prometheus / Proxmox / LHM
   +-- Tailscale / Headscale
   +-- Docker / Portainer / Dockhand connections
   +-- docker-socket-proxy :2375         restricted Docker API
          +-- /var/run/docker.sock:ro

Browser --> Open-Meteo                  weather and location search

Das :ro-Mount des Sockets verhindert, dass der Proxy die Socket-Datei selbst modifiziert. Die erlaubten Operationen werden weiterhin durch die Proxy-Variablen (POST, DELETE usw.) bestimmt.

Persistente Dateien

DateiRolle
config.jsonEinstellungen, Verbindungen, Maschinen, Hosts und Aktionen
services.jsonKategorien und Dienste
topology.jsonKnoten, Gruppen und Verbindungen
calendar.jsonLokale Ereignisse
custom_tabs.jsonAlte Tabs und Layouts
users.jsonKonten, Hashes, Rollen und Sitzungsversionen
jwt.secretGespeicherter Signaturschlüssel ohne Umgebungsvorgabe
encryption.keyGespeicherter Verschlüsselungsschlüssel ohne Umgebungsvorgabe
logos/Hochgeladene Logos
pages.jsonSeiten, Layouts und Mobilpräferenzen
metrics-history.jsonGespeicherter Metrikverlauf
backups/Lokale Archive; Kopien außerhalb des Hosts speichern

Betriebliche Einschränkungen

  • Verwenden Sie eine einzelne NasDash-Instanz pro Datenstore.
  • Mounten Sie /app/data im normalen Produktivbetrieb nicht als schreibgeschützt.
  • Sichern Sie den gesamten Ordner oder das Volume, einschließlich der Schlüssel.
  • Legen Sie niemals den tatsächlichen Inhalt von data/ in Git ab.
  • Eine serverless-Plattform eignet sich für zustandslose Demos, nicht jedoch für persistente Self-Hosted-Instanzen.

Container-Prozess

Das Produktionsimage wird mit Node.js 22 Alpine erstellt und führt die Anwendung unter der UID/GID 1001:1001 aus. Der Health-Check fragt http://127.0.0.1:2504/api/health ab.