Comience por comprobar si la pantalla en blanco afecta a un solo archivo o a todos. A continuación, revise los paneles de Red y Consola del navegador, junto con los registros de Collabora y de la plataforma de almacenamiento. Una pantalla en blanco es un síntoma, no un diagnóstico: es posible que el editor se haya cargado mientras fallaba la conexión con el documento, la autorización WOPI o los recursos integrados.
Abra un documento que funcione correctamente en la misma aplicación y, a continuación, intente abrir el archivo afectado en otro navegador compatible o en una ventana privada. No edite el archivo original durante el diagnóstico. Un solo archivo defectuoso indica un problema con el formato, el contenido o los permisos; un fallo generalizado apunta a problemas con los servicios compartidos o cambios en la red.
| Lo que observas | Próxima comprobación más útil | Intercambio |
|---|---|---|
| Un documento está en blanco | Pruebe con un archivo diferente del mismo formato; inspeccione el archivo de la aplicación de almacenamiento y los registros WOPI. | Aislamiento rápido, pero no descarta un problema de análisis o permisos específico del archivo. |
| Todos los documentos fallan en un navegador. | Ventana privada, otro navegador, extensiones y consola del navegador. | Es una solución rápida y de bajo riesgo, pero usar el navegador como alternativa no soluciona un problema del servidor. |
| Todos los usuarios y navegadores fallan | Solicitudes de red, proxy inverso, política de host WOPI y registros del servidor. | Tiene mayor valor diagnóstico, pero los cambios pueden afectar a todos los usuarios; primero, capture la configuración actual. |
Una ventana privada sirve para probar, no para solucionar el problema. Si funciona, desactive las extensiones una por una o borre los datos del sitio para el origen afectado solo después de confirmar que no hay trabajo sin sincronizar. Borrar todos los datos del navegador puede cerrar la sesión de los usuarios y eliminar el estado del sitio que no esté relacionado.
En Chrome o Chromium, abre las Herramientas para desarrolladores ( F12 o Ctrl+Mayús+I ), selecciona Red , habilita Conservar registro y recarga la página. Filtra por WS (WebSocket) e inspecciona los errores; la referencia de Red de las Herramientas para desarrolladores de Chrome explica los filtros de solicitud y los detalles de estado. Revisa la Consola para detectar errores de CSP, certificado, contenido mixto o JavaScript.
Interprete la evidencia en lugar de aplicar una fórmula genérica:
/browser/rutas del editor: compruebe si el proxy inverso reenvía las rutas actuales de Collabora al servidor ascendente correcto./hosting/discoverypunto final accesible solo demuestra el acceso HTTP básico; no demuestra que la conexión en tiempo real del editor funcione.En las solicitudes WebSocket, el objetivo es un establecimiento de conexión exitoso; el estado que se muestra depende de la versión HTTP y la ruta del proxy, por lo que no se debe considerar un único número de estado esperado como universal.
La guía actual de solución de problemas de Nextcloud para la oficina indica que el navegador del usuario debe acceder a ambos servidores mediante HTTP(S), Nextcloud debe acceder a Collabora y Collabora debe acceder a Nextcloud. También requiere el mismo protocolo en ambos servicios. Pruebe la dirección pública de Collabora desde un navegador en https://office.example.com/hosting/discoveryy https://office.example.com/hosting/capabilities. Desde el host de Nextcloud, utilice:
curl -fsS https://office.example.com/hosting/discovery -o /dev/null
curl -fsS https://office.example.com/hosting/capabilities -o /dev/null
Sustituya el nombre de host de ejemplo por su URL real de Collabora. Estas comprobaciones verifican la accesibilidad HTTP, no la edición exitosa. Si el servidor se conecta correctamente pero el navegador falla, revise la configuración de DNS público, TLS, firewall o proxy. La guía de solución de problemas de Nextcloud Office enumera estas comprobaciones de conexión y recomienda revisar los registros de ambas aplicaciones.
Si los recursos del editor estático devuelven un error 404 o la conexión en vivo devuelve un error 502, compare las rutas de su proxy inverso con la configuración oficial del proxy de Collabora . Asegúrese de que el proxy envíe las rutas de Collabora necesarias al servidor ascendente correcto y admita la conexión WebSocket que utiliza el navegador. Conserve la información de host externo y HTTPS que espera su implementación. No copie una configuración para un proxy, prefijo de URL o versión de Collabora diferente sin verificar sus supuestos. Un nombre de host dedicado de Collabora suele ser más fácil de depurar; el enrutamiento basado en rutas requiere un manejo de prefijos consistente.
WOPI es el protocolo que Collabora utiliza para obtener y guardar un documento a través de la plataforma de almacenamiento. El host WOPI suele ser el nombre de host de Nextcloud u otro almacenamiento, no el de Collabora. Si los registros indican No acceptable WOPI hosts found, agregue o corrija el host de almacenamiento exacto en la configuración del host WOPI de Collabora y, a continuación, confirme que la lista de permisos de solicitudes WOPI de la plataforma de almacenamiento contiene la dirección del servidor de Collabora. Nextcloud recomienda limitar las solicitudes WOPI a las direcciones IP de Collabora previstas y configurar Collabora para que confíe en los hosts previstos en su guía de configuración de Office .
Agregar un host de confianza específico es más seguro que deshabilitar la validación de host o permitir dominios amplios. Registre la configuración actual, modifique solo la entrada relevante y reinicie o recargue los servicios solo cuando sea necesario para su implementación. Si usa Docker, inspeccione la salida reciente de Collabora con docker logs --since=10m <collabora-container>; reemplace el marcador de posición con el nombre real del contenedor. Para instalaciones de paquetes o Kubernetes, utilice sus registros de servicio o pod.
Recarga el mismo documento. Confirma que los recursos se cargan, que la conexión en tiempo real permanece abierta, que el contenido aparece y que los errores de la consola desaparecen. Si el problema se ha compartido, prueba con un segundo documento y otro usuario. Guarda una edición de prueba sin consecuencias y vuelve a abrirla para verificar que se lea y se guarde correctamente.
Si el lienzo permanece en blanco pero las solicitudes ahora se procesan correctamente, revise los registros del servidor en busca de errores de conversión de documentos o errores específicos del archivo y compare con otro archivo del mismo formato. Si el problema comenzó inmediatamente después de una actualización de Collabora, del navegador o del proxy, pruebe una reversión controlada o un cambio de proxy específico de la versión durante una ventana de mantenimiento en lugar de modificar varias variables a la vez. Borrar la caché del navegador solo es útil cuando la evidencia apunta a recursos del cliente obsoletos; no puede reparar rutas bloqueadas ni solicitudes WOPI rechazadas.
Instale el gráfico Helm oficial de Collabora, configure el acceso WOPI y la afinidad de entrada, y verifique la implementación sin errores de configuración comunes.
Utilice las solicitudes del navegador, los registros WOPI y las comprobaciones de proxy específicas para averiguar por qué Collabora abre un documento en blanco y elija una solución que se ajuste a las pruebas.
Configure correctamente los diccionarios de CODE Docker y etiquete los pasajes del documento para que el inglés, el francés y otros idiomas compatibles reciban la corrección ortográfica adecuada.
Ajusta el umbral de inactividad por vista en coolwsd y diferéncialo del atenuado de pestañas en segundo plano, la descarga de documentos, el guardado automático y la expiración de la sesión.
Detenga las comprobaciones de actualización de CODE programadas, revise los servicios remotos opcionales y utilice los controles de red salientes sin interrumpir la edición de documentos.
Habilite la edición segura de documentos en Seafile configurando la URL de descubrimiento de Collabora, HTTPS y el acceso WOPI para su implementación.
Pruebe el portapapeles del sistema, ajuste los permisos del navegador e identifique cuándo una integración de Collabora integrada necesita un cambio en la política de iframe.
Monta los archivos de fuentes en Docker y en la placa del sistema de Collabora para que las tipografías personalizadas aparezcan en el editor y se muestren correctamente en los documentos.
Realice una copia de seguridad de coolwsd.xml y sus fuentes de implementación, restáurelas de forma segura y verifique el CÓDIGO antes de que los usuarios vuelvan a editarlo.
Permita el origen exacto de Nextcloud u otro WOPI en CODE, luego verifique la lista de hosts permitidos activa y distíngala de la restricción de IP de origen de Nextcloud.
