Solución de problemas
Resuelva errores comunes según el síntoma.
La interfaz no se inicia
Revise docker compose ps y los logs completos de arranque. Compruebe puertos y acceso a datos para el UID:GID real. No hace falta secreto de entorno explícito en una instalación nueva. Reconstruir no corrige ACL del host.
Una integración funciona en el navegador pero no en NasDash
Pruebe desde el contenedor. Sustituya localhost por el nombre del servicio de Compose, una IP privada o un nombre DNS enrutable. Verifique el cortafuegos y la enrutación.
Docker muestra 403 o una acción falla
Compruebe primero el tipo de conexión. Para Portainer o Dockhand, verifique la clave API y sus permisos sobre el entorno. Para una API HTTP o un proxy de socket, revise rutas y métodos permitidos como CONTAINERS, POST y DELETE. Para un socket Unix, revise la ruta montada y el acceso del usuario de ejecución. No habilite capacidades ajenas.
Glances devuelve HTML
NasDash espera JSON en la ruta /api/<version>/all. Verifique que sea el servidor web de Glances, y no una página de autenticación del proxy, quien esté respondiendo.
Proxmox muestra 401/403
Compruebe el ID de token completo, el secreto, el nombre exacto del nodo y el rol de lectura en la ruta correcta. Rote un secreto comprometido en lugar de copiarlo en los registros.
El CSS hace que la interfaz sea inutilizable
Agregue ?safe-css=1 a la URL, abra la configuración de desarrollador, corrija o limpie el CSS y, a continuación, recargue sin el parámetro. Consulte CSS personalizado.
Los espectadores ven demasiado o demasiado poco
Revise categorías secretas y listas de pestañas/widgets. Las listas vacías significan acceso ilimitado dentro de esa lista. Cambiar permisos revoca sesiones: vuelva a entrar. Consulte la matriz de acceso.
Synology y permisos de la carpeta de datos
Las imágenes a partir de la versión 0.2.2 comprueban el acceso antes del inicio e indican el UID:GID real si los datos, logos o archivos existentes no son accesibles. Corrija los permisos y vuelva a crear el contenedor. Las pruebas UID/GID en Docker Linux no sustituyen la validación en un DSM real.
Synology y permisos de la carpeta de datos
Código de configuración ausente o acceso perdido
El código de configuración aparece una sola vez, tras guardar el hash de la contraseña del administrador y antes de que el servidor esté listo. Consulte todos los registros de inicio, incluidas advertencias/stderr. Reiniciar o reconstruir no genera un nuevo código. Si NASDASH_ADMIN_PASSWORD estaba definido al crear la cuenta, use esa primera contraseña.
Si pierde el código o la contraseña, ¿Olvidada? en la pantalla de acceso habitual muestra el comando de recuperación sin conexión. Haga una copia de los datos y detenga NasDash antes de ejecutarlo; mantenga el mismo montaje y UID/GID. Consulte código de configuración y recuperación sin conexión.
Errores de monitorización y certificados
Tiempo agotado, conexiones rechazadas y hosts inaccesibles son avisos reintentables. Autenticación 401/403, endpoint 404 y JSON incorrecto son errores de configuración. Acepte certificados autofirmados explícitamente solo en la conexión elegida; nunca desactive TLS globalmente. Consulte diagnóstico Glances y ajustes Proxmox.
Incluya tipo de integración, versión/digest, URL censurada, código, frecuencia y logs del servicio remoto. Elimine códigos de configuración, contraseñas de inicio, tokens, cookies, claves y datos privados antes de usar el selector de incidencias. No publique el directorio de datos.
Si la configuración guardada está dañada, NasDash conserva el archivo y recupera con acceso privado; la recuperación no publica la instancia. Detenga el servicio, conserve la copia dañada y restaure una copia completa verificada o repare la configuración. Las actualizaciones preparan los archivos relacionados juntos y revierten fallos de escritura indicados; no garantiza resistencia ante cortes de energía. Mantenga copias en almacenamiento separado.