Ejemplo hipotético: Mina edita un plan de proyecto en ONLYOFFICE desde una carpeta de Nextcloud. El editor se abre y acepta los cambios, pero Nextcloud informa posteriormente: «No se pudo guardar el documento». Este ejemplo es ilustrativo y no corresponde a una prueba real. En esta situación, mantenga el editor abierto, guarde una copia local del trabajo sin guardar y compruebe si ONLYOFFICE Docs puede acceder directamente a la función de guardado de Nextcloud. A continuación, utilice los registros para distinguir entre un fallo en el enrutamiento de la función de guardado y un problema de almacenamiento o permisos de Nextcloud.
No cierre ni actualice el editor mientras contenga cambios que Nextcloud no haya guardado. Si el editor sigue funcionando, utilice la opción «Descargar como» para guardar una copia de seguridad local. Anote la hora y el nombre del archivo que no se guardó correctamente para que el administrador pueda consultar los registros.
Prueba con un archivo DOCX pequeño en una carpeta estándar de Nextcloud. Si se guarda correctamente, revisa los permisos, el estado de compartición, el almacenamiento o el formato del archivo original. Si falla con todos los archivos, comienza por la ruta de devolución de llamada compartida y el estado del servidor.
ONLYOFFICE Docs envía una solicitud POST a la URL de devolución de llamada proporcionada por el conector de Nextcloud. Nextcloud recupera el archivo editado y actualiza su versión almacenada. El editor puede abrirse con normalidad, pero no guardar los cambios si el servidor de documentos no puede enviar la respuesta a Nextcloud.
Reproduce el problema con un archivo de prueba y luego compara los registros de DocService y Nextcloud en ese momento. En Linux, los registros de ONLYOFFICE se encuentran en /var/log/onlyoffice/documentserver/; en Docker, revisa los registros del contenedor o el directorio de registros montado. El archivo de registro predeterminado de Nextcloud está nextcloud.logen su directorio de datos, a menos que log_typeo logfilelo modifique.
En Nextcloud, abre Configuración > Administración > ONLYOFFICE . Confirma que la dirección pública de ONLYOFFICE Docs sea la URL que los navegadores de los usuarios deben cargar. Si los dos servidores no pueden comunicarse entre sí a través de sus direcciones públicas, configura los campos internos documentados: Dirección de ONLYOFFICE Docs para solicitudes internas del servidor y Dirección del servidor para solicitudes internas de ONLYOFFICE Docs . La primera debe funcionar de Nextcloud al servidor de documentos; la segunda debe funcionar del servidor de documentos a Nextcloud.
En la configuración hipotética de Mina, la función de devolución de llamada utiliza http://cloud.example.comHTTPS y redirige a esta dirección. Configure directamente la dirección HTTPS final y asegúrese de que el DNS, las reglas del firewall y la confianza del certificado permitan que Document Server acceda a ella. El proxy debe reenviar la devolución de llamada a Nextcloud sin redirigir su esquema, nombre de host ni ruta. El nombre de host de ejemplo no es para instalaciones reales.
La comprobación de conexión de ONLYOFFICE puede ayudar a verificar las direcciones de servicio configuradas:
sudo -u www-data php occ onlyoffice:documentserver --checkEjecútalo desde el directorio de Nextcloud con la cuenta de servidor web correspondiente. Una comprobación exitosa no demuestra que la solicitud POST funcione. Una solicitud HEAD manual o una página del navegador con el mismo nombre de host tampoco lo demuestran.
Si la llamada llega a Nextcloud pero el archivo aún no se actualiza, revise el registro de Nextcloud para encontrar la solicitud correspondiente. Confirme que el usuario tenga permisos de edición, que el punto de montaje de almacenamiento esté disponible, que la cuenta no haya superado la cuota y que el volumen de datos tenga espacio libre e inodos. Si el problema afecta a un archivo compartido, pregunte si otro usuario o cliente de sincronización lo está modificando simultáneamente y, a continuación, realice una prueba con una copia en una carpeta privada.
El bloqueo de archivos transaccionales de Nextcloud coordina las escrituras; no lo desactive como solución rápida. Si los registros indican errores de bloqueo o de base de datos, verifique el sistema de bloqueo y el servicio Redis o Valkey. No elimine oc_file_locksfilas ni bloquee archivos, ya que esto podría interrumpir las escrituras activas.
Si una prueba con una carpeta estándar funciona, pero falla con un archivo almacenado externamente, investigue la disponibilidad y el modo de autenticación de ese punto de montaje. ONLYOFFICE documenta las limitaciones de algunos modos de almacenamiento externo; evite cambiar las credenciales hasta que haya aislado el punto de montaje.
Tras modificar una configuración, edite un documento de prueba pequeño, espere a que finalice el guardado y, a continuación, ciérrelo y vuelva a abrirlo desde Nextcloud. Compruebe que la edición se mantiene y que los registros correspondientes no muestran redirecciones, fallos de conexión ni excepciones de almacenamiento.
Si la prueba se realiza correctamente pero la original sigue fallando, compruebe sus permisos, montaje externo o ediciones simultáneas. Si todas las funciones de devolución de llamada fallan, conserve la copia local y escale el problema con la marca de tiempo, el estado HTTP, las versiones y los registros anonimizados. Oculte los JWT, las cookies, las URL firmadas y los nombres de archivo personales.
Estos pasos abordan las causas comunes de errores de guardado relacionadas con la devolución de llamada, el enrutamiento y el almacenamiento. La solución exacta depende del primer punto de fallo detectado en los registros; una comprobación de conexión correcta por sí sola no garantiza el correcto funcionamiento del proceso de guardado.
Documentación revisada el 9 de octubre de 2026. Los campos del conector y los destinos de los registros pueden variar según la versión de la aplicación instalada y la configuración de implementación.
Diagnostique los fallos al guardar archivos en ONLYOFFICE revisando la ruta de devolución de llamada de Nextcloud, las redirecciones del proxy y los registros de almacenamiento, y luego verifique que el archivo editado persista.
Encuentre la causa de los fallos de memoria de ONLYOFFICE, compruebe los límites de Docker, ajuste correctamente el tamaño de la RAM del VPS, agregue memoria de intercambio de forma segura y verifique que los documentos se abran y guarden.
Separe los problemas de descarga del navegador de los errores de conversión del servidor y utilice el registro o la comprobación de acceso adecuados para que la exportación a PDF funcione correctamente.
Coincidencia con el secreto JWT utilizado por ONLYOFFICE Docs y Nextcloud, aplicación segura para instalaciones de Docker o Linux, y verificación de la conexión sin debilitar la autenticación.
Instala ONLYOFFICE Workspace Community en Ubuntu 24.04 con el script oficial de Docker, comprueba los requisitos del servidor, omite Mail si es necesario y verifica el portal de forma segura.
Configure secretos JWT coincidentes para ONLYOFFICE Docs y su conector, con pasos seguros para paquetes Linux, implementaciones Docker y verificación.
Personaliza el editor de ONLYOFFICE Docs integrado con el logotipo de tu empresa y los colores de la interfaz mediante un archivo de tema personalizado y la configuración del editor. Consulta los límites de edición y las comprobaciones de implementación.
Realiza un seguimiento de las ediciones en Writer, conserva una fuente ODT editable y revisa el archivo DOCX exportado en Word antes de compartirlo.
Siga el procedimiento SP7 de SUSE para habilitar el modo FIPS, reiniciar de forma segura, verificar la política activa y comprobar si sus requisitos de cumplimiento exigen módulos validados.
Compare YaST y cryptsetup para un nuevo volumen de datos SLES cifrado, elija LUKS1 o LUKS2 y verifique el comportamiento de desbloqueo y montaje de forma segura.
