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 searchLe 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
| Fichier | Rôle |
|---|---|
config.json | Réglages, intégrations partagées, machines, hôtes et actions |
services.json | Catégories et services |
topology.json | Nœuds, groupes et connexions |
calendar.json | Événements locaux |
custom_tabs.json | Anciens onglets et dispositions |
users.json | Comptes, empreintes, rôles et versions de session |
jwt.secret | Clé de signature persistante sans remplacement d’environnement |
encryption.key | Clé de chiffrement persistante sans remplacement d’environnement |
logos/ | Logos téléchargés |
pages.json | Pages composables, dispositions et préférences mobiles |
metrics-history.json | Historique 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/dataen 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.