Si el cliente de escritorio de Nextcloud se queda en "Procesando archivos", abre la actividad de sincronización de la cuenta e identifica si un archivo muestra un error repetidamente o si el cliente sigue analizando un árbol de carpetas extenso. Comprueba primero este aspecto y, a continuación, revisa las reglas de archivos ignorados y la conexión con el servidor. Reiniciar el servicio puede solucionar un bloqueo temporal, pero eliminar la base de datos de sincronización o recrear la conexión de sincronización debería ser un paso posterior, ya que puede restablecer las opciones de sincronización selectiva o provocar una comprobación exhaustiva.
Abre el menú de Nextcloud desde la bandeja del sistema en Windows o Linux, o la barra de menú en macOS, y abre el estado de la cuenta. Busca un nombre de archivo repetido, un error visible o una cola que cambie. El cliente distingue los estados de sincronización, pausado, sin conexión, advertencia y error; un icono de actividad azul no prueba por sí solo que se estén subiendo datos. En el modo de sincronización clásico, las superposiciones del administrador de archivos pueden ser útiles: el azul indica una sincronización en espera o activa, una marca de verificación verde significa que está en curso y una X roja indica un error. El modo Archivos virtuales/Proveedor de archivos utiliza diferentes indicadores de estado del sistema operativo, así que revisa la ventana del cliente y los detalles del Finder o el Explorador en lugar de asumir que se aplican los iconos del modo clásico.
Si el número de elementos pendientes disminuye, deje el cliente en ejecución y permita que el escaneo finalice, especialmente después de agregar una carpeta grande o volver a conectar un dispositivo. Si el mismo elemento permanece en la parte superior, consulte los detalles del error. Anote la ruta local y el mensaje exacto antes de mover, renombrar o editar cualquier elemento. Evite pausar y reanudar repetidamente mientras la cola cambia; esto no revela la causa y puede dificultar la evaluación del progreso.
Cuando un archivo bloquea el progreso, compare su nombre, ruta y estado local con la copia del servidor en la interfaz web de Nextcloud. Confirme que el archivo no esté abierto en un editor, siendo escrito por una cámara o un programa de copia de seguridad, o bloqueado por otro proceso. Si una aplicación está modificando el archivo, ciérrelo correctamente y permita que el cliente lo intente de nuevo. No elimine ninguna de las copias solo para borrar el estado.
Algunos archivos se ignoran deliberadamente. Nextcloud excluye ciertos archivos y nombres del sistema que no se pueden representar en otros sistemas de archivos. En la configuración del cliente, abra Avanzado → Editar archivos ignorados (las etiquetas pueden variar según la versión del cliente) y revise los patrones personalizados para el nombre afectado o su carpeta principal. Un comodín como *coincide con varios caracteres; ?coincide con un carácter; una barra diagonal final limita un patrón a directorios. Elimine o restrinja una regla personalizada solo si el archivo debe sincronizarse. No edite el archivo global sync-exclude.lstque viene con la aplicación como primera solución; Nextcloud advierte que cambiar este archivo puede causar un comportamiento no deseado.
Compruebe también el estado de las carpetas ignoradas o no sincronizadas del cliente y las opciones de sincronización selectiva. Una carpeta excluida intencionadamente no se sincronizará simplemente reiniciando el cliente. Si el problema afecta solo a una ruta específica, probar temporalmente una copia en una carpeta simple puede ayudar a distinguir una regla específica de la ruta de un problema general de conexión, pero no utilice un segundo servicio de sincronización en la nube en el mismo directorio de sincronización en vivo.
Inicie sesión en la misma cuenta de Nextcloud en un navegador y confirme que los archivos y carpetas se cargan. Si la interfaz web funciona pero todos los dispositivos de escritorio se bloquean, el problema podría estar en el punto final WebDAV del servidor o en su configuración. El cliente de Nextcloud utiliza WebDAV para acceder a los archivos del servidor. Para un servidor instalado en https://cloud.example.com, su punto final DAV suele ser https://cloud.example.com/remote.php/dav; utilice su ruta de instalación real. Al abrir esa dirección en un navegador, debería al menos solicitar autenticación o mostrar una respuesta del punto final. Los fallos de autenticación, las advertencias de certificado o los errores del servidor son señales para contactar con el administrador o revisar los registros del servidor en lugar de reiniciar el cliente local.
Comprueba si otro programa de sincronización, utilidad de copia de seguridad o función de archivos sin conexión también gestiona el mismo directorio. El manual de solución de problemas de Nextcloud indica que sincronizar un directorio con varias aplicaciones de sincronización no es compatible y puede provocar la pérdida de datos. Elimina la superposición solo después de identificar qué aplicación es la propietaria de la carpeta y conservar los cambios locales. Si solo un equipo se ve afectado, comprueba el espacio en disco local, los permisos de la carpeta, el antivirus o el análisis en tiempo real, y si el cliente puede leer y renombrar archivos en el directorio de sincronización.
Los archivos de depuración incluyen registros e información de la base de datos y pueden contener nombres de archivo confidenciales, detalles de la cuenta o direcciones del servidor. Revíselos y edite la información antes de compartirlos con el soporte técnico. La documentación de solución de problemas de Nextcloud describe el archivo de depuración y otras formas de capturar los registros del cliente.
No elimine de forma rutinaria la base de datos de sincronización del cliente para solucionar un estado genérico de "Procesando archivos". Nextcloud documenta una solución más específica para el error desconocido de CSync : detenga el cliente, localice el .sync_xxxxxxx.dbarchivo oculto dentro de la carpeta de la cuenta configurada por el cliente y elimine esa base de datos antes de reiniciarlo. La documentación advierte que esto también borra algunas configuraciones sobre qué archivos descargar. Realice una copia de seguridad de la carpeta de sincronización local y registre primero las configuraciones de sincronización selectiva; nunca elimine una base de datos mientras el cliente esté en ejecución. Si el error exacto no aparece, revise el archivo de depuración o póngase en contacto con el soporte técnico antes de intentar esta recuperación.
Tras el cambio, verifique algo más que la desaparición del indicador de carga. La cola de tareas pendientes debería vaciarse, el cliente debería mostrar un estado actualizado y conectado, y debería aparecer un pequeño archivo de prueba en la ubicación esperada, tanto localmente como en la interfaz web. Confirme que el archivo afectado originalmente contiene el contenido previsto y que las carpetas de sincronización selectiva permanecen configuradas. Si el mismo archivo vuelve a fallar, guarde el error exacto y un archivo de depuración anonimizado; un problema recurrente de permisos, nombre de archivo, WebDAV o versión del cliente requiere una solución específica.
Para obtener información sobre los controles del cliente y los pasos para solucionar problemas, consulte el manual de usuario del cliente de escritorio de Nextcloud y la documentación de solución de problemas de Nextcloud Desktop . El manual de usuario en línea actual corresponde a Nextcloud 36; las etiquetas del cliente y las funciones de Archivos Virtuales disponibles pueden variar según la versión del cliente de escritorio y el sistema operativo.
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.
