Abres un archivo DOCX en Nextcloud, ONLYOFFICE se carga con normalidad, realizas un cambio y, a continuación, el editor informa: «No se pudo guardar el documento». La conclusión tentadora es que el navegador perdió el archivo o que ONLYOFFICE no puede escribir en el disco. En una integración con Nextcloud, ese suele ser un punto de partida erróneo.
El detalle importante es cómo funciona el guardado. Nextcloud proporciona a ONLYOFFICE Docs una URL de documento y un identificador callbackUrl. ONLYOFFICE descarga el archivo, aloja la sesión de edición y, posteriormente, llama a Nextcloud para que este pueda obtener el archivo actualizado y reemplazar la versión almacenada. La documentación oficial de integración de ONLYOFFICE describe explícitamente este intercambio de llamadas. Esto significa que el editor puede abrirse correctamente aunque la ruta de retorno utilizada para guardar esté rota. Acción: tratar la apertura y el guardado como dos pruebas de red independientes.
Según la documentación oficial de integración vigente, el conector de ONLYOFFICE para Nextcloud utiliza un flujo de trabajo de servidor a servidor: Nextcloud debe ser accesible desde el servidor de documentos, y Nextcloud también debe ser accesible desde el servidor de documentos. Al finalizar la edición, ONLYOFFICE envía una solicitud POST a la URL de devolución de llamada; Nextcloud descarga el documento editado y reemplaza la versión anterior. Consulte la guía oficial de integración de ONLYOFFICE con Nextcloud y la descripción de la API de ONLYOFFICE para la integración con Nextcloud .
Verificado: una ruta de devolución de llamada incorrecta o inaccesible puede provocar un error al guardar, incluso con el editor abierto. La documentación de solución de problemas de ONLYOFFICE indica específicamente a los administradores que revisen los registros de DocService y verifiquen que la URL de devolución de llamada sea accesible cuando se produzca un error al guardar. Acción: no reinstale el editor ni borre la caché del navegador; primero pruebe la ruta de servidor a servidor.
En el host de Nextcloud, ejecute la comprobación del conector ONLYOFFICE como usuario del servidor web. En una instalación típica de Debian o Ubuntu:
cd /var/www/nextcloud
sudo -E -u www-data php occ onlyoffice:documentserver --checkLa ruta exacta de Nextcloud y el usuario HTTP pueden variar según la distribución o la configuración del contenedor. El manual de administración de Nextcloud recomienda ejecutarlo occcomo el usuario HTTP para que la propiedad de los archivos se mantenga constante. ONLYOFFICE documenta occ onlyoffice:documentserver --checkla prueba de conexión del conector.
Lo que esto demuestra: puede revelar un error obvio de configuración o conectividad del servidor de documentos. Lo que no demuestra: todas las devoluciones de llamada generadas durante una sesión de edición real se ejecutarán correctamente a través de todos los proxies, rutas DNS y capas de autenticación. Acción: si la verificación se realiza correctamente pero el guardado sigue fallando, continúe con la devolución de llamada y los registros en lugar de declarar que la integración funciona correctamente.
En Nextcloud, abre Configuración → Administración → ONLYOFFICE . La dirección principal de ONLYOFFICE Docs debe ser accesible para los clientes y servicios correspondientes. Si las URL públicas no son accesibles internamente debido a la configuración de red de Docker, NAT, DNS de horizonte dividido o política de firewall, expande la configuración avanzada del servidor.
El conector oficial expone direcciones internas separadas precisamente para esta situación:
Por ejemplo, dos contenedores en la misma red Compose pueden usar nombres de servicio internamente, mientras que los navegadores siguen usando nombres de host HTTPS públicos. No copie este patrón sin más: los nombres deben resolverse correctamente en su red. Acción: pruebe cada dirección desde la máquina o el contenedor que origina la solicitud.
Esa conclusión no es fiable. El navegador, Nextcloud y ONLYOFFICE Docs son tres participantes de red distintos. El navegador puede acceder a la dirección IP office.example.com, mientras que el contenedor del servidor de documentos no puede resolverla ni conectarse a ella cloud.example.com. Del mismo modo, Nextcloud puede acceder a ONLYOFFICE mediante un nombre de host interno, mientras que la devolución de llamada apunta a una dirección pública inaccesible.
Acción: acceda al contenedor o host de ONLYOFFICE y compruebe la dirección de Nextcloud que se espera que utilice. Una solicitud HTTPS básica al host de Nextcloud puede confirmar la accesibilidad DNS/TCP/TLS, pero recuerde que una status.phpsolicitud exitosa no valida la autorización de devolución de llamada real ni el manejo de POST.
JWT es otra fuente frecuente de confusión. A partir de ONLYOFFICE Docs 7.2, JWT está habilitado por defecto y se genera automáticamente una clave secreta. Las instrucciones oficiales requieren la misma clave secreta tanto en el servidor de documentos como en el conector de Nextcloud ONLYOFFICE. La documentación actual del conector también muestra la configuración del encabezado de autorización para las instalaciones que no utilizan el encabezado predeterminado.
Verificado: el secreto compartido debe coincidir. Dependiente de la implementación: el lugar exacto donde se administra depende de si ONLYOFFICE se instala desde paquetes, en Windows o en Docker. En las implementaciones de Docker, JWT_SECRETse suele utilizar una variable de entorno; la configuración efectiva del servidor también se puede inspeccionar en /etc/onlyoffice/documentserver/local.json.
Acción: compare la configuración efectiva de la clave secreta y la cabecera en ambos lados y, a continuación, reinicie los servicios de ONLYOFFICE o el contenedor tras realizar los cambios en el servidor. No solucione el problema desactivando JWT de forma permanente; esto elimina un control de seguridad en lugar de corregir la configuración. Encontrará más detalles en la guía de configuración de JWT de ONLYOFFICE .
ONLYOFFICE recomienda revisar los registros de DocService para detectar errores al guardar. Para instalaciones de Linux y Docker, los registros del servidor de documentos se encuentran en /var/log/onlyoffice/documentserver; los usuarios de Docker también pueden seguir la salida del contenedor con docker logs -f <container>. Si se necesita más detalle, ONLYOFFICE documenta un modo de depuración temporal a través de DS_LOG_LEVEL=DEBUGo la configuración de log4js. Consulte la guía oficial de registro de depuración .
En Nextcloud, el registro predeterminado basado en archivos normalmente se encuentra nextcloud.logen el directorio de datos configurado. Puede descubrir la ruta activa con:
sudo -E -u www-data php occ log:fileNextcloud también documenta log:tailcuándo log:watchestá disponible la aplicación Lector de registros. Acción: reproduzca un fallo de guardado, anote la marca de tiempo y luego correlacione ambos lados. Un rechazo de red, un error TLS, una respuesta 401/403, una respuesta 5xx o una excepción de almacenamiento apuntan a soluciones muy diferentes.
Un certificado autofirmado o emitido de forma privada puede interrumpir la comunicación HTTPS entre servidores si la CA correspondiente no es de confianza. El conector dispone de la opción «Deshabilitar la verificación de certificados (inseguro)» , pero ONLYOFFICE la describe explícitamente como insegura y recomienda reemplazar el certificado por uno emitido por una CA de confianza. Acción: utilice la omisión de la verificación de certificados únicamente como un paso de diagnóstico breve en un entorno controlado; la solución definitiva consiste en una cadena de certificados válida y de confianza para ambos servidores.
Si ONLYOFFICE utiliza un proxy inverso, confirme que conserva el esquema, el host y el comportamiento de actualización esperados. ONLYOFFICE publica una guía específica para la configuración de proxy inverso, que incluye encabezados reenviados y ajustes relacionados con WebSocket. Consulte la guía de configuración de proxy inverso de Nextcloud de ONLYOFFICE .
Depende del despliegue: la configuración exacta de Nginx, Apache, Traefik, HAProxy, el controlador de entrada o la CDN no se puede inferir únicamente a partir del error de guardado. Acción: compare su configuración de proxy con el ejemplo del proveedor para su topología y examine el estado HTTP registrado durante la devolución de llamada antes de modificar aleatoriamente los tiempos de espera o los encabezados.
Una vez que los registros confirmen que la llamada de retorno llega correctamente a Nextcloud, continúe con el proceso. Nextcloud debe poder recuperar el nuevo documento y reemplazar la versión almacenada. Los permisos del sistema de archivos local, un montaje de solo lectura, espacio en disco agotado, restricciones de cuota, almacenamiento externo no disponible o una excepción de la aplicación o el almacenamiento pueden impedir la escritura final.
Lo que se sabe: Los valores de estado de la función de devolución de llamada de ONLYOFFICE distinguen un documento listo para guardar de uno que presenta un error al guardar. La función de devolución de llamada contiene una URL al documento editado para que el servicio de almacenamiento la recupere. La documentación oficial del controlador de devolución de llamada define el estado 2 como listo para guardar y el estado 3 como un error al guardar.
Lo que no se puede determinar solo con el mensaje del navegador es si el fallo se produjo en ONLYOFFICE, en la ruta de red, en Nextcloud o en el almacenamiento subyacente. Acción: no cambie recursivamente la propiedad de los archivos en un directorio de datos de Nextcloud simplemente porque el editor indique que no puede guardar. Confirme primero si se trata de un error del almacenamiento en el registro de Nextcloud.
Otro error común es creer que al pulsar Guardar se reemplaza inmediatamente el archivo almacenado por Nextcloud. El conector puede usar una opción de guardado intermedio o de guardado forzado. La guía de integración oficial indica que, cuando la opción « Mantener versiones intermedias al editar» (guardado forzado) está activada, al hacer clic en Guardar se envían los cambios directamente al almacenamiento; de lo contrario, los cambios se conservan en la caché del editor y el flujo de trabajo de guardado final se ejecuta posteriormente.
Esto es importante para la resolución de problemas. Si solo falla el guardado forzado, pero el guardado normal funciona, o viceversa, las marcas de tiempo y los estados de devolución de llamada se convierten en evidencia valiosa. Acción: reproduzca el fallo en un flujo de trabajo claramente definido y capture los registros de ese intento en lugar de mezclar el guardado manual, el cierre del navegador y varias pestañas del editor abiertas simultáneamente.
| Síntoma | Próxima comprobación más útil | No asumas |
|---|---|---|
| El editor no se abre en absoluto. | URL del servidor de documentos, JWT, accesibilidad del navegador/servidor | Que se trata de un problema que solo se puede guardar. |
| El editor se abre, pero falla al guardar. | Accesibilidad de devolución de llamada y registros de DocService | Esa apertura exitosa demuestra el camino de regreso. |
| 401/403 alrededor del tráfico de devolución de llamada o de comandos | Encabezado secreto y de autorización JWT | Que un tiempo de espera del proxy sea la causa |
| Errores de validación de TLS/certificado | Cadenas de certificados y tiendas fiduciarias | Deshabilitar la verificación es una solución permanente. |
| La devolución de llamada llega a Nextcloud, pero el archivo permanece sin cambios. | Registro de Nextcloud, montaje de almacenamiento, cuota, errores de escritura | Que ONLYOFFICE perdió la edición |
| Los fallos solo se producen detrás de un proxy/NAT. | URLs internas avanzadas y enrutamiento reenviado | Que las URL públicas funcionan de forma idéntica dentro de los contenedores. |
Utilice un archivo DOCX de prueba pequeño en una carpeta no crítica. Ábralo en ONLYOFFICE, escriba una línea única, como una marca de tiempo, espere a que el editor indique que el cambio se ha guardado y, a continuación, ciérrelo normalmente. Vuelva a abrir el archivo desde Nextcloud y confirme que el texto está presente. A continuación, revise el historial de versiones si su implementación lo utiliza y compruebe los registros del servidor para el mismo intervalo de tiempo.
A continuación, vuelva a ejecutar la comprobación del conector:
sudo -E -u www-data php occ onlyoffice:documentserver --checkUn buen resultado no se limita a que "el editor se abra". La prueba completa consiste en que Nextcloud pueda comunicarse con ONLYOFFICE, ONLYOFFICE pueda comunicarse con la dirección de devolución de llamada en Nextcloud, la autenticación sea exitosa, Nextcloud pueda obtener el archivo actualizado y el sistema de almacenamiento acepte el reemplazo.
Si ninguno de los registros muestra un fallo evidente, aumente temporalmente el nivel de registro de ONLYOFFICE y Nextcloud durante una reproducción controlada y, a continuación, restablezca el nivel de registro a su estado normal. Nextcloud advierte que el nivel de registro DEBUG es muy detallado y puede afectar al rendimiento, por lo que debe utilizarse como medida de diagnóstico y no como configuración permanente en producción. Consulte la documentación de registro de Nextcloud antes de modificar los niveles de registro.
En ese momento, conserve las marcas de tiempo exactas, los códigos de estado HTTP, la versión del conector, la versión de Nextcloud, la versión de ONLYOFFICE Docs, la topología y las líneas de registro relevantes (ocultas). Esta información es mucho más útil que el mensaje genérico del navegador «No se pudo guardar el documento».
Fix ONLYOFFICE “Token is not valid” errors in Nextcloud by checking the JWT secret, authorization header, Docker settings, proxy behavior, and connector health.
Solucione el error "No se pudo guardar el documento" de ONLYOFFICE en Nextcloud revisando las devoluciones de llamada, las URL internas, JWT, TLS, el enrutamiento del proxy, los registros y el almacenamiento.
Solucione los errores de conexión de socket de Collabora Online revisando el cambio de WebSocket 26.04, las rutas de proxy, los encabezados de actualización, los tiempos de espera, TLS y los registros.
Habilite la revisión ortográfica multilingüe en Collabora Online agregando diccionarios de servidor, permitiendo códigos de idioma, asignando idiomas al texto y probando documentos con varios idiomas.
Create a reliable LibreOffice Writer mail merge with per-record images using Calc data, a named image placeholder, and a Basic macro, with troubleshooting and verification steps.
Diagnostica y soluciona los fallos de conexión de documentos de Collabora Online comprobando WOPI, el proxy inverso, TLS, DNS, WebSockets y la accesibilidad entre servidores.
Convierta un PDF a un DOCX editable en los editores de escritorio de ONLYOFFICE sin conexión. Siga los pasos de Guardar como, compruebe si el PDF se ha escaneado y revise el formato.
Conecte Seafile a Collabora Online mediante Docker o un servidor independiente. Compare las ventajas y desventajas de la implementación, configure los ajustes de HTTPS y WOPI, y verifique la edición.
Diagnostica la lentitud al escribir, desplazarte y guardar archivos de LibreOffice Writer con muchas imágenes. Prueba la configuración de pantalla, comprime imágenes de gran tamaño y detecta problemas de perfil o de hardware.
Implementa Collabora CODE en Kubernetes con el gráfico oficial de Helm. Configura el acceso a hosts, TLS y WOPI, los secretos, el escalado y las comprobaciones de extremo a extremo.
