Solución de problemas
Resuelva errores comunes según el síntoma.
La interfaz no se inicia
Compruebe docker compose ps y, a continuación, los registros. Una montaje de enlace (bind mount) inaccesible para el UID 1001, un secreto (secret) ausente o un puerto ya en uso son las primeras causas que debe descartar.
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
Es probable que el proxy esté bloqueando la ruta. Revise CONTAINERS, POST, DELETE y otros permisos. No active capacidades innecesarias de forma global.
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 la visibilidad de las categorías y las listas de permisos (allowlists) del usuario, y luego vuelva a iniciar sesión como espectador. Las sesiones existentes pueden requerir un nuevo inicio de sesión después de un cambio significativo.