Nextcloud mantiene una caché de archivos para relacionar los ficheros del almacenamiento con lo que muestra en la interfaz. Si se han añadido o cambiado archivos fuera de Nextcloud y no aparecen como esperas, el comando occ files:scan permite volver a examinar el almacenamiento y actualizar esa caché [1].
El escaneo debe ejecutarse desde la instalación correcta y con el usuario del servidor web. En Debian y Ubuntu suele ser www-data; en otras distribuciones puede tener otro nombre. Ejecutarlo con una identidad distinta puede dejar permisos incoherentes [2].
Localizar la instalación y el usuario de servicio
En una instalación tradicional, entra en el directorio donde está el archivo occ. En el ejemplo de Debian o Ubuntu:
cd /var/www/nextcloud
sudo -E -u www-data php occ status
El comando status permite comprobar que occ encuentra la instalación. Ajusta /var/www/nextcloud y www-data a las rutas y al usuario de tu servidor. Si Nextcloud está en un contenedor, ejecuta el comando dentro del contenedor y con el usuario de servicio que use esa imagen; la forma de entrar depende de cómo se haya desplegado.
Escanear archivos
Para volver a escanear todos los archivos de todos los usuarios:
sudo -E -u www-data php occ files:scan --all
Para limitar el escaneo a un usuario, sustituye usuario por su identificador de Nextcloud:
sudo -E -u www-data php occ files:scan usuario
También se puede indicar una ruta virtual dentro del espacio de archivos de un usuario. Por ejemplo, para revisar la carpeta Música de usuario:
sudo -E -u www-data php occ files:scan --path="/usuario/files/Música"
La opción --path restringe el escaneo a esa ruta y determina el usuario a partir de ella; por tanto, no hace falta añadir --all ni el identificador del usuario cuando se usa [1]. Para confirmar las opciones disponibles en la versión instalada, consulta la ayuda:
sudo -E -u www-data php occ files:scan --help
Comprobar el resultado
Cuando termine el proceso, revisa si los archivos esperados aparecen en la interfaz web y si puedes acceder a ellos. Si el comando informa de errores, comprueba la ruta de instalación, el identificador del usuario, los permisos y los registros de Nextcloud.
Un escaneo global puede tardar más que uno limitado a un usuario o una ruta. Empieza por el alcance más pequeño que resuelva el problema y reserva --all para cuando necesites revisar todas las cuentas. El escaneo actualiza la caché de Nextcloud: no es una herramienta para reparar nombres de archivo ni sustituye a una copia de seguridad.
Resumen
- Ejecuta
occdesde la instalación correcta. - Usa el usuario del servidor web, que en Debian y Ubuntu normalmente es
www-data. - Elige entre escanear todos los usuarios, una cuenta o una ruta concreta.
- Verifica la interfaz y los registros después del proceso.
📚 Fuentes consultadas
- Files commands — Nextcloud Administration Manual
- Using the occ command — Nextcloud Administration Manual