Solución de la comunidad

Cómo solucionar el problema de las aplicaciones de ZimaOS que se abren en una página en blanco

A user found that most ZimaOS apps opened as blank pages even though direct IP-and-port access still worked. Clearing the browser cache restored normal app launching.

¿Por qué las aplicaciones de ZimaOS se abren como páginas en blanco?

En febrero de 2026, un usuario de ZimaOS informó que casi todas las aplicaciones, excepto Plex, se abrían como una página en blanco desde el panel. La pista diagnóstica importante era que las mismas aplicaciones seguían abriéndose cuando el usuario introducía manualmente la dirección IP de ZimaOS y el puerto de la aplicación.

Este comportamiento sugiere que los contenedores de las aplicaciones podrían seguir ejecutándose. En cambio, el problema puede estar entre el lanzador del panel, el estado del navegador y la capa de enrutamiento o proxy local utilizada para abrir la aplicación.

¿Qué solucionó el problema en el hilo original?

La solución confirmada fue sencilla: el usuario borró la caché del navegador e informó que las aplicaciones volvieron a funcionar con normalidad. Por eso, el estado del navegador es lo primero que conviene comprobar cuando el acceso directo mediante IP:PORT funciona, pero abrir la aplicación desde el panel de ZimaOS solo muestra una página en blanco.

¿Qué deberías comprobar primero?

  1. Confirma que la aplicación afectada todavía se puede abrir directamente mediante su dirección IP local y el puerto asignado.
  2. Abre el panel de ZimaOS en una ventana privada o de incógnito del navegador. Si la aplicación funciona allí, es muy probable que los datos almacenados en la caché del navegador sean la causa.
  3. Borra los datos almacenados en la caché del sitio del panel de ZimaOS y vuelve a cargarlo.
  4. Prueba con otro navegador u otro dispositivo cliente para determinar si el problema afecta al servidor o solo a un perfil del navegador.
  5. Solo pasa a solucionar problemas del lanzador, el proxy o el contenedor si borrar los datos del navegador no resuelve el problema.

¿Por qué es importante el acceso directo mediante IP y puerto?

Si la propia interfaz web de una aplicación sigue respondiendo directamente, esto indica que el servicio es accesible y que el contenedor no está completamente detenido. Esto orienta la investigación hacia la forma en que ZimaOS inicia o enruta la aplicación, en lugar de culpar inmediatamente a la propia aplicación.

No es una garantía universal: una aplicación todavía puede presentar fallos parciales aunque su puerto web responda. Sin embargo, es una primera distinción útil durante el proceso de diagnóstico.

¿Cuándo podría tratarse de algo más que la caché del navegador?

Si la página en blanco aparece en varios navegadores limpios, o si el acceso directo mediante IP y puerto también falla, el problema ya no es el mismo que el del caso comunitario resuelto. Comprueba si la aplicación se está ejecutando, si su puerto asignado cambió y si hay algún proxy inverso o configuración de red entre el navegador y ZimaOS.

Las versiones actuales de ZimaOS siguen mejorando el inicio de aplicaciones, la descarga de imágenes y el funcionamiento de App Store. Si el problema comienza inmediatamente después de una actualización, anota la versión de ZimaOS y las versiones de las aplicaciones afectadas antes de modificar la implementación.

Para consultar el comportamiento actual de las aplicaciones y las opciones de instalación, visita la guía de ZimaOS App Store.

Preguntas frecuentes

¿Debería reinstalar todas las aplicaciones si el panel las abre como páginas en blanco?

No como primera medida. En el hilo resuelto, se podía acceder directamente a los contenedores y borrar la caché del navegador solucionó el problema de lanzamiento desde el panel.

¿Por qué Plex seguía funcionando cuando las demás aplicaciones no?

El hilo no establece un motivo definitivo. El resultado importante es que el problema general desapareció después de borrar la caché del navegador.

¿Una URL de IP y puerto que funciona demuestra que el contenedor está completamente sano?

No, pero sí demuestra que el servicio web es accesible y ayuda a distinguir un problema de lanzamiento o del navegador de un servicio completamente detenido.

¿Qué ocurre si borrar la caché no ayuda?

Prueba con otro navegador limpio, confirma que la aplicación todavía responde directamente y, después, investiga el estado de la aplicación, las asignaciones de puertos, la red y cualquier capa de proxy involucrada.