Conecta Nextcloud con Collabora CODE ejecutando la collabora/codeimagen oficial, restringe su puerto al host, enruta un subdominio de oficina HTTPS a través de un proxy inverso compatible con WebSocket y configura esa URL pública en la integración de Nextcloud con Collabora. Diez minutos solo es posible si Docker, DNS, TLS y el proxy están listos.
Primero, elige el servicio de oficina adecuado. A partir de octubre de 2026, Nextcloud distingue su Nextcloud Office con tecnología Euro-Office de Collabora Online. CODE es Collabora Online Development Edition, por lo que debes usar la integración de Collabora, no el conector Euro-Office. La aplicación CODE integrada es la más rápida para uso personal, pero Nextcloud la describe como más lenta y con menos escalabilidad avanzada. Un contenedor independiente facilita la gestión, pero añade trabajo de proxy y actualización. CODE es ideal para uso doméstico y pruebas; elige una implementación de Collabora Online compatible cuando una empresa necesite soporte para producción.
Disponer de una dirección HTTPS de Nextcloud que funcione, un nombre de host de oficina independiente con TLS válido y acceso a Docker en el host de CODE. Configurar el nombre de host de la oficina para que apunte a un proxy inverso que pueda redirigir el tráfico al contenedor. Tanto los navegadores de los usuarios como el servidor de Nextcloud deben poder acceder a la URL de la oficina.
Si DNS o TLS no están listos, no exponga el puerto 9980 públicamente como acceso directo. Vincúlelo a la interfaz loopback y finalice primero la configuración del proxy.
Sustituya el nombre de host de Nextcloud de ejemplo por el origen HTTPS exacto que los usuarios utilizan para iniciar sesión. Esta aliasgroup1configuración restringe qué host de WOPI (el servicio de archivos que proporciona documentos al editor) puede conectarse. No utilice un comodín solo para ocultar una conexión fallida.
docker pull collabora/code
docker run -t -d --name collabora-code -p 127.0.0.1:9980:9980 -e 'aliasgroup1=https://cloud.example.com:443' --restart unless-stopped --cap-add MKNOD collabora/codeAl vincularlo, 127.0.0.1el puerto se mantiene privado mientras un proxy en el mismo host puede acceder a él. Si su proxy se encuentra en otra ubicación, permita que solo ese proxy de confianza se conecte al puerto 9980.
Compruebe que el contenedor se ha iniciado y que su punto final de detección responde localmente:
docker ps --filter name=collabora-code
docker logs --tail=50 collabora-code
curl -kfsS -o /dev/null -w 'Discovery HTTP %{http_code}\n' https://127.0.0.1:9980/hosting/discovery-kEsta función omite la validación del certificado únicamente para esta comprobación local autofirmada; no corrige un certificado público no válido.
Sirva https://office.example.comdesde su proxy inverso con un certificado válido y dirija las solicitudes a CODE. La guía de proxy de Collabora abarca los recursos del editor, el descubrimiento/las capacidades /cool/y el reenvío de WebSocket. Sin las actualizaciones de WebSocket, la página puede cargarse mientras el editor falla.
Utilice la configuración que mantiene su software proxy. Si finaliza TLS antes de CODE, siga la configuración TLS del backend documentada; no desactive las comprobaciones de certificados globalmente.
En Nextcloud, habilite o instale la aplicación de integración de Collabora disponible para su versión. Luego, abra el área de administración de Office e ingrese la URL pública de Collabora https://office.example.com. Los manuales actuales denominan la configuración "Servidor en línea de Collabora"; la redacción y las etiquetas de las aplicaciones pueden variar según la versión, especialmente a medida que Nextcloud agrega su opción Euro-Office. Seleccione Collabora Online para este servidor CODE. No ingrese la dirección exclusiva del contenedor https://127.0.0.1:9980a menos que Nextcloud se ejecute en el mismo host y esa dirección también sea el punto final del servicio configurado; en la configuración de proxy recomendada, use el nombre de host público de Office.
Guarda la configuración y ejecuta la comprobación de conexión integrada si tu versión la muestra. Si falla, compara el origen exacto de Nextcloud en aliasgroup1, confirma que tanto Nextcloud como el navegador pueden resolver y acceder al nombre de host de la oficina, e inspecciona los registros del proxy inverso en busca de rutas denegadas o errores de WebSocket.
Abra un documento de prueba pequeño en Nextcloud y confirme que se abre en el editor del navegador, acepta un cambio, se guarda y se vuelve a abrir con dicho cambio intacto. Realice la prueba tanto con una cuenta de usuario normal como con una cuenta de administrador. Una comprobación de detección que funcione correctamente confirma que CODE responde; no prueba que la autorización WOPI, los WebSockets proxy y las operaciones de guardado de documentos funcionen correctamente.
Para un servidor personal o un equipo pequeño, CODE Docker separa el editor de la pila PHP de Nextcloud. Además, usted controla el proxy, los reinicios, las comprobaciones de compatibilidad y las actualizaciones de imágenes. La aplicación CODE integrada es más sencilla, pero comparte el servidor y tiene menos opciones de escalabilidad. Para una organización que necesita editar a diario, es recomendable evaluar un servicio compatible de Collabora Online en lugar de considerar CODE como una garantía para entornos de producción.
Cuando esté listo para actualizar CODE, descargue la nueva imagen y vuelva a crear el contenedor con las mismas opciones. Revise las notas de la versión y pruebe la apertura y el guardado del documento antes de actualizar un servicio del que dependen los usuarios; la latestetiqueta puede cambiar. Fije una versión de imagen específica cuando las implementaciones repetibles sean importantes.
La configuración funciona correctamente cuando el nombre de host de la oficina pública presenta un certificado válido, la comprobación de conexión de Nextcloud se realiza correctamente y se abre, guarda y vuelve a abrir un documento de prueba a través del editor. Si la página de inicio de la oficina se carga pero la edición se bloquea, compruebe el reenvío de WebSocket. Si Nextcloud informa que el host no está permitido, corríjalo aliasgroup1para que coincida con el origen real de Nextcloud. Si CODE responde localmente pero no desde los navegadores de los usuarios, compruebe el DNS público, el enrutamiento del firewall y el proxy inverso.
Referencias: Ejemplo de instalación de Docker de Nextcloud ; Opciones de instalación de Nextcloud Office ; Configuración de Nextcloud Collabora ; Configuración del proxy inverso de Collabora ; Detalles de la imagen oficial de Docker de CODE ; Opciones de oficina de verano de Nextcloud Hub 26 .
Identificar los fallos de instalación de la App Store y determinar si se deben a problemas de DNS, HTTPS, proxy, TLS o configuración del propio servidor Nextcloud.
Traslada el trabajo de creación de miniaturas a una programación controlada en segundo plano, recorta los tamaños de vista previa no utilizados y verifica la cola sin sobrecargar tu servidor Nextcloud.
Localiza el archivo, la regla de exclusión, el problema de conexión o el estado de la base de datos del cliente que está impidiendo la sincronización de Nextcloud y, a continuación, verifica que las cargas y descargas se realicen de forma segura.
Encuentre el límite de PHP OPcache que activa la advertencia de Nextcloud, actualice la configuración web PHP correcta, reinicie de forma segura y verifique el resultado.
Compara el código integrado con el basado en Docker y, a continuación, conecta Collabora Online a Nextcloud mediante un proxy inverso HTTPS seguro.
Planifique una implementación confiable de Nextcloud HA con almacenamiento compartido, bloqueo de Redis, enrutamiento MariaDB con reconocimiento de quórum y comprobaciones prácticas de conmutación por error.
Configure y verifique un relé TURN accesible para Nextcloud Talk cuando los firewalls o la NAT restrictiva bloqueen los medios de llamada directa.
Utilice el informe de archivos no válidos para identificar código de Nextcloud modificado, faltante o adicional, restaurar archivos de confianza de forma segura y verificar el resultado.
Configura OAuth2 para Nextcloud Mail con Gmail o Microsoft 365, verifica la recepción y el envío, y resuelve los fallos comunes de consentimiento y SMTP.
Utilice OCC para restaurar el acceso a Nextcloud, verificar el estado de la migración de la base de datos y elegir el comando adecuado para las instalaciones de archivos, Docker o Snap.
