Montar un Bucket S3 como Sistema de Archivos en un VPS con ZeroFS y JuiceFS

El almacenamiento de objetos es barato. Un VPS con un disco local grande no lo es. Así que el movimiento obvio es guardar el grueso de tus datos en un bucket S3 y pagar solo por el almacenamiento que realmente usas, mientras tu servidor se mantiene pequeño y rápido. El problema es que S3 habla HTTP, no POSIX, así que la mayoría de las aplicaciones no pueden escribir en él como en una carpeta normal.

Esa brecha es la que resuelven las capas de sistema de archivos. Se sitúan entre tus aplicaciones y el bucket, presentando un punto de montaje normal como /mnt/data mientras mueven los bytes hacia y desde el almacenamiento de objetos por detrás. Llevo un tiempo usando esta configuración en varios servidores, y que Bunny.net haya añadido una API compatible con S3 a su almacenamiento lo hizo mucho más atractivo, sobre todo porque su almacenamiento cuesta $0,01/GB sin tarifas de egress a través de su CDN.

Esta guía recorre dos herramientas que hacen bien el trabajo: ZeroFS y JuiceFS. Ambas convierten un bucket S3 en un sistema de archivos montable en un VPS, pero llegan ahí por caminos muy distintos. Te mostraré cómo configurar cada una contra un bucket de Bunny.net y luego te ayudaré a elegir.

Por qué montar S3 como sistema de archivos

Antes del cómo, aquí va el por qué. Apuntar un sistema de archivos al almacenamiento de objetos te da unas cuantas cosas que un disco de VPS normal no puede:

Eso sí, no es magia. Los viajes de ida y vuelta a S3 tardan entre 50 y 300 ms, así que sin caché local un montaje básico se siente dolorosamente lento con archivos pequeños. Ambas herramientas de abajo lo resuelven con una caché local, que es la razón principal para usarlas en lugar de algo más simple como s3fs.

Las dos opciones comparadas

ZeroFS y JuiceFS llegan al mismo destino con arquitecturas diferentes. Esto importa para la configuración y para qué cargas de trabajo maneja bien cada una.

La versión corta: ZeroFS es más simple porque guarda todo (incluidos los metadatos) en el bucket, así que no hay base de datos que ejecutar. JuiceFS está más probado a escala y permite que muchos clientes compartan un mismo sistema de archivos, pero necesita un motor de metadatos como Redis junto al almacenamiento de objetos.

Paso 1: Crear un bucket S3 en Bunny.net

Ambas herramientas necesitan un bucket compatible con S3. Así se crea uno en Bunny.net.

1. En el panel de Bunny, ve a Storage → Add Storage Zone
2. Dale un nombre (mínimo 4 caracteres, solo letras, números y guiones). Este nombre será tu nombre de bucket y tu access key
3. Activa la opción S3 Compatibility
4. Elige un nivel de almacenamiento y una región cercana a tu VPS
5. Activa la replicación en al menos una región extra (recomendado por durabilidad)
6. Confirma y añade la zona

Una vez creada, abre la pestaña Access y consigue tus credenciales. Las mapearás a los valores estándar de S3 así:

La compatibilidad con S3 funciona actualmente en Frankfurt (de), Nueva York (ny), Singapur (sg), Londres (uk), Estocolmo (se), Los Ángeles (la) y Johannesburgo (jh). Bunny solo admite URLs de tipo path (endpoint/nombre-bucket/clave), algo que ambas herramientas manejan sin problema.

Puedes probar las credenciales con la AWS CLI antes de seguir:

aws s3 ls s3://nombre-de-tu-zona/ \
  --endpoint-url https://de-s3.storage.bunnycdn.com

Si quieres ver con más detalle cómo se compara Bunny Storage en precio, escribí un desglose de Bunny Storage vs S3 vs Backblaze.

Requisitos previos

Para cualquiera de las dos herramientas necesitarás:

• Un VPS Linux (Ubuntu/Debian va muy bien aquí)
• Acceso root o sudo
• Un SSD local con algo de espacio libre para la caché (10 GB o más es un buen comienzo)
• Las credenciales S3 de Bunny de arriba

Si eres nuevo ejecutando servicios en un VPS, mi guía de Docker en Ubuntu cubre lo básico sobre almacenamiento y autoalojamiento.

Opción A: ZeroFS

ZeroFS es una herramienta en Rust que sirve un bucket S3 como sistema de archivos POSIX por NFS y 9P, o como dispositivo de bloque crudo por NBD. Todo corre en un único proceso en espacio de usuario, y los datos siempre se comprimen y cifran antes de salir de tu servidor. No hay base de datos aparte, lo que la hace la más sencilla de poner en marcha.

Instalar ZeroFS

El script de instalación descarga el binario precompilado adecuado para tu plataforma:

curl -sSfL https://sh.zerofs.net | sh

Para fijar una versión e instalar sin root:

curl -sSfL https://sh.zerofs.net | VERSION=v1.2.6 INSTALL_DIR=$HOME/.local/bin sh

Configurar ZeroFS

Genera una configuración inicial y edítala:

zerofs init   # escribe zerofs.toml

Aquí tienes un zerofs.toml funcional para un bucket de Bunny.net. Fíjate en la línea conditional_put, que explico más abajo:

[cache]
dir = "/var/cache/zerofs"
disk_size_gb = 10.0
memory_size_gb = 1.0

[storage]
url = "s3://nombre-de-tu-zona/zerofs-data"
encryption_password = "${ZEROFS_PASSWORD}"

[filesystem]
compression = "zstd-3"

[servers.nfs]
addresses = ["127.0.0.1:2049"]

[aws]
access_key_id = "${AWS_ACCESS_KEY_ID}"
secret_access_key = "${AWS_SECRET_ACCESS_KEY}"
endpoint = "https://de-s3.storage.bunnycdn.com"
default_region = "de"
conditional_put = "redis://localhost:6379"

El encryption_password no es opcional, ZeroFS no tiene modo sin cifrado. Guárdalo a buen recaudo, porque perderlo significa perder el acceso a todo lo que hay en el bucket.

Ejecutar ZeroFS

Exporta tus secretos y arranca el servidor:

export AWS_ACCESS_KEY_ID="nombre-de-tu-zona"
export AWS_SECRET_ACCESS_KEY="contraseña-de-tu-storage"
export ZEROFS_PASSWORD="una-frase-larga-y-aleatoria"

zerofs run -c zerofs.toml

Montar el sistema de archivos

ZeroFS ya está sirviendo NFS en 127.0.0.1:2049. Móntalo como cualquier recurso NFS:

sudo mkdir -p /mnt/data
sudo mount -t nfs -o nolock,vers=3 127.0.0.1:/ /mnt/data

Eso es todo. Cualquier cosa que escribas en /mnt/data se comprime, se cifra y se envía a tu bucket de Bunny, con las lecturas calientes servidas desde la caché local en microsegundos.

Ejecutarlo como servicio

Para cualquier cosa más allá de pruebas, ejecuta ZeroFS bajo systemd para que sobreviva a los reinicios. Crea /etc/systemd/system/zerofs.service:

[Unit]
Description=ZeroFS S3-backed filesystem
After=network-online.target redis-server.service
Wants=network-online.target

[Service]
Environment=AWS_ACCESS_KEY_ID=nombre-de-tu-zona
Environment=AWS_SECRET_ACCESS_KEY=contraseña-de-tu-storage
Environment=ZEROFS_PASSWORD=una-frase-larga-y-aleatoria
ExecStart=/usr/local/bin/zerofs run -c /etc/zerofs/zerofs.toml
Restart=on-failure

[Install]
WantedBy=multi-user.target

Luego actívalo:

sudo systemctl daemon-reload
sudo systemctl enable --now zerofs

ZeroFS también puede exponer el bucket como un dispositivo de bloque crudo por NBD, que es lo que hace posibles las demos de “correr ZFS sobre S3”. Eso va más allá de un montaje básico, pero está ahí si lo necesitas.

Opción B: JuiceFS

JuiceFS es un sistema de archivos distribuido maduro y ampliamente desplegado, construido sobre almacenamiento de objetos más un motor de metadatos aparte. Es totalmente compatible con POSIX, soporta miles de clientes concurrentes y se usa en producción para cargas de big data y machine learning. El compromiso es que ejecutas una base de datos de metadatos junto a él.

Instalar Redis para los metadatos

JuiceFS guarda los metadatos de los archivos en un motor como Redis, MySQL o SQLite. Para un solo VPS, Redis es la opción fácil. Puedes instalarlo directamente en el host o ejecutarlo en Docker, lo que encaje mejor con cómo gestionas la máquina.

sudo apt update
sudo apt install redis-server
sudo systemctl enable --now redis-server

services:
  redis:
    image: redis:7-alpine
    container_name: juicefs-redis
    restart: unless-stopped
    command: redis-server --appendonly yes
    ports:
      - "127.0.0.1:6379:6379"
    volumes:
      - ./redis-data:/data

docker compose up -d

Instalar JuiceFS

Un solo comando descarga el cliente más reciente:

curl -sSL https://d.juicefs.com/install | sh -

Comprueba que se instaló:

juicefs version

Formatear el sistema de archivos

El comando format inicializa el sistema de archivos, enlazando tu motor de metadatos con el bucket de Bunny. Ejecútalo una vez:

juicefs format \
  --storage s3 \
  --bucket https://de-s3.storage.bunnycdn.com/nombre-de-tu-zona \
  --access-key nombre-de-tu-zona \
  --secret-key contraseña-de-tu-storage \
  redis://localhost:6379/1 \
  myjfs

Algunas notas sobre los flags:

• --bucket usa la URL de tipo path que exige Bunny, con el nombre de tu zona como último segmento de la ruta
• redis://localhost:6379/1 es el motor de metadatos (base de datos 1 del Redis local)
• myjfs es el nombre del volumen, usado en comandos posteriores

Montar el sistema de archivos

Ahora móntalo, apuntando a la misma URL de Redis:

sudo mkdir -p /mnt/data
juicefs mount redis://localhost:6379/1 /mnt/data --background

JuiceFS mantiene una caché local (por defecto en /var/jfsCache) para que las lecturas repetidas sigan siendo rápidas. Puedes ajustar el tamaño de la caché al montar:

juicefs mount redis://localhost:6379/1 /mnt/data \
  --cache-size 10240 \
  --background

--cache-size está en MB, así que 10240 te da una caché local de 10 GB.

Ejecutarlo como servicio

JuiceFS puede generar un montaje compatible con systemd, pero el enfoque duradero más simple es un archivo de unidad en /etc/systemd/system/juicefs.service:

[Unit]
Description=JuiceFS mount
After=network-online.target redis-server.service
Wants=network-online.target

[Service]
Type=simple
ExecStart=/usr/local/bin/juicefs mount redis://localhost:6379/1 /mnt/data --cache-size 10240
ExecStop=/usr/local/bin/juicefs umount /mnt/data
Restart=on-failure

[Install]
WantedBy=multi-user.target

Actívalo:

sudo systemctl daemon-reload
sudo systemctl enable --now juicefs

Revisar el sistema de archivos

JuiceFS incluye comandos útiles de inspección:

juicefs status redis://localhost:6379/1   # muestra info del volumen
juicefs bench /mnt/data                   # ejecuta un benchmark rápido

Rendimiento y caché

Ninguna herramienta puede vencer a la física, la latencia de S3 es la que es, así que la caché local es lo que hace usable la experiencia. Unas cuantas cosas que conviene saber:

Para cargas que son sobre todo lecturas y escrituras secuenciales grandes (medios, backups, archivos), ambas herramientas vuelan una vez que la caché está caliente. Para acceso aleatorio a archivos pequeños, el rendimiento depende mucho del ratio de aciertos de caché.

¿Cuál deberías elegir?

Después de usar las dos, esta es mi regla general:

Elige ZeroFS si quieres la configuración más simple, estás en un solo nodo, te gusta que el cifrado sea obligatorio, o necesitas funciones de dispositivo de bloque como correr ZFS sobre S3. No tener una base de datos extra que cuidar es una ventaja real en un VPS pequeño. Combínalo con Cloudflare R2 o AWS S3 (la API de S3 de Bunny actualmente no devuelve ETags, que ZeroFS necesita).

Elige JuiceFS si necesitas varios servidores compartiendo un sistema de archivos, operas a mayor escala, quieres la opción más probada con la comunidad más amplia, ya ejecutas Redis, o usas el S3 de Bunny.net (JuiceFS funciona sin problemas con la API de S3 de Bunny). El motor de metadatos es trabajo extra, pero te da una consistencia y concurrencia que una herramienta de un solo nodo no puede igualar.

Para un servidor doméstico o un único VPS con una biblioteca multimedia o backups, me inclino por ZeroFS por la simplicidad. Para cualquier cosa compartida entre máquinas o que apunte a escala seria, JuiceFS es la apuesta más segura.

Solución de problemas

Preguntas frecuentes

Para terminar

Montar un bucket S3 como sistema de archivos solía significar pelearse con s3fs y aceptar un rendimiento pésimo con archivos pequeños. ZeroFS y JuiceFS lo arreglan con una caché local inteligente, y hacen que el almacenamiento de objetos sea de verdad usable como sistema de archivos de trabajo en un VPS.

Combina cualquiera de los dos con el almacenamiento de tarifa plana y sin egress de Bunny.net y obtienes capacidad elástica que cuesta una fracción de redimensionar el disco de tu servidor. Empieza con ZeroFS si quieres las menos piezas móviles, recurre a JuiceFS cuando necesites almacenamiento compartido o a gran escala.

Artículos relacionados

• Reseña de Bunny.net - la plataforma completa tras un año en producción
• Bunny Storage vs S3 vs Backblaze - precios de almacenamiento en la nube comparados
• Guía de Bunny Stream - alojamiento de vídeo en Bunny
• Instalar Dockge - gestiona stacks de Docker compose con volúmenes respaldados por bucket
• Instalar Docker en Ubuntu - configuración de Docker y Compose