Comprendre NasDash

Architecture et données

Comprendre les conteneurs, les routes API et les fichiers à protéger.

Vue d'ensemble

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

Le montage :ro de la socket empêche le proxy de modifier le fichier de socket lui-même. Les opérations autorisées restent déterminées par les variables du proxy (POST, DELETE, etc.).

Fichiers persistants

FichierRôle
config.jsonRéglages, intégrations partagées, machines, hôtes et actions
services.jsonCatégories et services
topology.jsonNœuds, groupes et connexions
calendar.jsonÉvénements locaux
custom_tabs.jsonAnciens onglets et dispositions
users.jsonComptes, empreintes, rôles et versions de session
jwt.secretClé de signature persistante sans remplacement d’environnement
encryption.keyClé de chiffrement persistante sans remplacement d’environnement
logos/Logos téléchargés
pages.jsonPages composables, dispositions et préférences mobiles
metrics-history.jsonHistorique persistant des métriques machines
backups/Archives locales ; télécharger des copies hors de l’hôte

Contraintes d'operations

  • Utilisez une seule instance NasDash sur un même magasin de données.
  • Ne montez pas /app/data en lecture seule en production normale.
  • Sauvegardez le dossier ou le volume complet, clés comprises.
  • Ne placez jamais le contenu réel de data/ dans Git.
  • Une plateforme serverless convient à la démo sans état, pas à l'instance auto-hébergée persistante.

Processus du conteneur

L'image de production est construite avec Node.js 22 Alpine et lance l'application sous l'UID/GID 1001:1001. Le healthcheck interroge http://127.0.0.1:2504/api/health.