Un S3 propio y liviano con Garage
Cómo armé un almacenamiento compatible con S3 con Garage en Dokploy, con un bucket que borra sus archivos a los 14 días, tope de tamaño y lectura pública sin listado.
Necesitaba un lugar donde subir videos temporalmente para que un servicio externo los descargara desde una URL pública. Podría haber usado un almacenamiento en la nube, pero quería algo propio, compatible con S3 (para usar cualquier herramienta existente) y que no se comiera la RAM del servidor. Probé Garage y se quedó.
Por qué Garage y no MinIO
MinIO es la opción más conocida para S3 autoalojado, pero Garage tiene algunas ventajas para un home lab:
- Es muy liviano. Está escrito en Rust y usa muy poca memoria en reposo.
- Pensado para hardware modesto y para clústeres distribuidos en distintas ubicaciones, aunque funciona perfecto con un solo nodo.
- Licencia AGPL, desarrollado por una asociación sin fines de lucro (Deuxfleurs).
- Tiene un modo web: sirve el contenido de un bucket como sitio estático, sin firma.
Lo que no tiene: una interfaz web completa de administración incluida (se maneja por línea de comandos o por su API de administración) y no implementa todas las funciones de S3. Para subir, bajar y expirar archivos, sobra.
La configuración
Garage se configura con un archivo TOML. Para un solo nodo, lo esencial:
metadata_dir = "/var/lib/garage/meta"
data_dir = "/var/lib/garage/data"
db_engine = "lmdb"
replication_factor = 1
rpc_bind_addr = "[::]:3901"
rpc_secret = "GENERAR_CON_openssl_rand_-hex_32"
[s3_api]
s3_region = "garage"
api_bind_addr = "[::]:3900"
root_domain = ".s3.ejemplo.com.ar"
[s3_web]
bind_addr = "[::]:3902"
root_domain = ".ejemplo.com.ar"
index = "index.html"
[admin]
api_bind_addr = "[::]:3903"
admin_token = "OTRO_SECRETO"
replication_factor = 1 indica que hay una sola copia de cada dato: no hay redundancia, así que el bucket entra en mis backups como cualquier otro volumen. En versiones viejas de Garage la opción se llamaba replication_mode.
El despliegue en Dokploy
Lo levanté como Docker Compose con la imagen oficial dxflrs/garage, el archivo de configuración montado y dos volúmenes para metadatos y datos. En Dokploy configuré dos dominios hacia dos puertos del mismo servicio:
s3.ejemplo.com.ar→ puerto 3900 (API S3, para subir).videos.ejemplo.com.ar→ puerto 3902 (modo web, para leer).
El puerto de administración (3903) no tiene dominio: solo se usa desde adentro.
Inicializar el nodo
Garage necesita que le digas qué capacidad tiene cada nodo. Desde el contenedor:
garage status
garage layout assign -z casa -c 50G <ID_DEL_NODO>
garage layout apply --version 1
El ID aparece en garage status. La zona (casa) es una etiqueta; en un solo nodo, cualquier nombre sirve.
Bucket, clave y permisos
garage bucket create videos
garage key create clave-videos
garage bucket allow --read --write --owner videos --key clave-videos
garage bucket set-quotas videos --max-size 10GiB
key create muestra el Access Key ID y el Secret. Guardalos bien: son las credenciales para subir.
El tope de tamaño evita que un error llene el disco del servidor.
Lectura pública sin listado
garage bucket website --allow videos
Con root_domain = ".ejemplo.com.ar" en [s3_web], Garage relaciona el nombre videos.ejemplo.com.ar con el bucket videos. Cualquiera que tenga la URL exacta de un archivo lo puede bajar:
https://videos.ejemplo.com.ar/nombre-del-archivo.mp4
Lo importante: el modo web no lista el contenido del bucket. Entrar a la raíz devuelve 404. Para descargar algo hay que saber el nombre exacto. Para mi caso de uso (un servicio que recibe la URL de un video recién subido) es justo lo que hace falta.
Que los archivos se borren solos
Garage soporta reglas de ciclo de vida de S3. Con la herramienta aws (o cualquier cliente S3), definí que los archivos se borren a los 14 días y que las subidas multiparte abandonadas se limpien al día:
{
"Rules": [
{
"ID": "expirar-14-dias",
"Status": "Enabled",
"Filter": { "Prefix": "" },
"Expiration": { "Days": 14 },
"AbortIncompleteMultipartUpload": { "DaysAfterInitiation": 1 }
}
]
}
aws s3api put-bucket-lifecycle-configuration \
--endpoint-url https://s3.ejemplo.com.ar --region garage \
--bucket videos --lifecycle-configuration file://ciclo.json
Subir archivos
Cualquier cliente S3 sirve. Con aws:
aws s3 cp video.mp4 s3://videos/ --endpoint-url https://s3.ejemplo.com.ar --region garage
Dos detalles que me costaron: la región tiene que ser la misma de s3_region (garage), y algunos clientes necesitan que actives el estilo de rutas (path-style) en lugar de subdominios por bucket.
Resultado
Un S3 propio que consume casi nada, con espacio acotado, limpieza automática y lectura pública sin exponer el listado. Para guardar datos importantes le faltaría redundancia, pero para archivos temporales es ideal.