Primeros pasos

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_SECRET existente 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 2504 se limita a LAN/VPN o proxy local.
  • HTTPS y la cabecera X-Forwarded-Proto: https del proxy se configuran para redes no fiables.
  • Si elige un proxy de socket, manténgalo privado con DELETE=0 salvo necesidad; limite los permisos Portainer/Dockhand al entorno necesario.
  • Se prueban copia completa de /app/data y restauración.
  • Se conserva el tag/digest anterior para volver atrás.
  • Se revisan registros y /api/health despué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.