Para empezar, compruebe que el navegador, Nextcloud y Collabora puedan acceder a las URL de servidor correctas mediante el mismo protocolo HTTP o HTTPS. En Nextcloud, pruebe /hosting/capabilitieslos /hosting/discoverypuntos finales de Collabora; si responden pero los documentos siguen fallando, revise la ruta WebSocket del proxy inverso y la lista de permisos WOPI.
El mensaje «Bueno, esto es vergonzoso» es un error genérico al abrir un documento, no un diagnóstico en sí mismo. La causa puede ser una URL inaccesible, una discrepancia en TLS o DNS, un proxy que rechaza las actualizaciones de WebSocket o un host WOPI en el que Collabora o Nextcloud no confían. Las comprobaciones que se muestran a continuación utilizan un ejemplo típico con Nextcloud en https://cloud.example.comy Collabora en https://office.example.com; sustituya ambos nombres por sus nombres de host reales.
Desde un navegador en la misma red que el usuario, abra estas URL, cambiando el nombre de host de Collabora:
https://office.example.com/hosting/capabilitieshttps://office.example.com/hosting/discoveryDeberían devolver datos del punto final de Collabora en lugar de una advertencia de certificado del navegador, una página 404 o un error de proxy inverso. El punto final de descubrimiento normalmente devuelve XML. También puede realizar pruebas desde el host de Nextcloud o su contenedor de aplicaciones:
curl -fsS https://office.example.com/hosting/capabilities
curl -fsS https://office.example.com/hosting/discoveryUn fallo en el navegador indica problemas con el DNS público o de la LAN, el cortafuegos, el certificado o el enrutamiento del proxy. Si el navegador funciona correctamente pero Nextcloud falla mediante la línea de comandos, significa que la ruta del servidor es diferente; tanto el navegador del usuario como el servidor de Nextcloud necesitan su propia ruta de acceso a Collabora. El manual de administración actual de Nextcloud recomienda probar ambos puntos de acceso desde ambas ubicaciones y confirmar que Collabora también puede acceder a Nextcloud mediante HTTP(S).
En Nextcloud, abre Configuración → Administración → Office y confirma que el campo Servidor de Collabora Online contenga la URL pública o accesible de Collabora. Úsala https://si el servicio está configurado para HTTPS. La documentación de Nextcloud indica que la URL configurada debe usar el mismo protocolo que la instalación de Collabora y recomienda HTTPS.
Ahora verifique la ruta de retorno. Desde el host o contenedor de Collabora, solicite el punto final de estado de Nextcloud:
curl -fsS https://cloud.example.com/status.phpLa respuesta debe ser accesible desde Collabora, no solo desde tu portátil. Si alguno de los servidores está en Docker, realiza la prueba desde el contenedor o espacio de nombres de red correspondiente: un nombre de host que se resuelve en el host puede no resolverse dentro de un contenedor. Para un servidor CODE integrado, Nextcloud debe poder acceder a sí mismo utilizando el mismo nombre de host que los usuarios usan en el navegador. Si la resolución de nombres local o la DNS dividida lo impiden, corrige la DNS o la asignación de host en lugar de intentar acceder localhosta un servicio remoto.
Si la URL de descubrimiento se carga, pero el editor permanece en blanco, gira indefinidamente o se desconecta, revise el proxy que se encuentra frente a Collabora. La edición utiliza una conexión WebSocket persistente: el proxy debe redirigir /cool/…/wsel punto final actual de Collabora al servicio de Collabora y transmitir los encabezados de actualización HTTP/1.1. Consulte el ejemplo de proxy de Collabora actual para su software y versión; no copie una configuración antigua sin modificar.
Las instalaciones más antiguas aún pueden usar rutas como /lool. La guía de migración de Collabora documenta el cambio de loola cooly de loleafleta browser. Un proxy que se deja en las rutas antiguas puede devolver errores 404 incluso cuando se abre el dominio base. Después de editar un archivo proxy, valide su sintaxis con el comando de prueba de ese servidor, recárguelo y luego vuelva a probar la URL de descubrimiento y abra un documento.
Revise los registros de acceso y de errores con la misma marca de tiempo que el intento fallido. Un error 404 /browsersugiere /coolenrutamiento de ruta; una actualización fallida de WebSocket indica que falta el manejo de la actualización o que se agotó el tiempo de espera; un error 502 generalmente significa que el proxy no puede conectarse con el servidor ascendente de Collabora. Estas son pistas, no diagnósticos definitivos, así que compárelas con el registro de Collabora.
WOPI (Web Application Open Platform Interface) es el protocolo que Nextcloud y Collabora utilizan para intercambiar solicitudes de acceso a documentos. Si el registro de Collabora informa "No se encontraron hosts WOPI aceptables" o un host WOPI no autorizado, confirme que Collabora se configuró para confiar en el nombre de host de Nextcloud, no en su propio nombre de host de Collabora. Con la imagen de Docker, inspeccione la configuración de inicio y los registros del contenedor:
docker ps
docker logs --tail=100 CONTAINER_NAMEReemplazar CONTAINER_NAMEcon el nombre real del contenedor de Collabora. Para una instalación de paquete nativo, inspeccione el registro de servicio con sudo journalctl -u coolwsd --since "15 minutes ago". Siga las instrucciones de configuración del host WOPI para su método de instalación; evite reglas de permiso con comodines amplios.
En Nextcloud Office también existe una lista de permisos WOPI independiente. Esta lista restringe las direcciones IP de los servidores Collabora que pueden solicitar archivos a Nextcloud. Añada la dirección IP de origen que Nextcloud detecta para Collabora, la cual puede variar si se utiliza una red Docker o un proxy inverso. No introduzca 0.0.0.0ni desactive la restricción solo para evitar un error: Nextcloud recomienda limitar las solicitudes WOPI a las direcciones IP de los servidores Collabora previstas.
Vuelva a realizar la prueba desde el navegador del usuario y desde el servidor Nextcloud: los puntos finales de descubrimiento y capacidades deberían responder, Nextcloud debería acceder a su URL de Collabora configurada y Collabora debería acceder al punto final de estado de Nextcloud. A continuación, abra un documento de prueba pequeño. Si sigue fallando, registre la marca de tiempo, la acción del documento afectado, el estado HTTP o WebSocket en el registro del proxy y las entradas correspondientes en los registros de Nextcloud y Collabora. Esta información ayuda a distinguir un fallo en la ruta de red de un problema de autorización WOPI.
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.
Analiza las conexiones del navegador, WOPI y WebSocket de Collabora para descubrir por qué no se abre un documento y, a continuación, aplica la solución que coincida con la configuración de tu Nextcloud.
Implementa réplicas de Collabora CODE con Helm, mantén cada documento en un pod mediante la afinidad WOPI y verifica el acceso, la ubicación de los nodos y la edición en Nextcloud.
Rastrea un error en el protocolo de enlace de socket desde el navegador hasta coolwsd, y luego compara la ruta del proxy inverso con tu versión de Collabora, incluyendo el cambio de Apache CODE 26.04.
Detecta fallos en la prueba WOPI de Collabora debidos a claves que no coinciden, datos de descubrimiento obsoletos, desfase horario o cambios en la URL del proxy, sin debilitar la validación.
Restablezca el zoom del navegador, pruebe una sesión limpia e identifique cuándo un menú de tamaño con formato incorrecto necesita una actualización del servidor de Collabora.
Implemente Collabora CODE con Docker, conéctelo de forma segura a Nextcloud Office y verifique la edición de documentos con comprobaciones prácticas de WOPI y proxy.
Activa temporalmente el modo de depuración de coolwsd, captura un intento de apertura fallido y utiliza la secuencia de registros para separar los problemas de WebSocket, WOPI, proxy y contenedor.
Configure el inicio de sesión de administrador de Collabora Online para Docker o Linux, reinicie el servicio correspondiente y verifique la nueva contraseña sin exponerla.
