Una URL directa funcional aísla el fallo en la ruta de inicio
Si una aplicación se abre al introducir la IP y el puerto de su host, el contenedor, la publicación del puerto y la ruta LAN básica ya están funcionando. Es más probable que el problema esté en la URL generada por el mosaico de ZimaOS, en el navegador al gestionar ese enlace o en metadatos de la aplicación temporalmente obsoletos.
La respuesta de la comunidad planteó que el lanzador se cargó antes que Docker y conservó una ruta desactualizada. Es plausible, pero no se demostró: el usuario ya había reiniciado Docker y el administrador de aplicaciones, un reinicio completo no ayudó de inmediato y los mosaicos comenzaron a funcionar aproximadamente un día después. Mantén esa incertidumbre mientras diagnosticas el enlace en sí.
Compara el destino del mosaico con la dirección conocida como funcional
Haz clic derecho en el mosaico y copia la dirección del enlace sin abrirlo. Compara el esquema, el nombre de host, la IP, el puerto y la ruta con la URL introducida manualmente que funciona. Un puerto incorrecto o una dirección de host antigua apuntan a metadatos de aplicación obsoletos; una diferencia entre HTTP y HTTPS apunta a la gestión del proxy o de la seguridad del navegador.
Abre la URL copiada del mosaico en una pestaña nueva. Si falla con un error visible del navegador, registra el resultado exacto. Si al hacer clic no se abre ninguna pestaña, comprueba el bloqueo de ventanas emergentes, el filtrado de extensiones y el mismo panel en una ventana privada o en otro navegador.
No edites la red del contenedor hasta completar esta comparación. Si la dirección copiada del mosaico es correcta y funciona al pegarla, el problema está en el evento de clic del panel o en el perfil del navegador. Si la dirección copiada es incorrecta, el problema está en los metadatos del lanzador.
Actualiza primero solo las capas del cliente y los metadatos
Recarga el panel sin usar la caché, cierra sesión y vuelve a iniciarla, y prueba con un perfil limpio del navegador. Desactiva una por una las extensiones que modifican páginas o protegen la privacidad para el origen local de ZimaOS. Estas comprobaciones reversibles deben preceder a los reinicios de servicios del host.
Si todos los clientes limpios reciben la misma URL incorrecta del mosaico, registra el nombre de la aplicación, el puerto mostrado, la dirección copiada, la dirección funcional y la versión de ZimaOS. Reinicia la aplicación una vez y deja que el panel tenga tiempo de detectarla de nuevo. Después, realiza un reinicio ordenado de ZimaOS como punto de verificación, no como prueba de que se haya solucionado.
Evita desconectar la alimentación mientras el almacenamiento esté activo. El usuario original intentó retirar completamente la alimentación sin una recuperación inmediata, por lo que no debe recomendarse como siguiente paso predeterminado. No borres los datos de la aplicación ni reinstales los contenedores mientras sus URL directas sigan funcionando.
Verifica el estado del contenedor solo si la ruta directa también empieza a fallar
Comprueba el estado de la aplicación y el puerto publicado en ZimaOS. Si el acceso directo sigue funcionando, detente en el límite del lanzador. Si el acceso directo también falla, revisa el primer error relevante del registro del contenedor y confirma que su puerto siga vinculado a la interfaz de host esperada.
Prueba una aplicación afectada y otra no afectada. Un solo mosaico con un puerto antiguo sugiere metadatos específicos de la aplicación, mientras que el fallo de todos los mosaicos en un navegador sugiere un problema del cliente. El fallo de todos los mosaicos en distintos clientes después de una actualización es una evidencia más sólida de un problema en el administrador de aplicaciones o en la capa del panel.
Después de cualquier recuperación, repite la prueba de clic original en el mismo navegador, después de recargar el panel y después de un reinicio normal. La recuperación significa que el mosaico abre de forma constante la misma dirección que la URL directa conocida como funcional, no simplemente que el estado del contenedor indique «en ejecución».
Solicita asistencia con las dos URL en lugar de restablecer el sistema
Si el problema vuelve a aparecer, captura la URL copiada del mosaico y la URL que funciona manualmente, ocultando los datos privados del host cuando sea necesario. Incluye las marcas de tiempo, el nombre de la aplicación, el navegador, las extensiones, la versión de ZimaOS y si otro cliente se comporta de la misma manera.
Indica si el problema apareció después de una actualización de la aplicación, un cambio de puerto, un cambio de dirección del host, una configuración del proxy o una actualización de ZimaOS. Esos desencadenantes ayudan al soporte a reproducir el mapeo obsoleto en lugar de esperar a que vuelva a corregirse por sí solo.
No hagas un restablecimiento de fábrica, no elimines la aplicación ni realices una limpieza general de Docker mientras el acceso directo funcione. El hilo original terminó con una recuperación espontánea y sin una causa confirmada, por lo que una reparación destructiva eliminaría pruebas sin abordar un fallo verificado.
Preguntas frecuentes
¿Reiniciar Docker reconstruye todos los enlaces de aplicaciones de ZimaOS?
El hilo no lo demuestra. El usuario reinició Docker y el administrador de aplicaciones, y el problema persistió temporalmente.
¿Por qué funciona al pegar la URL del mosaico cuando al hacer clic no funciona?
Ese resultado aísla el problema en la gestión de clics del navegador, las extensiones o el código JavaScript del panel. Prueba una ventana privada y otro navegador antes de cambiar el servidor.
¿Debo reinstalar la aplicación afectada?
No mientras la URL directa funcione y los datos estén intactos. Compara las direcciones y recopila primero pruebas sobre el lanzador.
Las observaciones originales y la cronología aún no resuelta se encuentran en el debate sobre los mosaicos de aplicaciones de ZimaOS.
