Qué comprobar cuando ownCloud Web se abre en una página en blanco.

Cuando ownCloud Web se abra mostrando una página en blanco, intente acceder a la misma URL en una ventana privada con un navegador compatible. Si el problema persiste, abra las herramientas para desarrolladores del navegador y revise los paneles Consola y Red. Utilice la solicitud fallida para decidir si debe borrar los datos del sitio web, reparar un recurso web faltante o inspeccionar los servicios de Infinite Scale y proxy inverso. Evite eliminar los datos del servidor o reinstalar la instancia antes de realizar esta comprobación.

ownCloud Web es la interfaz web que viene con Infinite Scale, aunque los administradores pueden reemplazar sus recursos compilados con una compilación personalizada. Por lo tanto, una página en blanco puede deberse al navegador, a un recurso JavaScript faltante o incorrecto, o a una respuesta del servidor/proxy que impide que la interfaz se cargue. Los pasos que se describen a continuación diferencian estos casos. Los paneles de la interfaz son ejemplos ilustrativos; compárelos con el navegador y la salida de la implementación reales.

1. Averigüe si el problema es local o afecta a todo el servidor.

Pídele a otro usuario que abra la misma URL pública e inténtalo tú mismo en una ventana privada. Por ejemplo, si un empleado ve una página en blanco mientras que otro puede navegar por los archivos, empieza por investigar las causas específicas del navegador. Si todos ven la misma página, pasa directamente a revisar la red y el servidor.

  1. Utilice un navegador de escritorio compatible con ownCloud Web. La página de requisitos actuales enumera las versiones recientes de Chrome, Firefox y Edge, y Safari 16 o posterior en sistemas operativos de escritorio compatibles.
  2. Abra la instancia en una ventana privada. Si la interfaz se carga allí, desactive las extensiones una por una en el perfil normal y, a continuación, borre los datos del sitio solo para el nombre de host de ownCloud. Borrar los datos del sitio puede cerrar su sesión; no elimina los archivos almacenados en el servidor.
  3. Actualiza la página en blanco con la caché del navegador desactivada mientras las herramientas para desarrolladores estén abiertas. Si el mismo fallo persiste en varios navegadores compatibles y para varios usuarios, es más probable que se trate de un problema del servidor o de la implementación.

Ventana del navegador ilustrativa que muestra una página blanca completamente en blanco en el nombre de host de la nube de ejemplo.

Ilustración del síntoma: el navegador ha accedido al servidor en la nube, pero el área de contenido de la página permanece en blanco.

2. Utilice la solicitud fallida para elegir una solución.

Abre las herramientas para desarrolladores (normalmente F12 o Ctrl+Mayús+I en Windows/Linux, u Opción+Comando+I en macOS). Selecciona Consola para ver los errores de JavaScript, luego selecciona Red , recarga la página y busca las solicitudes fallidas. El código de estado y el tipo de solicitud son más útiles que la pantalla en blanco por sí sola.

  • Una solicitud de JavaScript o CSS devuelve un error 404: el navegador solicitó un recurso que no se encontró en esa URL. Si esto ocurre solo en un perfil de navegador, borre los archivos en caché de ese sitio y vuelva a cargarlo. Si el mismo recurso falla para todos, revise la ruta del recurso, el enrutamiento del proxy inverso y cualquier configuración web personalizada.
  • Una solicitud devuelve un error 502, 503 o un error de conexión: el proxy no pudo obtener una respuesta útil del servicio de origen o el servicio no estaba disponible. Verifique el estado de la implementación y los registros antes de cambiar la configuración del navegador.
  • La consola informa de una solicitud bloqueada, un error de certificado o una advertencia de contenido mixto: compare el nombre de host público y el esquema HTTPS que utiliza el navegador con la URL y la configuración del proxy. Si ha modificado recientemente el dominio, la terminación TLS o las reglas del proxy, pruebe primero ese cambio.
  • La página carga los recursos con respuestas 200, pero JavaScript sigue fallando: registre el primer error de la consola y las versiones de ownCloud Web/Infinite Scale. Un error de sintaxis o de tiempo de ejecución puede indicar una compilación o extensión personalizada incompatible; no lo deduzca únicamente a partir de una respuesta 200.

Consola de herramientas para desarrolladores del navegador que muestra un ejemplo de respuesta 404 para un recurso JavaScript.

Ejemplo de diagnóstico: un error 404 para un recurso JavaScript es una pista para verificar la URL del recurso y la ruta de servicio, no una prueba de una causa en particular.

3. Compruebe el estado de los recursos web y del servicio.

Si la solicitud fallida corresponde a un recurso, primero determine si su instancia utiliza los archivos web de ownCloud incluidos o archivos compilados a medida. La guía del administrador de ownCloud 8.2 indica WEB_ASSET_PATHque apunta a los recursos del cliente web compilados a medida. Si lo configura, verifique que la ruta exista dentro del despliegue en ejecución, que contenga la compilación completa y que el proceso que sirve la interfaz web pueda leerla. Si no utiliza recursos personalizados, no agregue esta variable como solución provisional.

Para un despliegue de Docker Compose, ejecute estos comandos desde el directorio que contiene el archivo Compose:

docker compose ps
docker compose logs --tail=100 ocis

El primer comando muestra si los servicios están en ejecución; el segundo imprime los registros recientes del servicio con el nombre especificado ocis. Si su archivo Compose utiliza un nombre de servicio diferente o ejecuta el frontend por separado, sustituya el nombre real del servicio e inspeccione también los registros del proxy/frontend. Para una implementación instalada manualmente u orquestada, utilice los comandos de servicio y registro de esa plataforma. Busque fallos de inicio, errores de ruta de recursos o errores de conexión ascendente en el momento de la carga fallida de la página.

Terminal ilustrativo que muestra los comandos `docker compose ps` y `docker compose logs` sin salida de ejemplo.

Ilustración de las dos comprobaciones de Compose; los nombres de los servicios y los mensajes de registro reales varían según la implementación.

4. Verifique la URL pública y la ruta del proxy.

Si las solicitudes apuntan a un nombre de host antiguo, un esquema incorrecto o una ruta que el proxy no admite, verifique la configuración de la URL pública y las reglas del proxy. ownCloud documenta OCIS_URLla URL que define cómo se accede a Infinite Scale. En una implementación que utiliza un proxy inverso, asegúrese de que la dirección HTTPS visible en el navegador, el nombre DNS y las reglas de enrutamiento coincidan con la URL pública configurada. Si el proxy o el dominio se modificaron recientemente, compare la configuración actual con la última versión que funcionaba correctamente y corrija únicamente el valor que no coincida.

Compruebe WEB_ASSET_PATHúnicamente si hay recursos personalizados configurados. Verifique OCIS_URLla configuración de proxy/TLS cuando el navegador se redirija a un host inesperado o solicite recursos desde un origen incorrecto. Esta configuración varía según la implementación, por lo que no copie un valor de ejemplo genérico en producción. La guía oficial de ownCloud Web sobre recursos personalizados , la documentación del servicio de proxy y la guía de TLS describen estas áreas de configuración.

Editor de configuración ilustrativo que resalta WEB_ASSET_PATH y OCIS_URL para comprobaciones de implementación.

Ilustración de los valores de configuración que se deben inspeccionar; los valores correctos dependen de la URL pública y de si se utilizan recursos personalizados.

Verificar la solución

Recarga el sitio en una ventana normal del navegador y confirma que la interfaz se muestra correctamente, que la consola no presenta errores de JavaScript que bloqueen el acceso y que las solicitudes de JavaScript/CSS necesarias ya no devuelven respuestas 404 o 5xx. Pide a un segundo usuario que pruebe la misma dirección pública. Si la página sigue en blanco aunque los recursos se carguen correctamente, guarda el primer error de la consola, los detalles de la solicitud fallida, la versión de Infinite Scale y los registros de servicio relevantes para tu administrador o el soporte de ownCloud. Elimina las cookies, los encabezados de autorización y los tokens antes de compartir las capturas del navegador.

Dejar un comentario

Evita los tiempos de espera de bloqueo de archivos de ownCloud con el backend adecuado.

Distinga entre la contención de bloqueos de base de datos y los bloqueos WebDAV caducados, y luego elija y configure la solución adecuada para ownCloud 10.

Qué comprobar cuando ownCloud Web se abre en una página en blanco.

Qué comprobar cuando ownCloud Web se abre en una página en blanco.

Mediante comprobaciones específicas, puede rastrear el problema de una pantalla web de ownCloud en blanco hasta la caché del navegador, la falta de recursos web, errores del servicio o la configuración de la URL del proxy inverso.

Borre la advertencia de memoria PHP de ownCloud en el entorno de ejecución correcto.

Establezca el límite de memoria PHP web de ownCloud, reinicie el servicio correspondiente y verifique el valor activo sin confundirlo con la configuración de la CLI o los límites de carga.

Solución de problemas de conexión a MySQL en ownCloud 10

Averigua si MySQL, PHP, la configuración de sockets o los permisos de la base de datos están bloqueando ownCloud 10 y, a continuación, verifica si existe una solución segura.

Establece un límite de caducidad estricto para los enlaces públicos de ownCloud.

Establece un límite de caducidad estricto para los enlaces públicos de ownCloud.

En ownCloud Classic, haga obligatoria la caducidad de los enlaces públicos, establezca una duración máxima y compruebe los recursos compartidos existentes que puedan necesitar una limpieza por separado.

Agregue el inicio de sesión de dos factores TOTP a ownCloud Infinite Scale con Keycloak.

Agregue el inicio de sesión de dos factores TOTP a ownCloud Infinite Scale con Keycloak.

Habilite TOTP a través de Keycloak, registre usuarios de forma segura y comprenda cuándo se aplican las configuraciones de MFA a nivel de ruta de Infinite Scale.

Restaura la sincronización de ownCloud haciendo coincidir el cliente con tu servidor.

Compruebe si el problema se debe a un fallo de compatibilidad entre OC10 y la versión 7.x o a un registro CSync dañado, y aplique la solución adecuada sin eliminar los archivos sincronizados.

Configura ownCloud con HTTPS usando Let's Encrypt y Nginx.

Configura ownCloud con HTTPS usando Let's Encrypt y Nginx.

Seleccione HTTP-01 o DNS-01, configure un proxy inverso de ownCloud y verifique que Certbot renueve automáticamente los certificados HTTPS.

Conecta ownCloud Infinite Scale a LDAP para el inicio de sesión de usuarios.

Configure el inicio de sesión LDAP de oCIS, alinee las búsquedas de usuarios y grupos, y verifique la configuración de TLS y del esquema antes de la implementación.

Conecta un bucket de S3 a ownCloud 10 como almacenamiento externo.

Conecta un bucket de S3 a ownCloud 10 como almacenamiento externo.

Agregue un bucket de Amazon S3 a ownCloud 10, prepare credenciales y puntos finales compatibles y verifique el acceso sin confundir un punto de montaje con el almacenamiento principal.