Conecta Nextcloud a un contenedor Collabora CODE autohospedado.

Para conectar Nextcloud con un contenedor de Collabora Online Development Edition (CODE) autohospedado, ejecute CODE en un nombre de host independiente, protéjalo mediante HTTPS e introduzca su URL pública en Nextcloud Office. El contenedor CODE también debe permitir el origen del sitio de Nextcloud como host WOPI. En el ejemplo siguiente, Nextcloud es cloud.example.comy Collabora es office.example.com; sustituya ambos por sus nombres de host reales.

¿Qué debes tener preparado antes de empezar?

Necesitas una instalación de Nextcloud en funcionamiento, un host Docker que pueda ejecutar el contenedor CODE, registros DNS para los nombres de host de Nextcloud y Collabora, y certificados HTTPS válidos para ambos sitios públicos. El host de Nextcloud y el servidor de Collabora deben poder comunicarse entre sí a través de la red. Un servidor Collabora dedicado está diseñado para mejorar la capacidad con respecto a la opción CODE integrada; sin embargo, se trata de la edición de desarrollo, por lo que debes consultar los términos y la guía de lanzamiento actuales de Collabora antes de usarlo para una implementación de mayor envergadura o crítica para el negocio.

Este tutorial asume que un proxy inverso se ejecuta en el host de Docker y reenvía el tráfico HTTPS office.example.comal puerto local del contenedor. Si su proxy se ejecuta en un contenedor diferente o en otra máquina, no copie la asignación del puerto de bucle invertido sin modificarla: utilice una red privada de Docker o una dirección de host privada a la que el proxy pueda acceder, y proteja el backend con un firewall para que no quede expuesto públicamente.

1. Iniciar el contenedor CODE

Primero, descarga la imagen e inicia un contenedor. En la configuración del alias, usa el origen público de Nextcloud, incluyendo el protocolo y el puerto. No incluyas la URL de Collabora. El ejemplo de instalación de Docker de Nextcloud utiliza este patrón:

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

La configuración de bucle invertido implica que el puerto 9980 solo es accesible desde el host de Docker, por ejemplo, mediante un proxy inverso en ese mismo host. El proxy proporciona a los navegadores y a Nextcloud un punto final HTTPS público, manteniendo el puerto del contenedor privado. Si Nextcloud se ejecuta en un puerto no estándar o a través de un nombre de host público diferente, asegúrese de que el alias coincida con el origen que utilizan los usuarios. Si tiene varias instancias de Nextcloud, configure cada host WOPI permitido utilizando la sintaxis documentada de Collabora, en lugar de permitir dominios arbitrarios de forma generalizada.

El comando anterior sigue el ejemplo de Docker del manual de administración de Nextcloud 35. Antes de usarlo en producción, revise la documentación de la imagen CODE actual y elija una política de actualización de versiones/etiquetas que se ajuste a su proceso de mantenimiento. La referencia de la imagen predeterminada puede cambiar a medida que se publican versiones; planifique las actualizaciones, supervise el contenedor y vuelva a probar la edición de la documentación después de las actualizaciones.

2. Coloca el contenedor detrás del proxy inverso HTTPS.

Configure su proxy existente para servir https://office.example.comy reenviar solicitudes al servicio CODE en 127.0.0.1:9980. Use la configuración de proxy inverso actual de Collabora para su software de proxy. El proxy debe conservar las rutas requeridas y admitir actualizaciones de WebSocket; la sesión del navegador del editor depende de ellas. El ejemplo de Docker de Nextcloud incluye rutas para /browser, /hosting/discovery, /hosting/capabilities, y /cool, incluido el punto final de WebSocket. Algunas integraciones también usan la /loolruta de compatibilidad.

No considere que la carga exitosa de la página de inicio sea prueba de que el proxy está completo. Un proxy que maneja solicitudes HTTPS normales pero no actualiza las conexiones WebSocket puede mostrar el marco del editor y luego dejarlo cargando o desconectado. Use un certificado público válido para el nombre de host de Collabora. Mantenga el puerto 9980 cerrado a internet cuando el proxy sea el único punto de entrada.

3. Habilite Nextcloud Office e introduzca la URL del servidor.

En Nextcloud, abre Aplicaciones e instala o habilita Nextcloud Office (la richdocumentsintegración). Luego, abre Configuración de administración → Office , selecciona la opción de servidor externo de Collabora e ingresa https://office.example.com. Guarda la configuración. Usa la URL pública, no localhost:9980: el servidor de Nextcloud y los navegadores de los usuarios deben resolver el mismo punto final externo de Collabora.

El manual de administración de Nextcloud indica que la URL del servidor configurada debe usar el mismo protocolo que la instalación de Collabora y recomienda HTTPS. Tras guardar, Nextcloud podría mostrar un estado de conectividad o detección. Si informa de un problema con el certificado, el DNS o WOPI, solucione esa comprobación específica antes de intentar abrir un archivo.

4. Compruebe la ruta WOPI y abra un documento de prueba.

WOPI es el protocolo que Nextcloud utiliza para otorgar a Collabora acceso controlado a un documento. En la configuración de administración de Office de Nextcloud, revise la lista de permisos para las solicitudes WOPI y restrinja las solicitudes a las direcciones IP desde las que su servicio Collabora se conecta a Nextcloud. Configure también Collabora para que solo acepte el host WOPI previsto. La dirección exacta puede variar cuando intervienen contenedores, NAT o un proxy inverso, por lo que debe usar la dirección de origen que Nextcloud registra en lugar de intentar adivinarla.

Para comprobar su funcionamiento, inicie sesión como usuario habitual de Nextcloud, cree o cargue un archivo DOCX u ODT pequeño y ábralo desde Archivos. Confirme que el editor se carga, realice un cambio sencillo, espere a que aparezca el indicador de guardado, cierre el documento, vuelva a abrirlo y confirme que el cambio se mantiene. Pruebe con cada tipo de archivo y grupo de usuarios relevante para su implementación; una prueba exitosa con un archivo DOCX no garantiza que todos los formatos o permisos estén configurados correctamente.

¿Qué debes comprobar si el editor no se abre?

• Error de descubrimiento o conexión: Confirme que office.example.comse resuelve desde el servidor Nextcloud y el navegador, que su certificado es válido y que el proxy envía /hosting/discoverya CODE.
• Carga interminable o editor desconectado: compruebe la gestión de actualizaciones de WebSocket del proxy inverso y las /coolrutas. Revise los registros del proxy y del contenedor en busca de solicitudes rechazadas.
• Host WOPI rechazado: Compare la configuración aliasgroup1con el origen público exacto de Nextcloud, incluyendo el esquema y el puerto. Verifique la lista de permisos WOPI de Nextcloud con la IP de origen de Collabora visible para Nextcloud.
• Funciona en el host pero no en Nextcloud: Pruebe la conectividad desde el servidor Nextcloud a la URL pública de Collabora. El nombre de host interno de un contenedor o la dirección localhost del host Docker no son automáticamente accesibles desde cualquier otro contenedor.
• Advertencia sobre el certificado: Corrija la discrepancia en la cadena de certificados o el nombre de host. Deshabilitar la verificación del certificado puede ocultar la causa y debilitar la conexión.

Para el diagnóstico, compare su configuración con el ejemplo oficial de instalación de Docker de Nextcloud , su guía de configuración de Office y WOPI , y la documentación de la imagen Docker CODE y el proxy inverso de Collabora . Estas referencias están versionadas y pueden cambiar; los comandos aquí mostrados corresponden al ejemplo de administración de Nextcloud 35 disponible el 10 de octubre de 2026.