Saltar al contenido
Berth

Guarda los audiolibros en un almacenamiento compatible con S3

Actualizado el 27 de octubre de 2026

Berth puede guardar los libros en cualquier bucket compatible con S3 en lugar del disco del servidor. El servidor guarda la biblioteca y decide quién puede escuchar; el audio en sí puede viajar desde el bucket o una CDN directamente a los teléfonos.

Por qué un almacenamiento de objetos

Proveedores compatibles

Sirve cualquier servicio compatible con S3. El panel web tiene ajustes predefinidos que rellenan el endpoint y la región para AWS S3, Cloudflare R2, Yandex Cloud, Backblaze B2, Bunny Storage y MinIO. Para Cloudflare R2 hay además un asistente que crea el bucket y las claves por ti.

Conectar un bucket

  1. En la consola de tu proveedor, crea un bucket y una clave de acceso con permisos de lectura y escritura sobre él.
  2. Añade una regla CORS al bucket: origen, tu dirección de Berth; métodos, GET, HEAD, PUT; cabeceras, *. El panel web sube los archivos desde el navegador directamente al bucket, así que esta regla es obligatoria.
  3. En el panel web de Berth abre los ajustes de almacenamiento, añade un almacenamiento, elige «Bucket S3» y escoge un ajuste predefinido o rellena los campos tú mismo.
  4. Rellena nombre, bucket, endpoint (vacío para AWS), región (us-east-1 si se deja vacía), ID de clave de acceso y clave de acceso secreta. Activa las direcciones de tipo ruta para MinIO; se activan solas con una dirección IP o localhost.
  5. Pulsa «Comprobar conexión»: Berth escribe, vuelve a leer y borra un pequeño archivo de prueba y comprueba CORS desde las direcciones de tu servidor.
  6. Haz que el almacenamiento sea el predeterminado: los libros nuevos van al almacenamiento predeterminado.

Las claves se guardan cifradas con la clave del servidor, secret.key, y no se vuelven a mostrar nunca.

Cómo llega el audio a los teléfonos

Sin firma, los archivos detrás de una CDN se abren con un enlace que no caduca nunca. Sus nombres son hashes SHA-256 y no se pueden adivinar, pero revocar un dispositivo no cierra los enlaces que ya tiene. La autenticación por token de Bunny CDN hace que los enlaces caduquen a las 6 horas.

ModoCómo funcionaCuándo usarlo
Enlaces directos (predeterminado)Los teléfonos reciben un enlace firmado al bucket que dura 15 minutosQuita carga al servidor
A través del servidorEl servidor transmite el archivo; los enlaces duran 6 horas y dejan de funcionar al instante cuando se revoca un dispositivoLos teléfonos no pueden acceder al bucket
A través de una CDNLos enlaces apuntan a una CDN o a una dirección pública del bucketLo más rápido cuando el bucket tiene una CDN

Conviene saber

Preguntas

¿Berth necesita acceso público al bucket?

No. En el modo predeterminado el bucket sigue siendo privado y los teléfonos reciben enlaces firmados que caducan a los 15 minutos.

La comprobación dice que el bucket no acepta subidas desde un navegador. ¿Qué hago?

Añade la regla CORS: origen, la dirección de Berth; métodos, GET, HEAD, PUT; cabeceras, *. Después vuelve a ejecutar la comprobación.