Inicio
» ADMINISTRADOR DE RED
»
Solucionar el problema del cliente de sincronización de escritorio de Nextcloud que se queda atascado en "Procesando archivos".
Solucionar el problema del cliente de sincronización de escritorio de Nextcloud que se queda atascado en "Procesando archivos".
Si Nextcloud Desktop se queda en "Procesando archivos" , no elimine la base de datos de sincronización ni la carpeta local. Lo más seguro es comprobar si el cliente sigue escaneando, si un archivo falla repetidamente o si el cliente ha dejado de avanzar. En muchos casos, la solución es mucho más sencilla: pausar y reanudar la sincronización, cerrar la aplicación que bloquea un archivo, cambiar el nombre de un archivo incompatible, eliminar una herramienta de sincronización que compita con la misma carpeta o actualizar el cliente de escritorio.
A fecha de 6 de octubre de 2026, la última versión estable listada por el proyecto oficial de Nextcloud Desktop es la 34.0.4 ; las versiones RC 35.0.0 son versiones preliminares. La propia documentación de Nextcloud advierte de que usar el mismo directorio con otro sistema de sincronización no es compatible y puede provocar resultados poco fiables o incluso la pérdida de datos. Empiece con las comprobaciones menos destructivas que se indican a continuación y solo restablezca la conexión de sincronización una vez que sepa que los archivos del servidor y del ordenador están a salvo.
Nextcloud Desktop muestra "Procesando archivos" con los elementos recientes aún en proceso de escaneo; utilice esta vista para decidir si el cliente está progresando o si realmente se ha quedado bloqueado.
1. Primero, confirme que el proceso de "Procesamiento de archivos" realmente se ha bloqueado.
El estado de "procesamiento" puede significar que el cliente está detectando cambios en las carpetas, comparando metadatos, preparando cargas o trabajando con una estructura de directorios extensa. Si el archivo actual, la lista de actividad, el uso del disco o el registro de actividad están cambiando, es posible que el cliente aún esté trabajando. Una carpeta muy grande, una sincronización inicial o una carpeta con muchos archivos pequeños pueden tardar mucho más en detectar cambios que una simple carpeta de documentos.
Abre la ventana principal de Nextcloud y revisa la actividad reciente. Luego, abre la carpeta de sincronización local y ordena por fecha de modificación o consulta las superposiciones de estado de los archivos. Si se modifican diferentes archivos con el tiempo, espera a que finalice el ciclo actual antes de cambiar la configuración. Si se repite la misma ruta o mensaje y no hay otros cambios, pasa al siguiente paso.
2. Pause y reanude la sincronización afectada y, a continuación, reinicie el cliente.
Menú de sincronización de carpetas de Nextcloud con Pausar sincronización, Abrir carpeta y Eliminar conexión de sincronización de carpeta; pausar y reanudar antes de usar la opción de eliminar, que puede ser más intrusiva.
Para un cliente que ha dejado de avanzar, utilice el menú de la carpeta para pausar la sincronización, espere a que cambie el estado y reanúdela. Si esto no funciona, cierre Nextcloud por completo y vuelva a abrirlo. Esto soluciona el problema sin alterar la relación de sincronización ni eliminar ningún archivo.
Esto es especialmente apropiado después de que una computadora portátil salga del modo de suspensión, una VPN cambie de red, una unidad montada se vuelva a conectar o se haya cerrado una aplicación que tenía un archivo sincronizado abierto. Reiniciar la computadora por completo es razonable si sospecha que un archivo está bloqueado, pero no debería ser su único paso de diagnóstico: si el mismo archivo vuelve a causar el bloqueo, los registros le brindarán más información.
3. Encuentra el archivo o carpeta que está bloqueando el ciclo.
El Explorador de archivos de Windows muestra una carpeta de Nextcloud donde un archivo grande tiene un indicador de error, mientras que otros elementos se sincronizan; un solo archivo que bloquea la sincronización puede mantener ocupado un ciclo de sincronización.
Una sincronización puede parecer bloqueada globalmente cuando el problema real se limita a una ruta específica. Busque un indicador de error rojo, una advertencia, un nombre de archivo repetido en la lista de actividad o un mensaje de registro que mencione el mismo archivo repetidamente.
Las causas comunes a nivel de archivo incluyen un archivo que aún está abierto para escritura exclusiva, una ruta que el usuario actual no puede leer ni escribir, un archivo que cambia constantemente mientras Nextcloud intenta procesarlo, o un nombre de archivo que el sistema de archivos de destino no puede representar. Windows es un caso particularmente importante porque un nombre de archivo válido en un servidor Nextcloud alojado en Linux puede no ser válido en Windows. Nextcloud Server se puede configurar para exigir nombres de archivo compatibles con Windows; la documentación oficial explica la restricción y proporciona ejemplos, como nombres reservados y caracteres prohibidos, en la guía de nombres de archivo compatibles con Windows .
Si un archivo está implicado, cierre el programa que lo utiliza, cámbiele el nombre a uno sencillo compatible con varias plataformas si es necesario y asegúrese de que su cuenta tenga permisos de lectura y escritura en la carpeta local. A continuación, reanude la sincronización y compruebe si la cola avanza.
4. Compruebe los archivos ignorados, las rutas no compatibles y el software de sincronización de la competencia.
El editor de archivos ignorados admite patrones de archivos y carpetas; permite revisar las exclusiones cuando determinados archivos nunca salen de la cola de procesamiento.
Nextcloud incluye un editor de archivos ignorados y una lista de exclusión integrada. El cliente también excluye archivos con caracteres que no se pueden sincronizar con otro sistema de archivos. Si un directorio en particular nunca se sincroniza, revise sus patrones de exclusión personalizados y asegúrese de que un comodín amplio no coincida con más archivos de los previstos.
No edite el sync-exclude.lstarchivo global sin precaución. El manual de Nextcloud advierte específicamente que modificar la definición de exclusión global puede dejar el cliente inutilizable o provocar un comportamiento no deseado. Utilice el editor para reglas personalizadas, a menos que tenga una razón justificada para modificar la lista predefinida.
Asegúrese también de que la carpeta de Nextcloud no esté siendo gestionada simultáneamente por OneDrive, Dropbox, Syncthing, rsync, Archivos sin conexión de Windows u otro producto de sincronización. La página oficial de solución de problemas de Nextcloud indica que no se admite la sincronización del mismo directorio con Nextcloud y otro sistema de sincronización. Si dos herramientas están monitorizando el mismo árbol, mueva una de ellas a una carpeta separada en lugar de intentar que coexistan.
5. Descartar posibles cuellos de botella en la red, el servidor proxy, el antivirus y el almacenamiento.
Configuración de red de Nextcloud con controles de proxy y ancho de banda; verifique que la configuración de proxy o de limitación de ancho de banda no impida las transferencias normales.
Si el cliente detecta los archivos correctamente, pero las transferencias no avanzan, revise la pestaña Red. Un proxy manual antiguo, un proxy solo para VPN o límites de ancho de banda muy bajos pueden provocar que una sincronización correcta parezca bloqueada. Si su política lo permite, pruebe temporalmente con una conexión directa y fiable.
Nextcloud también señala que el análisis antivirus en tiempo real puede ralentizar la carga y descarga de archivos tanto en el servidor como en el cliente. Esto no significa que deba desactivar la protección de endpoints como solución predeterminada. En su lugar, compruebe si el software de seguridad analiza repetidamente el mismo archivo grande o que cambia con frecuencia, y consulte con su administrador si es apropiado excluirlo de su entorno.
Comprueba el espacio libre en el disco duro de tu ordenador y la cuota disponible en el servidor de Nextcloud. Un cliente no puede completar las descargas si el disco local está lleno, y las subidas pueden fallar si la cuenta del servidor o el sistema de almacenamiento se quedan sin espacio.
6. Actualizar a una versión estable del cliente de escritorio.
La pantalla "Acerca de" de Nextcloud Desktop muestra la versión 34.0.4; compare la compilación instalada con la versión estable actual antes de realizar una solución de problemas más exhaustiva.
Antes de dedicar tiempo a modificar la base de datos, compare su cliente instalado con la versión estable actual. El 6 de octubre de 2026, el proyecto oficial anunció la versión 34.0.4 como la última versión estable, mientras que las versiones RC 35.0.0 son versiones preliminares. La versión 34.0.x incluye varias correcciones relacionadas con la detección, Windows, macOS y el proveedor de archivos, por lo que actualizar es recomendable si utiliza una versión anterior compatible.
Utilice el actualizador del cliente u obtenga el instalador de los canales de distribución oficiales de Nextcloud. El historial de versiones oficial se encuentra en la página de versiones de Nextcloud Desktop . Evite instalar una versión candidata en una estación de trabajo de producción únicamente para solucionar un problema de sincronización, a menos que la esté probando intencionadamente y pueda revertir los cambios.
7. Lee los registros en lugar de adivinar.
Salida de registro de Nextcloud con advertencia de archivo resaltado; los registros son la forma más rápida de identificar la ruta o la operación exacta que se está repitiendo.
Si el problema persiste tras reiniciar y actualizar, el registro del cliente es el siguiente paso más útil. Nextcloud ofrece dos métodos oficiales: crear un archivo de depuración desde la configuración o abrir la ventana de registro con el atajo de teclado documentado. El archivo de depuración contiene los registros y la base de datos del cliente, por lo que debe tratarse como información confidencial y censurar o limitar la información que se comparte.
Busque mensajes repetidos que involucren la misma ruta, errores de autenticación, errores de permisos, mensajes de "no se puede abrir", errores de conexión, errores HTTP del servidor o errores de sincronización del registro. Un error repetible es más útil que la etiqueta genérica "Procesando archivos".
La documentación oficial de solución de problemas de Nextcloud explica cómo crear el archivo de depuración e indica que los registros de escritorio pueden contener información confidencial.
8. Restablezca la conexión de sincronización solo después de proteger ambas copias.
Configuración general de Nextcloud con controles para editar archivos ignorados y crear archivos de depuración; cree un archivo antes de restablecer una conexión de sincronización o informar de un error.
Si los registros indican un estado de sincronización dañado o si la relación de carpetas sigue sin funcionar tras las comprobaciones anteriores, restablezca la conexión de sincronización de carpetas como último recurso. Primero, cree un archivo de depuración y, a continuación, verifique en la interfaz web que la copia del servidor contiene lo esperado. Realice una copia de seguridad independiente de los archivos locales que no se hayan subido.
Después, elimine la conexión de sincronización de carpetas del cliente de escritorio y vuelva a agregarla, seleccionando las carpetas locales y del servidor correctas. No interprete «eliminar la conexión de sincronización de carpetas» como un permiso para borrar los datos locales o el directorio de datos del servidor. El directorio de datos de un servidor Nextcloud autohospedado es administrado por Nextcloud y no debe modificarse manualmente.
Los usuarios avanzados a veces encuentran mensajes sobre .sync_*.dbarchivos antiguos o duplicados. El código fuente del cliente Nextcloud incluye instrucciones para bases de datos de sincronización obsoletas o sin usar en situaciones específicas con varias cuentas, pero eliminar un registro de sincronización no es una solución universal de primera línea. Si no hay un error claro relacionado con el registro, recrear la conexión de sincronización con copias de seguridad es más fácil de entender y es menos probable que oculte la causa original.
¿Qué solución deberías probar primero?
Lo que ves
Mejor siguiente paso
La actividad o los nombres de los archivos cambian constantemente.
Dejemos que continúe el ciclo actual de descubrimiento/sincronización.
El mismo archivo se repite
Cierra la aplicación, comprueba los permisos, cámbiale el nombre si el archivo es incompatible y vuelve a intentarlo.
Las transferencias no comienzan
Verifique el proxy, la VPN, los límites de ancho de banda, la accesibilidad del servidor, la cuota y el espacio en disco.
Solo se omiten algunos caminos.
Revise los patrones de archivos ignorados y la compatibilidad de los nombres de archivo.
La carpeta de sincronización también es utilizada por otra herramienta de sincronización/nube.
Separe las carpetas; no ejecute ambos motores de sincronización en el mismo directorio.
Estás usando un cliente de escritorio antiguo.
Actualice a la versión estable más reciente antes de realizar reparaciones más profundas.
El cliente permanece bloqueado después de reiniciar y actualizar.
Crea un archivo de depuración e inspecciona el error que se repite.
El estado de sincronización está claramente dañado.
Realice una copia de seguridad de los archivos locales, verifique la copia del servidor y, a continuación, vuelva a crear la conexión de sincronización de carpetas.
En resumen
La forma más fiable de solucionar el problema de Nextcloud Desktop atascado en "Procesando archivos" es analizar la información disponible en lugar de reiniciar todo de golpe. Primero, compruebe si el proceso sigue avanzando. A continuación, pause y reanude, aísle el archivo problemático, revise las exclusiones y el software de sincronización alternativo, descarte problemas de red o almacenamiento, actualice el cliente e inspeccione los registros. Restablecer la conexión de sincronización debe hacerse al final del proceso, una vez que las copias locales y del servidor estén protegidas.
Si el registro indica un error reproducible del cliente, capture la versión del cliente, el sistema operativo, la versión del servidor, el error exacto y un archivo de depuración anonimizado antes de reportarlo. Esto proporciona a los responsables del mantenimiento información suficiente para distinguir un problema con un archivo local de un defecto en el cliente de escritorio o un fallo del servidor.