Entender NasDash

Arquitectura y datos

Comprensión de contenedores, rutas de API y archivos a proteger.

Resumen

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

La montura :ro del socket impide que el proxy modifique el propio archivo de socket. Las operaciones permitidas siguen determinadas por las variables del proxy (POST, DELETE, etc.).

Archivos persistentes

ArchivoFunción
config.jsonAjustes, integraciones compartidas, máquinas, hosts y acciones
services.jsonCategorías y servicios
topology.jsonNodos, grupos y conexiones
calendar.jsonEventos locales
custom_tabs.jsonPestañas y diseños antiguos
users.jsonCuentas, hashes, roles y versiones de sesión
jwt.secretClave persistente de firma sin opción de entorno
encryption.keyClave persistente de cifrado sin opción de entorno
logos/Logos subidos
pages.jsonPáginas componibles, diseños y preferencias móviles
metrics-history.jsonHistorial persistente de métricas
backups/Archivos locales; descargar fuera del host

Restricciones operativas

  • Utilice una única instancia de NasDash por almacén de datos.
  • No monte /app/data como solo lectura en producción normal.
  • Realice copias de seguridad de la carpeta o volumen completo, incluidas las claves.
  • Nunca coloque el contenido real de data/ en Git.
  • Una plataforma serverless es adecuada para demostraciones sin estado, no para instancias autoalojadas persistentes.

Proceso del contenedor

La imagen de producción se construye con Node.js 22 Alpine y ejecuta la aplicación con UID/GID 1001:1001. La comprobación de estado consulta http://127.0.0.1:2504/api/health.