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 searchLa 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
| Archivo | Función |
|---|---|
config.json | Ajustes, integraciones compartidas, máquinas, hosts y acciones |
services.json | Categorías y servicios |
topology.json | Nodos, grupos y conexiones |
calendar.json | Eventos locales |
custom_tabs.json | Pestañas y diseños antiguos |
users.json | Cuentas, hashes, roles y versiones de sesión |
jwt.secret | Clave persistente de firma sin opción de entorno |
encryption.key | Clave persistente de cifrado sin opción de entorno |
logos/ | Logos subidos |
pages.json | Páginas componibles, diseños y preferencias móviles |
metrics-history.json | Historial 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/datacomo 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.