Technical Anshu
Tutorials Blog
📄 Configuración de OnlyOffice + Nextcloud

Instale OnlyOffice Document Server y conéctelo a Nextcloud

Su Nextcloud almacena los archivos pero no puede editar los documentos correctamente. OnlyOffice Document Server es el motor de edición que falta: aquí está la instalación completa de Docker más la configuración del conector que une los dos, con el único error de clave secreta que arruina la mayoría de los primeros intentos.

✍️ Technical Anshu🐧 Linux Server + Docker⏱️ One sitting setup
🎥 Mira el proceso completo de instalación e integración en el vídeo de arriba, paso a paso

Nextcloud por sí solo le brinda almacenamiento y uso compartido, pero abrir un archivo de Word o Excel dentro necesita un editor real. Ese editor es el OnlyOffice Document Server, un segundo servicio que usted mismo aloja y con el que Nextcloud se comunica a través de una pequeña aplicación de conector. Esta guía sigue la ruta exacta del vídeo: instale Document Server con Docker y luego conéctelo a Nextcloud. Una advertencia honesta antes de comenzar: Document Server es un servicio pesado, no un complemento pequeño. Dale un servidor adecuado y su propia dirección, y el resto de esta página funcionará sin problemas.

Nextcloud — Settings — ONLYOFFICE (connector app)
Document Server addresshttps://office.example.com
Secret keymust match JWT_SECRET on the server
Connection check on SaveOK
Editor opens inside NextcloudDocs, Sheets, Slides
El panel de configuración del conector dentro de Nextcloud: valores ilustrativos que se muestran como ejemplo.
1

Primero comprenda las dos piezas

Hay dos servidores separados en esta configuración y la mayor confusión surge al mezclarlos. Nextcloud almacena sus archivos, usuarios y recursos compartidos; nunca edita un documento. El OnlyOffice Document Server (también llamado OnlyOffice Docs) es el motor de edición: representa el editor de documentos en el navegador, aplica cada pulsación de tecla y envía el archivo terminado a Nextcloud para guardarlo.

La aplicación de conector dentro de Nextcloud es el puente entre ellos. Le dice a Nextcloud dónde vive el Document Server y demuestra, con una clave secreta compartida, que los dos servidores pueden comunicarse entre sí. Cuando un usuario hace clic en un archivo de Word o Excel, el editor realmente se carga desde Document Server mientras el archivo permanece almacenado en Nextcloud.

2

Dé al Document Server su propia dirección

El Document Server necesita su propio subdominio o dirección de servidor, por ejemplo office.example.com, separado de su dirección de Nextcloud como cloud.example.com. Primero cree el registro DNS y déjelo que apunte a la máquina que ejecutará OnlyOffice. Intentar ocultar ambos servicios bajo una dirección con rutas es donde la mayoría de las primeras instalaciones se atascan, así que manténgalo simple: un nombre para Nextcloud, un nombre para Document Server.

3

Instalar el servidor de documentos con Docker

La ruta que se muestra en el vídeo es la instalación de Docker en un servidor Linux, que también es la ruta que OnlyOffice documenta oficialmente. Un comando inicia todo:

  1. Asegúrese de que Docker esté instalado y ejecutándose en el servidor
  2. Elija un secreto largo y aleatorio: se convertirá en la clave compartida entre los dos servidores.
  3. Ejecute el contenedor con su conjunto secreto explícitamente:

sudo docker run -i -t -d -p 80:80 --restart=always -e JWT_SECRET=your-own-secret-here -v /app/onlyoffice/logs:/var/log/onlyoffice -v /app/onlyoffice/data:/var/www/onlyoffice/Data -v /app/onlyoffice/lib:/var/lib/onlyoffice onlyoffice/documentserver

Configurar JWT_SECRET usted mismo no es una decoración opcional. Si lo omite, el contenedor genera un secreto aleatorio y, desde la versión 7.2, ese secreto se regenera en cada reinicio, lo que interrumpe silenciosamente la conexión de Nextcloud después del primer reinicio. Los tres montajes de volumen -v mantienen registros, certificados y caché fuera del contenedor para que una actualización no los borre.

4

Compruebe que el servidor de documentos esté activo

Espere un par de minutos para que el contenedor se inicie y luego abra http://office.example.com en un navegador. Debería ver la página de bienvenida de OnlyOffice Docs confirmando que los servicios se están ejecutando. También puede verificar el servidor con sudo docker ps; el contenedor onlyoffice/documentserver debe aparecer como activo. No pase a Nextcloud hasta que se cargue esta página; conectar un servidor inactivo sólo crea errores confusos más adelante.

5

Instale la aplicación Connector en Nextcloud

Ahora cambie a Nextcloud. Inicie sesión como administrador, abra la sección Aplicaciones, busque ONLYOFFICE e instale y habilite la aplicación del conector oficial. Esta aplicación es gratuita y está publicada en la tienda de aplicaciones de Nextcloud; no hay nada que cargar manualmente.

6

Ingrese la dirección y la clave secreta

Abra Configuración → ONLYOFFICE en Nextcloud y complete dos cosas:

  1. Dirección de Document Server: la dirección del paso 2, por ejemplo https://office.example.com
  2. Clave secreta: exactamente el mismo valor que pasó como JWT_SECRET al iniciar el contenedor. Un carácter diferente y la conexión es rechazada.
  3. Presione Guardar: el conector prueba inmediatamente la conexión e informa si se realizó correctamente.

Si el guardado tiene éxito, la integración está activa. Si falla, el mensaje de error le indica qué lado debe investigar: un problema de dirección o una discrepancia secreta (el error JWT tiene su propia guía detallada vinculada desde nuestras páginas de casos).

7

Abra un documento y pruebe una edición real

Termine con una prueba real, no solo con una marca verde. Cargue un archivo de Word o Excel a Nextcloud, haga clic en él y confirme que se abra el editor OnlyOffice. Escriba algo, cierre el documento, espere unos segundos hasta que se complete el guardado y descargue el archivo para verificar que la edición esté dentro. Intente también abrir el mismo documento en un segundo perfil de navegador; la coedición debería mostrar ambos cursores. Si todo eso funciona, su oficina autohospedada está lista para el equipo.

🔴 Toda la integración se basa en un secreto. El JWT_SECRET en el comando Docker y la clave secreta en la configuración del conector de Nextcloud deben ser idénticos, carácter por carácter. La falta de coincidencia es la razón número uno por la que una instalación nueva se niega a conectarse, y si deja que el contenedor genere un secreto aleatorio en lugar de configurar el suyo propio, la conexión se interrumpirá por sí sola en el próximo reinicio del servidor.

🎥 Mira la configuración completa en el vídeo

La instalación completa de OnlyOffice Document Server y la integración de Nextcloud, mostradas en vivo paso a paso.

▶️ Watch Full Video
❓ Preguntas comunes (FAQ)

¿OnlyOffice Document Server es gratuito para autohospedarse?

La edición comunitaria de OnlyOffice Docs y la aplicación del conector Nextcloud se pueden instalar y utilizar de forma gratuita. La edición gratuita está diseñada para equipos pequeños y tiene límites en comparación con las ediciones empresariales pagas; consulte la página de límites actuales de su versión antes de planificar una implementación grande.

¿Se pueden ejecutar OnlyOffice y Nextcloud en el mismo servidor?

Sí, muchas configuraciones pequeñas se ejecutan en una sola máquina, con Document Server en Docker y su propio subdominio. Sólo recuerde que Document Server consume muchos recursos: la máquina necesita suficiente RAM y CPU de repuesto para ambos servicios, o la edición resultará lenta para todos.

¿Por qué el conector pide una clave secreta?

El secreto firma las solicitudes entre Nextcloud y Document Server (JWT), por lo que un sitio web aleatorio no puede pedirle a su Document Server que abra o convierta archivos. Ambas partes deben guardar el mismo secreto: ese valor compartido es lo que demuestra que los dos servidores confían entre sí.

Esta guía se basa en el vídeo técnico de Anshu sobre la instalación de OnlyOffice Document Server con Nextcloud • ¿Atascado en un paso? Pregunte en los comentarios del video; allí obtendrá una respuesta 🙏