Configuración de producción
Lista de verificación antes de usar NasDash como panel de control diario.
Lista de verificación mínima
- Las claves persistentes y el
NASDASH_JWT_SECRETexistente se conservan sin cambios. - La contraseña del administrador y las de las cuentas de lector que se usen para iniciar sesión son únicas.
- El modo privado protege información sensible.
- El puerto
2504se limita a LAN/VPN o proxy local. - HTTPS y la cabecera
X-Forwarded-Proto: httpsdel proxy se configuran para redes no fiables. - Si elige un proxy de socket, manténgalo privado con
DELETE=0salvo necesidad; limite los permisos Portainer/Dockhand al entorno necesario. - Se prueban copia completa de
/app/datay restauración. - Se conserva el tag/digest anterior para volver atrás.
- Se revisan registros y
/api/healthdespués de actualizar.
Reducir la exposición de puertos
Proxy inverso en la misma máquina:
ports:
- "127.0.0.1:2504:2504"Proxy inverso en la misma red de Docker: elimine por completo ports del servicio de NasDash y use expose: ["2504"]. El proxy debe poder llegar entonces a nasdash:2504 a través de la red interna.
Modo público o privado
Las instalaciones nuevas son privadas. Activar el modo público crea viewer si falta; al principio puede leer todas las páginas y widgets. Los visitantes anónimos usan sus permisos, así que revíselos en Ajustes → Usuarios y acceso antes de abrir el acceso.
El modo público no otorga mutaciones a un visitante, pero puede exponer servicios y widgets autorizados para el espectador. No sustituye una decisión de publicación. Para un homelab personal, el modo privado detrás de Tailscale o HTTPS es el punto de partida más prudente.
Instancia única
NasDash almacena sus datos en archivos JSON y utiliza cachés en memoria. No ejecute varias réplicas que escriban en el mismo volumen. Una implementación sin servidor o de varias instancias no es el modelo de producción autoalojado admitido.
Para limitar peticiones, las direcciones de cliente transmitidas por cabeceras de proxy se ignoran por defecto. Active NASDASH_TRUST_PROXY=true solo detrás de un proxy fiable que sustituya las cabeceras del cliente e impida el acceso directo a NasDash. En otro caso conserve NASDASH_TRUST_PROXY=false. Solo cambia la identidad de los límites; no modifica detección HTTPS ni cookies de autenticación. Los intentos fallidos también se limitan por cuenta, independientemente de las cabeceras.