Operación

Solución de problemas

Diagnostica un puerto ocupado, un contenedor unhealthy, WebGL o un build roto.

La página no responde

  1. Comprueba el puerto: 2502 para Docker, 2499 para Vite.
  2. Inspecciona el contenedor:
docker compose ps
docker compose logs --tail 100 astroguide
  1. El healthcheck consulta http://127.0.0.1:2502/ dentro del contenedor. Un fallo señala a Nginx, no al navegador.

Pantalla negra o escena 3D ausente

  • WebGL debe estar disponible;
  • un bloqueador agresivo puede romper los módulos;
  • el renderizado se detiene intencionadamente fuera de la vista 3D: vuelve a la exploración 3D.

El aviso THREE.Clock de la consola es conocido y no constituye por sí solo un fallo.

Falla docker compose up

  • puerto del host ocupado: cambia solo el puerto del host a la izquierda y conserva el puerto del proyecto a la derecha;
  • falta el lockfile o npm ci --include=optional durante un build local;
  • permisos insuficientes para ejecutar Docker.

La demo no muestra la bienvenida

Probablemente ejecutas el producto normal (npm run dev o la imagen GHCR). La insignia y la bienvenida solo existen en dev:demo y build:demo.

Calidad del checkout

npm run check
npm audit --audit-level=high

Modo demo

Alcance de la demo pública, build aislado y reinicio de la sesión.

Preguntas frecuentes

Respuestas breves a las preguntas habituales de instalación y uso.