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.
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.
cloud.example.com.https://office.example.coma través de HTTPS.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.
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.
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/codeEste 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 .
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 | headUna 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 collaboraEn 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.
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.comGuarda 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.
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.
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.
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.
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.
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.
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.
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.
Instale Collabora Online CODE en Docker, publíquelo de forma segura a través de un proxy inverso, conéctelo a Nextcloud Office y verifique la edición de documentos basada en el navegador.
Diagnostica errores de memoria de ONLYOFFICE Docs en un VPS, comprueba los límites del host y de Docker, revisa los registros y los documentos olvidados, añade memoria de intercambio de forma segura y reinicia sin arriesgarte a perder las ediciones activas.
Solucione los problemas de copiar y pegar de Collabora Online con aplicaciones locales probando los atajos de teclado, los permisos del portapapeles del navegador, HTTPS, las políticas de iframe y los formatos de contenido.
Solucione el problema del texto borroso en los editores de escritorio de ONLYOFFICE en Linux comprobando el escalado de la pantalla, el escalado de la interfaz de la aplicación, la disponibilidad de la fuente y el ámbito de representación en un orden seguro.
Aprende a añadir controles de formulario de Writer, configurar etiquetas y el orden de tabulación, exportar con la opción Crear formulario PDF activada y probar tu PDF interactivo antes de compartirlo.
Aprenda cómo bloquear la impresión y las descargas en las integraciones de ONLYOFFICE Workspace, DocSpace o Docs, y verifique qué controles se aplican a cada método de uso compartido.
Solucione los errores 502 del servidor de documentos ONLYOFFICE detrás de Nginx. Verifique el estado del servicio, los registros, los puertos ascendentes, los encabezados reenviados, los WebSockets y la red de Docker.
Solucione los problemas de tiempo de espera de ONLYOFFICE Documents en un servidor autohospedado comprobando la URL correcta del portal o WebDAV, el acceso a la red, HTTPS, las credenciales y el enrutamiento del servidor.
Establezca una plantilla personalizada de LibreOffice Writer como predeterminada, actualícela o restablézcala y verifique que los nuevos documentos utilicen sus estilos y diseño de página preferidos.
Solucione los problemas de exportación de PDF de ONLYOFFICE separando los problemas de conversión, descarga del navegador y servidor, y luego verifique que el PDF guardado se abra y conserve su diseño.
