Migrar del backend Cache a la caché VFS de Rclone

Rclone ofrece un backend llamado cache que envuelve otro remoto y guarda datos y metadatos localmente. Está obsoleto, carece de mantenedor y la documentación recomienda no usarlo en instalaciones nuevas [1]. Para montajes, la alternativa integrada es la caché de archivos VFS de rclone mount [2].

Esta guía muestra cómo sustituir un remoto de tipo cache por el remoto de almacenamiento original y configurar la caché VFS según el uso. Los ejemplos son genéricos: adapta el nombre del remoto, la ruta y el punto de montaje a tu sistema.

Identificar el remoto de almacenamiento real

Una configuración antigua puede definir un remoto envoltorio, por ejemplo media-cache, cuyo campo remote apunta al almacenamiento real. En vez de montar media-cache:, monta directamente ese remoto subyacente, como almacenamiento:/multimedia.

Comprueba el nombre y la ruta en el archivo de configuración de Rclone, pero no copies contraseñas, tokens ni secretos a scripts compartidos. Las credenciales deben mantenerse en la configuración protegida de Rclone.

Elegir el modo de caché VFS

El modo depende de las operaciones que necesiten las aplicaciones que acceden al montaje [2]:

Modo	Comportamiento	Uso habitual
writes	Lee directamente del remoto; almacena en disco los archivos que se escriben o abren para lectura y escritura.	Montajes donde se necesita compatibilidad al escribir y no se busca almacenar localmente todas las lecturas.
full	Almacena en disco tanto lecturas como escrituras; las lecturas pueden descargarse por partes.	Aplicaciones que vuelven a leer datos y pueden beneficiarse de la caché local.

Sin caché VFS, algunas operaciones habituales de un sistema de archivos no funcionan como esperan las aplicaciones. El modo writes añade compatibilidad para escrituras; full también almacena las lecturas. La caché ocupa espacio local, por lo que conviene elegir un directorio de caché en un disco con capacidad suficiente [2].

Montar el remoto con caché para escrituras

Este ejemplo reemplaza el remoto envoltorio por el remoto real y conserva una caché local para las escrituras:

rclone mount almacenamiento:/multimedia /mnt/rclone \
  --cache-dir /var/cache/rclone \
  --vfs-cache-mode writes \
  --vfs-cache-max-size 1G \
  --buffer-size 25M \
  --allow-other \
  --verbose

Cambia almacenamiento:/multimedia por el nombre y la ruta configurados en tu caso. Asegúrate de que /mnt/rclone exista y de que el usuario que ejecuta Rclone pueda acceder al punto de montaje y al directorio /var/cache/rclone.

--vfs-cache-max-size limita el tamaño objetivo de los archivos almacenados en la caché; no limita todo el espacio que Rclone pueda necesitar en el disco. La limpieza se comprueba periódicamente y los archivos abiertos no se pueden expulsar, así que el uso puede superar temporalmente el límite [2]. Deja margen libre en el volumen.

--allow-other permite que otros usuarios locales accedan al montaje. Úsalo solo si lo necesitas y configura FUSE para permitir esa opción; si el montaje es solo para el usuario que ejecuta Rclone, puedes omitirlo.

Habilitar caché también para las lecturas

Si quieres conservar localmente los datos leídos, cambia el modo a full:

rclone mount almacenamiento:/multimedia /mnt/rclone \
  --cache-dir /var/cache/rclone \
  --vfs-cache-mode full \
  --vfs-cache-max-size 20G \
  --vfs-read-chunk-size 50M \
  --vfs-read-chunk-size-limit 0 \
  --buffer-size 25M \
  --verbose

En el modo full, Rclone puede descargar solo las partes solicitadas y mantenerlas en la caché. --vfs-read-chunk-size ajusta el tamaño inicial de los bloques de lectura; --vfs-read-chunk-size-limit 0 desactiva el límite de crecimiento de esos bloques. Estos parámetros afectan a las lecturas por bloques y deben ajustarse según el remoto y el patrón de acceso [2].

El modo full puede consumir más espacio local que writes, sobre todo cuando se recorren muchos archivos. Define un límite apropiado y monitoriza el volumen. Los límites se aplican a la caché VFS, no al almacenamiento remoto.

Verificar la migración

Antes de retirar la configuración antigua, valida el montaje con una selección pequeña de archivos:

1. Comprueba que el remoto subyacente resuelve la ruta con rclone lsf almacenamiento:/multimedia.
2. Inicia rclone mount en primer plano y observa los mensajes con --verbose.
3. Lee un archivo y, si el montaje debe permitir escrituras, crea, modifica y elimina un archivo de prueba.
4. Confirma que el directorio de caché está en el volumen previsto y que el uso de disco se mantiene bajo control.
5. Revisa los registros y comprueba el comportamiento después de desmontar y volver a montar.

Rclone escribe los archivos en caché al remoto cuando se cierran y transcurre el intervalo configurado para la escritura diferida. Los archivos que aún no se han enviado pueden necesitar la misma configuración de montaje cuando Rclone se reinicie [2]. No borres manualmente los datos de caché mientras el montaje está activo.

Resumen

• El backend cache está obsoleto; para nuevas configuraciones, usa la caché VFS integrada en rclone mount [1].
• Monta directamente el remoto de almacenamiento que antes estaba envuelto por cache.
• Elige writes para almacenar escrituras y full para almacenar también lecturas.
• Sitúa la caché en un disco local adecuado, limita su tamaño y deja espacio libre adicional.
• Prueba lecturas y escrituras antes de retirar definitivamente la configuración anterior.

📚 Fuentes consultadas

1. Cache backend — Rclone documentation
2. Rclone mount: VFS file caching — Rclone documentation

Imagen