Comience por verificar la conexión WebSocket y la accesibilidad de ambos servidores. Un editor de Collabora Online que se abre con una pantalla negra, una página en blanco o un lienzo de documento vacío suele fallar antes de que la interfaz de usuario del documento termine de cargarse. Si el problema afecta a todos los archivos, primero revise la ruta del navegador a Collabora, el proxy inverso y la conexión de Nextcloud a Collabora. Si solo falla un archivo, pruebe con otro documento y verifique sus permisos y formato antes de modificar la configuración del servidor.
Siga este orden: revise el navegador, pruebe los puntos de acceso de detección de Collabora, lea los registros de integración y del servidor, y luego corrija únicamente la configuración del proxy o de WOPI que indiquen las evidencias. Restablecer la caché del navegador puede ayudar con los recursos obsoletos, pero no solucionará un problema con WebSocket ni un host WOPI inaccesible. Las imágenes de la interfaz que se muestran a continuación son ejemplos esquemáticos; las etiquetas y las rutas de solicitud exactas varían según el navegador, la plataforma en la nube, el proxy y la versión de Collabora.
| Lo que ves | Primer lugar para comprobar | Posible próxima acción |
|---|---|---|
| Todos los documentos permanecen en blanco o se siguen cargando. | Pestaña Red del navegador y proxy de Collabora | Inspeccione las solicitudes fallidas /cool/…/wso /browserde descubrimiento. |
| La URL de Collabora funciona, pero Nextcloud no puede abrir un archivo. | URL de Nextcloud Office, lista de permitidos de WOPI y registros del servidor. | Confirme la URL pública correcta y la conectividad bidireccional del servidor. |
| Solo un documento está en blanco. | Permisos de archivo, estado de uso compartido, formato e integridad del archivo | Pruebe con un documento que sepa que funciona correctamente antes de cambiar la configuración global del proxy. |
| Funciona en un navegador pero no en otro. | Consola del navegador, extensiones y datos de sitios almacenados en caché | Pruebe una ventana privada y compare las solicitudes fallidas. |
Primero, abre un segundo documento que sepas que se puede leer y prueba el mismo archivo en un navegador diferente o en una ventana privada. Si un documento falla mientras que los demás se abren, comprueba que el usuario aún pueda descargarlo o previsualizarlo en la plataforma de archivos. Un archivo dañado, un formato no compatible, un recurso compartido caducado o la falta de permisos pueden parecer un problema del editor, pero cambiar el proxy inverso no solucionará un problema específico del archivo.
Para comprobarlo en el navegador, abre las Herramientas para desarrolladores antes de recargar el documento en blanco. En navegadores basados en Chromium, pulsa F12o Ctrl+Shift+I, selecciona Red , habilita Conservar registro y recarga. Filtra por ws, cool, o browser. Revisa también la pestaña Consola para ver si hay scripts bloqueados, advertencias de certificado o errores de política de seguridad de contenido.
Una solicitud fallida apunta /cool/…/wsa un problema de protocolo de enlace WebSocket o de proxy. Un código de estado 502generalmente significa que el proxy no pudo obtener una respuesta útil de su servidor ascendente; un código de estado 404puede significar que la ruta no está enrutada; y un 403código de estado puede indicar un host rechazado o una regla de acceso. Estos códigos de estado acotan la búsqueda, pero se necesitan los registros del proxy y de Collabora correspondientes para identificar la causa exacta. Si las solicitudes fallidas son archivos JavaScript o CSS en /browser, verifique que el proxy reenvíe esos recursos estáticos al servicio de Collabora.
Si las solicitudes de red se ejecutan correctamente en una ventana privada, desactive temporalmente las extensiones del navegador que bloquean los scripts o las solicitudes entre sitios. A continuación, borre los datos del sitio solo para los nombres de host de la nube y Collabora. Vuelva a realizar la prueba antes de modificar la configuración del servidor. No borre la caché como solución principal si la misma solicitud sigue fallando en la pestaña Red.
Para la integración con Nextcloud, verifique la URL del servidor de Collabora Online en la configuración de administración de Office. Utilice la URL pública accesible desde navegadores, con el nombre de host y el puerto correctos. Según las directrices actuales de Nextcloud, los servicios de Collabora y Nextcloud deben usar el mismo protocolo; se recomienda HTTPS. Una incompatibilidad, como que un servicio esté configurado con HTTPS http://mientras que el otro se acceda mediante HTTPS, https://puede provocar el bloqueo de solicitudes de contenido mixto o fallos en las devoluciones de llamada.
Desde un navegador en el cliente afectado, abra https://office.example.com/hosting/discoveryy https://office.example.com/hosting/capabilities, reemplazando el nombre de host de ejemplo con el suyo. El punto final de descubrimiento debería devolver XML que describa las acciones de documento compatibles; las capacidades deberían devolver una respuesta del servidor de Collabora. Un error del navegador, una página de inicio de sesión, un error 404 con la marca del proxy o un error de puerta de enlace significa que la ruta pública no está llegando al punto final de Collabora esperado.
Luego, realiza la prueba desde el host de Nextcloud, ya que la prueba del navegador por sí sola no demuestra que los servidores puedan comunicarse entre sí:
curl -sS -o /dev/null -w "%{http_code}\n" https://office.example.com/hosting/discovery
curl -sS -o /dev/null -w "%{http_code}\n" https://office.example.com/hosting/capabilitiesReemplace office.example.comcon el nombre de host de Collabora configurado. Una respuesta HTTP exitosa es una comprobación de accesibilidad útil, mientras que un tiempo de espera agotado, un fallo de DNS, un error de TLS o una respuesta 5xx deben resolverse en la capa de red, certificado, DNS o proxy correspondiente. Para instalaciones donde el servidor de Collabora debe comunicarse con Nextcloud, pruebe también la URL de estado de Nextcloud desde el host de Collabora:
curl -fsS https://cloud.example.com/status.phpUtilice su nombre de host real de Nextcloud. Las instalaciones CODE integradas pueden usar una URL de proxy interna en lugar de un nombre de host público de Collabora independiente, así que siga las instrucciones para esa implementación en lugar de aplicar literalmente el ejemplo del servidor independiente.
Collabora sirve recursos del navegador y sesiones de documentos a través de varias rutas. Un proxy inverso debe reenviar las rutas esperadas por la versión instalada, incluidos los recursos del editor, los puntos finales de descubrimiento y capacidades, y la ruta WebSocket del documento. La documentación actual de Collabora utiliza /cool/…/ws; las implementaciones más antiguas aún pueden tener configuración para /loolrutas heredadas. La documentación de migración de Nextcloud menciona específicamente los cambios históricos de ruta de loleafleta browsery de loola cool.
En la configuración de su proxy, verifique que la ubicación de WebSocket coincida antes de aplicar reglas generales, que el proxy reenvíe los encabezados de actualización necesarios para su software de proxy y que el enlace ascendente apunte al servicio y puerto reales de Collabora. Confirme también que el proxy conserve la información de host y esquema esperada y permita que las conexiones de larga duración permanezcan abiertas. Si TLS finaliza en el proxy, asegúrese de que la configuración de terminación SSL de Collabora coincida con ese diseño.
El breve fragmento de código anterior muestra el tipo de encabezados WebSocket que puede necesitar un proxy de estilo Nginx; no se trata de una configuración completa del proxy. No lo copie y pegue solo ni combine directivas de diferentes versiones. Compare su configuración completa con la guía oficial de proxy inverso de Collabora para la versión de proxy y Collabora que utilice. Después de editar un archivo de proxy, valide su sintaxis con el comando configuration-test del servidor antes de recargarlo.
Collabora utiliza WOPI (Interfaz de Plataforma Abierta para Aplicaciones Web) para solicitar documentos a un servicio de almacenamiento conectado, como Nextcloud. El servidor de Collabora debe aceptar la dirección del host WOPI, y el servidor de almacenamiento debe poder acceder al servicio de Collabora. En Nextcloud, revise la configuración de Office y la lista de permisos para las solicitudes WOPI. Añada únicamente la dirección del servidor de Collabora; no desactive la validación del host ni permita que hosts arbitrarios provoquen que la pantalla en blanco desaparezca.
Lea los registros en el momento en que se reproduzca el problema. Para una implementación de Docker, la guía de solución de problemas de Nextcloud documenta cómo revisar el registro del contenedor; utilice el nombre o ID real del contenedor:
docker logs --tail 100 collaboraEn una instalación basada en paquetes, los nombres de los servicios y los destinos de los registros dependen del sistema operativo y de la versión del paquete. Una comprobación común de systemd es:
sudo journalctl -u coolwsd -n 100 --no-pagerBusque una marca de tiempo coincidente y errores relacionados con un host WOPI no autorizado, CheckFileInfouna solicitud fallida, una verificación TLS, almacenamiento no disponible o un error de WebSocket. Un mensaje que indica que no se encontró ningún host WOPI aceptable generalmente significa que el nombre de host de almacenamiento configurado para la integración no coincide con el host permitido por Collabora. Corrija el nombre de host o la entrada de la lista de permitidos en lugar de agregar dominios no relacionados.
Inspeccione también el registro de la plataforma de archivos para la misma hora de solicitud. Si Collabora no puede conectarse a Nextcloud, verifique la resolución DNS desde el host de Collabora, las reglas del firewall, la ruta pública o interna y si el servicio está intentando conectarse a sí mismo a través de un nombre de host que se resuelve de manera diferente dentro de la red de contenedores. El manual de solución de problemas de Nextcloud recomienda verificar la conectividad en ambas direcciones y usar los registros del servidor para identificar el lado que falla.
Tras corregir una ruta, URL, certificado o entrada de la lista de permitidos, recargue el proxy y los servicios afectados solo cuando su implementación lo requiera. Vuelva a abrir las Herramientas para desarrolladores, recargue el archivo y confirme que la solicitud anterior fallida ahora se completa. El documento debería mostrar sus páginas u hojas, aceptar una pequeña edición y guardarla correctamente. Una página en blanco que desaparece pero no se puede guardar sigue indicando una conexión WOPI o de almacenamiento sin resolver.
/loolo /loleafletlas rutas existentes donde sea necesario.Un resultado fiable implica más que la simple aparición de la barra de herramientas del editor. El contenido del documento se muestra correctamente, no hay solicitudes de editor ni de WebSocket que fallen de forma persistente, y una edición de prueba inofensiva se guarda y permanece después de actualizar la página. Si el problema persiste, conserve un breve extracto de la consola/red del navegador (con información confidencial eliminada) y las líneas de registro correspondientes de Nextcloud, el proxy y Collabora. Los registros pueden contener nombres de host, nombres de usuario, identificadores de archivo o tokens, por lo que debe eliminar los valores confidenciales antes de compartirlos.
Para conocer los pasos específicos de la implementación actual, consulte la guía de solución de problemas de Nextcloud Office , la referencia de configuración de Nextcloud Office y las notas de migración de Collabora . Las comprobaciones exactas para ownCloud, otro host WOPI, un servicio CODE integrado o una plataforma de contenedores pueden diferir de los ejemplos de Nextcloud.
Aprende a desactivar los informes de errores de LibreOffice, los datos del agente de usuario de Actualización en línea y las comprobaciones de actualización automáticas opcionales, además de cómo verificar la configuración.
Instale ONLYOFFICE Docs Enterprise con el archivo Docker Compose oficial, configure JWT y el almacenamiento persistente, agregue su licencia y verifique el servicio.
Aprende a usar expresiones regulares en la función Buscar y reemplazar de LibreOffice para limpiar texto, capturar y reordenar datos, controlar el alcance y elegir alternativas más seguras.
Crea una macro segura de JavaScript para ONLYOFFICE que limpie el texto de las hojas de cálculo, conserve las fórmulas y los números, y verifique cada cambio antes de guardar el libro de trabajo.
Compara Collabora Online y ONLYOFFICE Docs con las directrices oficiales de dimensionamiento y una prueba repetible para CPU, memoria, tiempo de apertura, latencia de coedición y guardado.
Agregue fuentes personalizadas a Collabora Online CODE en Docker, compare los puntos de montaje, las imágenes personalizadas y la configuración de fuentes remotas, y luego verifique las fuentes en un documento.
Solucione problemas con el menú desplegable de tamaño de fuente de Collabora Online que aparece recortado, estirado o que no responde. Restablezca el zoom de la página, introduzca un tamaño manualmente y compruebe las correcciones de la versión de CODE.
Solucione la advertencia de LibreOffice JRE decidiendo si necesita las funciones de Java, instalando un entorno de ejecución compatible y seleccionándolo en las opciones avanzadas.
Conecte ONLYOFFICE Docs a una aplicación PHP personalizada con una URL de documento segura, una configuración de editor firmada, una API de JavaScript y una función de devolución de llamada para guardar.
Establezca una contraseña para la consola de administración en línea de Collabora para un paquete de Linux o una implementación de Docker de CODE, luego verifique el inicio de sesión y proteja el punto final de administración.
