Cómo instalar Collabora Online CODE con Docker y Nextcloud

Ejemplo ilustrativo: Imagina un pequeño equipo cuyos archivos de Nextcloud están alojados en https://cloud.example.com. Su administrador desea un servidor independiente de Collabora Online Development Edition (CODE) en https://office.example.com. Esta es una configuración hipotética para explicar los pasos, no un informe de una instalación real. Reemplaza ambos nombres de host de ejemplo con dominios que controles.

CODE se ejecuta como un servicio independiente de Nextcloud. Docker inicia el servicio Collabora; un proxy inverso TLS lo publica; y la integración de Nextcloud Office conecta ambos. Su navegador debe poder acceder a la URL pública de la oficina, y los servidores deben poder acceder a los puntos finales correspondientes de Nextcloud y Collabora. El manual de instalación actual de Nextcloud Office describe Docker como una opción de implementación e indica que un servidor dedicado suele requerir un proxy inverso.

Antes de empezar

Por ejemplo, supongamos que un host Linux puede ejecutar Docker, Nextcloud ya funciona a través de HTTPS y los registros DNS de ambos nombres de host apuntan a los servidores correctos. Obtenga un certificado TLS válido para office.example.com. Planifique exponer el servicio Collabora a través de ese nombre de host, en lugar de abrir su puerto Docker directamente a internet.

  • Confirme que el host CODE puede resolver y conectarse a cloud.example.com.
  • Confirma que los navegadores pueden acceder https://office.example.coma través de HTTPS.
  • Elija si el proxy inverso se ejecuta en el host de Docker o en otro lugar. Un proxy en el mismo host puede usar un puerto de contenedor publicado mediante bucle invertido; un proxy en otro contenedor necesita una red compartida de Docker accesible u otra ruta privada.
  • Consulte la documentación actual de CODE y Nextcloud para conocer los requisitos de compatibilidad y proxy antes de su uso en producción. CODE es la edición para desarrollo; los equipos que necesiten estabilidad o soporte del proveedor deben evaluar una oferta de Collabora Online compatible.

Los comandos que se muestran a continuación utilizan el collabora/codenombre oficial de la imagen y un único origen de Nextcloud. Los ejemplos no especifican una etiqueta de lanzamiento, por lo que el administrador deberá definir una política de versiones y actualizaciones, en lugar de tratarlos latestcomo una estrategia de control de cambios para producción.

1. Apunte el nombre de host de la oficina a su servidor.

Cree un registro DNS A o AAAA que office.example.comapunte al host o balanceador de carga que aloja Collabora. Configure el proxy inverso para que finalice HTTPS con un certificado válido para ese nombre y reenvíe las rutas de la aplicación Collabora y el tráfico WebSocket al contenedor CODE. La documentación oficial de Collabora sobre el proxy inverso proporciona ejemplos específicos; consulte la sección correspondiente a su software de proxy y a la versión actual de CODE.

No copie un fragmento de proxy genérico sin más. El proxy debe admitir actualizaciones de WebSocket, conservar la información de host y protocolo reenviado requerida, y pasar rutas de Collabora como /browser, /hosting/discovery, y /cool. Las directivas exactas difieren entre Apache, NGINX, Traefik y otras pasarelas. Si el proxy se ejecuta en el host Docker, el reenvío a 127.0.0.1:9980es un destino privado común. Si es un contenedor separado, esa dirección de bucle invertido se refiere al propio contenedor del proxy, no al host CODE.

2. Inicie el contenedor Docker de CODE.

En el host de Docker, descargue e inicie el contenedor. En este ejemplo, el puerto está vinculado a la interfaz de bucle invertido, por lo que no está expuesto directamente en todas las interfaces de red del host:

docker pull collabora/code

docker run -d --name collabora   -p 127.0.0.1:9980:9980   -e 'aliasgroup1=https://cloud.example.com:443'   --restart always   --cap-add MKNOD   collabora/code

Este aliasgroup1valor autoriza el origen de Nextcloud que se espera que utilice este servicio CODE. Mantenga el esquema y el nombre de host alineados con la URL que los usuarios utilizan para acceder a Nextcloud; incluya un puerto distinto al predeterminado si el servicio público de Nextcloud utiliza uno. Si varias instancias de Nextcloud utilizarán el servicio, configure los grupos de hosts adicionales permitidos según la documentación de la imagen CODE actual, en lugar de permitir hosts arbitrarios de forma generalizada.

Este comando asume que el proxy inverso se encuentra en la misma máquina y reenvía el tráfico al puerto de bucle invertido. Si utiliza Docker Compose, un proxy en contenedores o un proxy remoto, ajuste la configuración de red y la exposición de puertos de forma adecuada. Evite exponer el puerto 9980 públicamente solo para que funcione la conexión del proxy; utilice una red privada de Docker, una regla de firewall u otra ruta restringida. Para conocer las opciones actuales de la imagen de Docker CODE, consulte la guía de Docker CODE de Collabora .

3. Configure el proxy inverso y verifique el CÓDIGO.

Una vez configurado el proxy, recárguelo utilizando el método correspondiente a su software y verifique su configuración antes de aplicar los cambios. A continuación, solicite el punto final de descubrimiento público desde una máquina que pueda acceder al dominio:

curl -fsS https://office.example.com/hosting/discovery | head

Una respuesta exitosa debería contener información de detección XML en lugar de una página de error de proxy. Esta verificación confirma que la URL pública llega a un punto final de Collabora; no prueba que la autorización de Nextcloud, los WebSockets o la edición de documentos funcionen correctamente. Además, inspeccione el contenedor si el punto final falla.

docker ps --filter name=collabora
docker logs --tail=100 collabora

En la configuración hipotética, una conexión rechazada a la URL pública apunta primero a problemas de DNS, TLS, cortafuegos o enrutamiento de proxy. Una respuesta 502 generalmente significa que el proxy no puede alcanzar el servidor ascendente configurado del contenedor. Si la detección funciona, pero el editor falla posteriormente durante la carga, verifique el reenvío de WebSocket y si el proxy informa de un error de actualización o de conexión ascendente.

4. Conectar Nextcloud con Collabora

En Nextcloud, abre el área de Aplicaciones e instala o habilita la integración de Office disponible para tu versión. La etiqueta de la aplicación puede ser "Nextcloud Office" o "Collabora Online", según la versión y el catálogo de aplicaciones instalado. Luego, abre la configuración de administración de Office e ingresa:

https://office.example.com

Guarda la configuración y revisa el estado de la conexión. La documentación de configuración de Nextcloud para Office identifica este campo como la URL y el puerto del servidor Collabora y recomienda HTTPS. Usa la URL pública de Collabora a la que pueden acceder los navegadores. En instalaciones con DNS dividido, NAT o redes segmentadas, Nextcloud también podría necesitar una ruta interna a ese servicio; consulta las opciones de conexión avanzadas de la versión de la aplicación instalada en lugar de asumir que el DNS público funciona desde el servidor.

Por ejemplo, Nextcloud considera cloud.example.comque el host WOPI permitido es , y los navegadores de los usuarios abren el editor desde office.example.com. Si su página de administración de Nextcloud ofrece una lista de permisos para solicitudes WOPI, restrinjala a las direcciones de servidor de Collabora esperadas tras confirmar las direcciones correctas en su red. Nextcloud recomienda limitar las solicitudes WOPI a los hosts de Collabora esperados; no agregue rangos amplios sin una razón específica de red.

5. Prueba con un documento de muestra.

Inicia sesión como usuario habitual de Nextcloud, crea un documento de texto breve o abre un archivo de prueba temporal y selecciona el editor del navegador. Confirma que se carga la barra de herramientas del editor, realiza un cambio sin consecuencias, espera a que aparezca el indicador de guardado, cierra el archivo y vuelve a abrirlo para verificar que el cambio se haya guardado. Si la instalación admite la edición simultánea, abre el mismo archivo de prueba en una segunda sesión de usuario y confirma que la presencia o las ediciones se actualizan correctamente.

Estas comprobaciones separan las capas principales: la solicitud de descubrimiento prueba el enrutamiento público; el estado de Nextcloud prueba la conexión con el servidor configurado; abrir el editor prueba el acceso al navegador y el intercambio WOPI; y volver a abrir el archivo prueba la ruta de guardado. No utilice un documento importante para la primera prueba. CODE es una edición de desarrollo, por lo que una prueba exitosa no sustituye la evaluación de la disponibilidad, la capacidad de recursos, las copias de seguridad y las necesidades de soporte de su organización.

Problemas comunes y qué revisar

Nextcloud informa que el servidor no está disponible.

Verifique que la URL de Office no contenga errores tipográficos, que la cadena de certificados sea válida y que el esquema HTTPS coincida. Pruebe la URL de descubrimiento tanto desde un navegador como desde el servidor Nextcloud. Si la resolución DNS pública es diferente dentro de la red del servidor, configure una ruta interna adecuada o utilice la configuración avanzada de URL del servidor compatible con su conector.

La página se abre, pero el editor de documentos se bloquea.

Inspeccione los registros de acceso y errores del proxy inverso para detectar fallos en la actualización de WebSocket. Confirme que el proxy reenvía las rutas actuales de Collabora y mantiene abiertas las conexiones WebSocket de larga duración. Las herramientas para desarrolladores del navegador pueden mostrar si la solicitud WebSocket se rechaza, se redirige a HTTP o se bloquea por un error de certificado.

Collabora rechaza el alojamiento de Nextcloud.

Compare el origen real de Nextcloud, incluyendo el esquema, el nombre de host y el puerto, con el grupo de alias configurado. Una discrepancia entre una URL pública, un nombre de host interno y una reescritura de proxy puede provocar fallos en la autorización del host o en WOPI. Añada únicamente el nombre de host de Nextcloud previsto a la configuración permitida.

El código se inicia y luego finaliza o deja de funcionar correctamente.

Revise docker logs collaborael espacio en disco y la memoria disponibles, los permisos del contenedor y los requisitos de tiempo de ejecución para la etiqueta de imagen que implementó. Evite copiar indicadores como el modo privilegiado de ejemplos no relacionados, a menos que las instrucciones oficiales vigentes para su entorno lo requieran.

Actualizaciones y atención operativa

Mantenga actualizada la imagen del contenedor para garantizar la seguridad y la compatibilidad, pero programe y pruebe las actualizaciones en lugar de descargar una imagen nueva sin revisar durante el horario laboral. Registre la versión que está utilizando, lea las notas de la versión correspondientes y mantenga un plan de reversión. Revise la configuración del proxy después de cambios importantes en Collabora o Nextcloud, ya que los requisitos de los puntos finales y WebSocket pueden evolucionar. Además, supervise la memoria, la CPU, el almacenamiento y los registros del contenedor del host a medida que aumenta el número de editores activos.

Para el equipo hipotético, la instalación estará lista para un uso limitado solo después de que el punto final de detección responda, Nextcloud informe de una conexión, el documento de muestra se abra en un navegador y se conserve la edición guardada tras volver a abrirlo. Si alguna de estas comprobaciones falla, solucione el problema en esa capa antes de permitir que los usuarios dependan del servicio.

Referencias oficiales

Documentación revisada el 6 de octubre de 2026. El manual estable de Nextcloud estaba etiquetado como versión 35 al consultarlo; el tutorial de Docker enlazado es la versión 28, así que úselo como ejemplo de instalación y verifique la sintaxis del proxy con la guía de Collabora y las versiones que realmente utiliza.

Dejar un comentario

Cómo mover una imagen en Microsoft Word

Cómo mover una imagen en Microsoft Word

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.

Cómo insertar una casilla de verificación en Excel: dos métodos sencillos

Cómo insertar una casilla de verificación en Excel: dos métodos sencillos

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.

Cómo autocompletar letras en Excel: de la A a la Z y más allá

Cómo autocompletar letras en Excel: de la A a la Z y más allá

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.

Cómo tachar texto en Excel: Atajos y métodos paso a paso

Cómo tachar texto en Excel: Atajos y métodos paso a paso

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.

¿Qué es Microsoft Access? ¿Cómo funcionan sus herramientas de base de datos?

¿Qué es Microsoft Access? ¿Cómo funcionan sus herramientas de base de datos?

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.

Importación y exportación de Office Outlook 2010: Transferencia de datos con un archivo PST

Importación y exportación de Office Outlook 2010: Transferencia de datos con un archivo PST

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.

Cambiar la altura y el ancho de las líneas de cuadrícula en Word 2010

Cambiar la altura y el ancho de las líneas de cuadrícula en Word 2010

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.

Recuperar una contraseña de Outlook PST con Nucleus Kernel

Recuperar una contraseña de Outlook PST con Nucleus Kernel

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.

Cómo insertar una página web en vivo en una diapositiva de PowerPoint

Cómo insertar una página web en vivo en una diapositiva de PowerPoint

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.

Agrega los días festivos nacionales a tu calendario de Outlook.

Agrega los días festivos nacionales a tu calendario de Outlook.

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.