Usar JuiceFS con WebDAV y almacenamiento compatible con S3

JuiceFS separa los datos de los metadatos: los primeros se guardan en un almacenamiento como WebDAV o S3, mientras que la información del sistema de archivos se conserva en un motor de metadatos como Redis, MySQL o PostgreSQL [1]. En esta guía veremos dos configuraciones: servir un remoto de rclone por WebDAV y usar un endpoint compatible con S3.

Importante: juicefs format crea el sistema de archivos y guarda su configuración en el motor de metadatos. No lo ejecutes de nuevo sobre un sistema existente sin revisar antes la documentación y confirmar qué efecto tendrá sobre sus datos [1].

Requisitos

• El cliente de JuiceFS instalado en la máquina que vaya a crear o montar el sistema de archivos.
• Un motor de metadatos accesible, como Redis, MySQL o PostgreSQL.
• Un backend de datos WebDAV o compatible con S3.
• Credenciales con permisos suficientes, si el motor o el almacenamiento las requiere.

JuiceFS recibe el motor de metadatos como META-URL, el tipo de almacenamiento mediante --storage y su endpoint con --bucket [1][2]. Los ejemplos usan Redis local sin contraseña y valores genéricos; adapta la conexión a tu infraestructura.

Opción 1: servir un remoto de rclone por WebDAV

Rclone puede exponer un remoto mediante WebDAV. Para un cliente JuiceFS que se ejecuta en el mismo servidor, vincula el servicio a 127.0.0.1 para que no escuche en todas las interfaces de red [3]:

rclone --config "$HOME/.config/rclone/rclone.conf" \
  serve webdav --addr 127.0.0.1:8080 \
  remoto:directorio

Sustituye remoto:directorio por una ruta configurada en rclone. Mantén protegida la configuración de rclone, ya que puede contener credenciales de acceso al backend.

En otra terminal, crea un sistema JuiceFS que use ese endpoint WebDAV y un motor de metadatos:

juicefs format \
  --storage webdav \
  --bucket http://127.0.0.1:8080/ \
  redis://127.0.0.1:6379/1 \
  jfs-webdav

El bloque --block-size, si se necesita, se expresa en KiB. El tamaño predeterminado documentado es 4096 KiB; evalúa el valor según el backend y la carga de trabajo en lugar de copiar un ajuste de otro sistema [2].

Opción 2: usar un endpoint compatible con S3

JuiceFS permite usar el tipo s3 también con servicios compatibles con su API. La URL de --bucket depende del proveedor: suele usar el formato https://<bucket>.<endpoint> o https://<endpoint>/<bucket> [2]. Este ejemplo es orientativo y utiliza un dominio reservado para documentación:

export ACCESS_KEY="<ACCESS_KEY_EJEMPLO>"
export SECRET_KEY="<SECRET_KEY_EJEMPLO>"

juicefs format \
  --storage s3 \
  --bucket https://storage.example.net/mi-bucket \
  redis://127.0.0.1:6379/2 \
  jfs-s3

unset ACCESS_KEY SECRET_KEY

Reemplaza el endpoint y las credenciales por los valores de tu proveedor. JuiceFS recomienda suministrar las claves mediante ACCESS_KEY y SECRET_KEY, en lugar de escribirlas como argumentos --access-key y --secret-key en la línea de comandos [2]. Si el servicio requiere una región concreta u opciones adicionales de compatibilidad, revisa la documentación del proveedor y de JuiceFS.

Montar y comprobar el sistema de archivos

Una vez creado, monta el sistema con la misma URL de metadatos y en un punto de montaje existente:

mkdir -p "$HOME/jfs"
juicefs mount redis://127.0.0.1:6379/1 "$HOME/jfs" -d

Para el ejemplo S3, sustituye la URL de metadatos por redis://127.0.0.1:6379/2, la misma que se utilizó al crear jfs-s3. JuiceFS conserva en los metadatos la configuración del sistema de archivos, por lo que el montaje recupera desde allí el backend asociado [1]. La opción -d ejecuta el montaje en segundo plano [1][4].

Comprueba el estado del ejemplo WebDAV y realiza una prueba controlada de lectura y escritura:

juicefs status redis://127.0.0.1:6379/1
printf 'prueba\n' > "$HOME/jfs/prueba.txt"
cat "$HOME/jfs/prueba.txt"

Cuando termines, desmonta el volumen con el comando de JuiceFS:

juicefs umount "$HOME/jfs"

Seguridad y operación

• No publiques contraseñas, claves de almacenamiento, URL completas con credenciales ni configuraciones privadas de rclone.
• Restringe el acceso de red al motor de metadatos y al servidor WebDAV. El ejemplo enlaza WebDAV a la interfaz local porque rclone escucha en la dirección especificada con --addr; si necesitas acceso remoto, configura autenticación, TLS y reglas de red adecuadas [3].
• Protege y respalda el motor de metadatos: contiene la información necesaria para interpretar los datos guardados en el backend.
• Prueba con un sistema de archivos nuevo antes de migrar datos o cambiar de backend.
• Conserva la misma configuración de metadatos al montar el sistema que se creó con ella. No inicialices un sistema diferente por accidente.

WebDAV y S3 son opciones de almacenamiento de datos; JuiceFS necesita además su motor de metadatos para construir el sistema de archivos. Elegir el endpoint, guardar la configuración de forma segura y conservar los metadatos son pasos esenciales para poder montar el mismo volumen de manera fiable.

📚 Fuentes consultadas

1. Standalone Mode — JuiceFS
2. How to Set Up Object Storage — JuiceFS
3. rclone serve webdav — rclone
4. Command Reference — JuiceFS

Imagen