La integración de Collabora Online con ownCloud Infinite Scale (oCIS) es una integración WOPI, diferente a la configuración utilizada por ownCloud Classic. WOPI, o Interfaz de Plataforma Abierta para Aplicaciones Web, es el protocolo que permite que una suite ofimática en línea solicite un archivo a una plataforma de almacenamiento, lo edite en el navegador y guarde el resultado.
Esta distinción es importante porque las implementaciones actuales de Infinite Scale utilizan el servicio de colaboración integrado como puente entre oCIS y Collabora. No es necesario instalar la antigua aplicación ownCloud Classic Collabora ni configurarla para que apunte a una URL de servidor. La aplicación de oficina se registra a través de los servicios de colaboración y registro de aplicaciones. La documentación oficial de ownCloud WOPI incluye a Collabora como una aplicación de oficina compatible, mientras que la documentación del servicio de colaboración explica el servicio y su configuración necesaria.
A partir de octubre de 2026, las versiones oficiales de ownCloud en GitHub incluyen Infinite Scale 8.2.0, publicada el 10 de agosto de 2026. El ejemplo de implementación del proyecto puede evolucionar de forma independiente, por lo que se recomienda usar una etiqueta de producción probada en lugar de asumir que una imagen de actualización continua es apropiada. El ejemplo de implementación completa oficial de oCIS recomienda actualmente la etiqueta Collabora CODE 26.04.3.1.1en su archivo de entorno. Consulte las versiones oficiales de Infinite Scale y el archivo de entorno del ejemplo de implementación oficial antes de fijar versiones.
Una integración en producción normalmente implica tres puntos finales lógicos:
| Punto final | Objetivo | Ejemplo |
|---|---|---|
| Escala infinita | API web y de almacenamiento de ownCloud orientadas al usuario | https://cloud.example.com |
| Colabora en línea | Editor de navegador y cliente WOPI | https://office.example.com |
| Servicio de colaboración/WOPI | Puente a través del cual Collabora lee y escribe archivos oCIS | URL de servicio interna o nombre de host WOPI enrutado externamente, según la topología. |
Verificado: COLLABORATION_APP_ADDR es la URL de Collabora e COLLABORATION_WOPI_SRCidentifica la fuente WOPI utilizada por la aplicación de oficina. Depende del entorno: la fuente WOPI no tiene por qué ser un nombre de host público independiente cuando Collabora y el servicio de colaboración comparten una red de contenedores de confianza. El ejemplo oficial actual de Compose utiliza http://collaboration:9300internamente. Una implementación independiente puede requerir un nombre de host WOPI HTTPS enrutado.
Acción útil: defina su topología antes de copiar los valores de configuración. Si todos los componentes se ejecutan en una pila oficial de Compose, comience con ese ejemplo. Si Collabora se encuentra en otro host o clúster de Kubernetes, documente qué nombre DNS puede resolver y alcanzar cada lado.
Antes de modificar la configuración de oCIS, asegúrese de que los nombres de ownCloud y Collabora se resuelvan correctamente y de que Collabora exponga su punto final de descubrimiento. Collabora publica las capacidades de WOPI a través de /hosting/discovery. Una comprobación básica es:
dig +short cloud.example.com
dig +short office.example.com
curl -fsS https://office.example.com/hosting/discovery | headDebería recibir XML del punto final de descubrimiento. Si TLS finaliza en un proxy inverso, confirme que el certificado presentado office.example.comsea válido desde la perspectiva del host o la red de contenedores de oCIS.
Leyenda: Compruebe la resolución de nombres y el /hosting/discoverypunto final de Collabora antes de depurar el registro WOPI dentro de Infinite Scale.
Un error común: ver la página de inicio de Collabora en un navegador no demuestra que la integración con WOPI funcione. Demuestra que el punto final web es accesible. El servicio de colaboración también debe poder acceder a Collabora, y Collabora debe poder acceder a la fuente WOPI.
Acción útil: ejecutar pruebas de conectividad desde el mismo espacio de nombres de red que el servicio correspondiente; por ejemplo, desde dentro del contenedor de colaboración cuando se utiliza Docker.
El servicio de colaboración no se inicia automáticamente con una ocis serverconfiguración genérica en modo supervisado. La documentación de ownCloud indica que debe iniciarse explícitamente, ya que los administradores pueden ejecutar más de una instancia del servicio de colaboración para diferentes productos de Office.
Los ajustes importantes para Collabora son:
COLLABORATION_APP_NAME=CollaboraOnline
COLLABORATION_APP_PRODUCT=Collabora
COLLABORATION_APP_ADDR=https://office.example.com
COLLABORATION_WOPI_SRC=http://collaboration:9300
OCIS_URL=https://cloud.example.comEl código fuente WOPI anterior coincide exactamente con la topología utilizada en el ejemplo oficial de Compose: Collabora y el servicio de colaboración comparten la misma red Docker. Si su servidor Collabora es externo, reemplace la URL interna con la dirección a la que Collabora puede acceder.
El servicio también depende de la infraestructura de puerta de enlace y proveedor de aplicaciones de Infinite Scale. En una implementación de contenedor dividido, la documentación de ownCloud advierte específicamente que la configuración de oCIS debe compartirse con el contenedor de colaboración porque se requieren secretos generados en todos los servicios. Consulte la definición oficial actual de Collabora Compose .
Leyenda: Un proceso de servicio de colaboración debe comenzar con la dirección de Collabora y la fuente WOPI previstas; utilice los registros de servicio reales para confirmar los valores en su implementación.
Acción útil: si configuraste el despliegue manualmente, compara tu entorno con el oficial collabora.ymlen lugar de copiar la configuración de un tutorial antiguo de cs3org/wopiserver.
Collabora debe confiar en el host WOPI y tener permiso para renderizarse dentro de la página web de ownCloud. El ejemplo oficial de oCIS Compose pasa a Collabora opciones que finalizan TLS en el proxy inverso y se establecen net.frame_ancestorsen el dominio de oCIS. También genera una clave de prueba WOPI antes de iniciar Collabora.
En el ejemplo oficial, los valores relevantes del lado de Collabora incluyen:
DONT_GEN_SSL_CERT=YES
extra_params:
--o:ssl.enable=...
--o:ssl.ssl_verification=...
--o:ssl.termination=true
--o:welcome.enable=false
--o:net.frame_ancestors=cloud.example.comLas opciones exactas de SSL dependen de dónde finalice TLS. La configuración recomendada para el acceso a Internet es HTTPS con verificación de certificado habilitada. La INSECURE=trueopción del ejemplo existe para configuraciones locales que utilizan certificados autofirmados; la guía de implementación de ownCloud indica explícitamente a los administradores que la eliminen o la desactiven para servidores públicos.
Leyenda: Un punto final de Collabora accesible es un requisito previo; las implementaciones en producción deben exponerlo a través de HTTPS con un certificado de confianza para los demás componentes.
Acción útil: si al cargar el documento aparece un iframe en blanco o un error de CSP, revise las herramientas para desarrolladores del navegador y los encabezados del proxy inverso. No desactive la verificación de certificados ni las restricciones de seguridad de contenido de forma generalizada solo para que la página se cargue.
El servicio de registro de aplicaciones de Infinite Scale decide qué aplicación puede abrir cada tipo MIME. Su configuración permite definir el tipo MIME, la extensión, el icono, la aplicación predeterminada y si los usuarios pueden crear nuevos archivos de ese tipo. La documentación oficial del Registro de aplicaciones describe estos campos.
Un detalle clave es que el nombre de la aplicación que usa el registro debe corresponder al proveedor de colaboración que usted registró. Los ejemplos de implementación oficiales actuales de Collabora usan CollaboraOnlinecomo nombre del producto. No combine nombres copiados de ejemplos anteriores sin verificar la versión de implementación.COLLABORATION_APP_NAMECollabora
Tras el inicio, inicia sesión en ownCloud Web y abre un documento de Office compatible. Un proceso exitoso se ve así:
Leyenda: La prueba final consiste en abrir un documento de Office real desde ownCloud Web, editarlo en Collabora, cerrarlo y confirmar que la versión guardada vuelve a ser visible en Infinite Scale.
Acción útil: realice un pequeño cambio en un documento de prueba desechable, cierre el editor, vuelva a abrir el archivo y verifique que el cambio se haya guardado. Una página que simplemente carga el editor no constituye una prueba completa de la ruta de escritura.
Para una implementación convencional de Docker, la opción de menor riesgo es ocis_fullel ejemplo mantenido por ownCloud. Incluye Infinite Scale, el servicio de colaboración Collabora y Traefik. La guía oficial indica que la implementación requiere dominios para oCIS y Collabora, y documenta el componente WOPI como parte de la pila. Consulte la guía de implementación completa oficial .
Un archivo de entorno típico orientado a la producción incluye valores conceptualmente como:
OCIS_DOCKER_IMAGE=owncloud/ocis
OCIS_DOCKER_TAG=<tested-production-version>
OCIS_DOMAIN=cloud.example.com
COLLABORA=:collabora.yml
COLLABORA_DOCKER_TAG=<tested-collabora-version>
COLLABORA_DOMAIN=office.example.com
INSECURE=falseLuego, inicie la pila con:
docker compose pull
docker compose up -d
docker compose psVerificado: el ejemplo oficial actual de proxy inverso permite el uso de barras diagonales, signos de interrogación y caracteres de porcentaje codificados en el punto de entrada HTTPS, ya que Collabora/Collabora los requiere. Dependencia del entorno: si utiliza Nginx, HAProxy, un controlador de entrada o un balanceador de carga en la nube en lugar de Traefik, debe reproducir el manejo de URL, el comportamiento de WebSocket/proxy, los certificados y los tiempos de espera necesarios en esa plataforma.
Acción útil: no traduzca literalmente las etiquetas de Traefik a otro proxy. Úselas para comprender los requisitos de enrutamiento y luego implemente esos requisitos utilizando la sintaxis documentada de su proxy.
| Síntoma | Área probable | Comprobar siguiente |
|---|---|---|
| No hay opción de oficina para DOCX/ODT | Registro de aplicaciones / registro de proveedores | Confirme que el servicio de colaboración esté registrado y que el tipo MIME apunte al nombre correcto de la aplicación. |
| La página de Collabora funciona, pero el documento no se abre. | Accesibilidad de WOPI | Verifique que Collabora pueda acceder COLLABORATION_WOPI_SRCa los registros de colaboración e inspeccionarlos. |
| Marco en blanco o error CSP del navegador | Configuración de trama/CSP | Verifique frame_ancestorsla política de privacidad de oCIS y el origen real utilizado por el navegador. |
| Error de TLS o certificado | Proxy inverso / cadena de confianza | Utilice certificados válidos en producción y pruebe HTTPS desde los contenedores de servicio, no solo desde su estación de trabajo. |
| El editor se abre pero falla al guardar. | Ruta de escritura WOPI / secretos compartidos | Inspeccione los registros de colaboración y Collabora y confirme que la configuración compartida de oCIS esté montada donde sea necesario. |
| Un archivo se abre inesperadamente en varias suites ofimáticas. | Integraciones con múltiples oficinas | Actualmente, el archivo de entorno oficial advierte sobre los riesgos de habilitar aplicaciones de Office superpuestas, ya que no está disponible la interconexión de aplicaciones en el mismo archivo. |
Dato conocido: Infinite Scale es compatible con Collabora a través de WOPI, el servicio de colaboración integrado es el puente actual, y la implementación completa oficial proporciona una arquitectura de referencia funcional.
Depende de su entorno: si el punto final de WOPI es una URL de contenedor interna o un nombre de host público, dónde termina TLS, qué proxy utiliza y si Collabora se ejecuta en la misma red que oCIS.
No dé por sentado que las instrucciones para ownCloud Classic se aplican a Infinite Scale. La documentación de Classic que le indica que instale una aplicación Collabora/richdocuments o que la configure a través de la interfaz de administración de Classic describe una arquitectura de producto diferente.
Por lo tanto, el flujo de trabajo de integración más fiable es el siguiente: partir del modelo de implementación oficial de Infinite Scale, comprobar la accesibilidad de la red y TLS, configurar el servicio de colaboración, confirmar que Collabora confía en el host WOPI y puede acceder a él, registrar los tipos MIME pertinentes y, finalmente, probar la apertura y el guardado de un documento real.
Aprende a arrastrar una imagen en Word, a elegir el ajuste de texto, a mantenerla dentro de un párrafo o a fijarla en la página, y a solucionar problemas con imágenes que no se mueven.
Aprende a insertar una casilla de verificación en Excel con la herramienta "En celda", a contar los elementos seleccionados con fórmulas o a agregar un control de formulario vinculado en versiones de escritorio anteriores.
Genere letras de la A a la Z, letras minúsculas o etiquetas más allá de la Z en Excel con una fórmula de controlador de relleno, una SECUENCIA o una lista personalizada reutilizable.
Aprende a tachar texto en Excel para Windows, Mac y la web, a dar formato a parte de una celda y a eliminar la línea sin borrar su valor.
Microsoft Access es una aplicación de base de datos para Windows que permite almacenar registros relacionados, crear consultas, generar formularios de entrada de datos y crear informes. Descubra cómo funciona y cuándo es la opción más adecuada.
Aprende a importar un archivo PST a Outlook 2010 o a exportar correo electrónico, contactos, calendario y tareas. Sigue los menús correctos y evita carpetas faltantes o duplicadas.
Aprenda a ajustar la altura y el ancho de las líneas de cuadrícula en Word 2010, cambiar la frecuencia de las líneas visibles y establecer el espaciado horizontal y vertical subyacente de la cuadrícula de dibujo.
Recupere una contraseña olvidada de un archivo PST de Outlook siguiendo los pasos actuales de Kernel, que incluyen cómo identificar el archivo correcto, realizar una copia de seguridad y comprobar los límites de la herramienta.
Utilice el complemento LiveWeb para insertar un sitio web en una diapositiva de PowerPoint, configurar su tamaño y comportamiento de actualización, y comprobar la compatibilidad antes de la presentación.
Agregue días festivos específicos de cada país en la nueva versión de Outlook, Outlook en la web o la versión clásica de Outlook. Aprenda cómo evitar eventos duplicados y compruebe si faltan fechas de 2026-2027.
