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 searchDas :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
| Datei | Rolle |
|---|---|
config.json | Einstellungen, Verbindungen, Maschinen, Hosts und Aktionen |
services.json | Kategorien und Dienste |
topology.json | Knoten, Gruppen und Verbindungen |
calendar.json | Lokale Ereignisse |
custom_tabs.json | Alte Tabs und Layouts |
users.json | Konten, Hashes, Rollen und Sitzungsversionen |
jwt.secret | Gespeicherter Signaturschlüssel ohne Umgebungsvorgabe |
encryption.key | Gespeicherter Verschlüsselungsschlüssel ohne Umgebungsvorgabe |
logos/ | Hochgeladene Logos |
pages.json | Seiten, Layouts und Mobilpräferenzen |
metrics-history.json | Gespeicherter Metrikverlauf |
backups/ | Lokale Archive; Kopien außerhalb des Hosts speichern |
Betriebliche Einschränkungen
- Verwenden Sie eine einzelne NasDash-Instanz pro Datenstore.
- Mounten Sie
/app/dataim 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.