Saltar al contenido
Logotipo de Aurabase
aurabase

Almacenamiento

API REST por proyecto en almacenamiento S3 (SeaweedFS S3), transformaciones de imágenes sobre la marcha con caché derivada, URL firmadas HMAC, depósitos públicos o privados, papelera y restauración.

Explicación6 min leerNivel intermedioRevisado el 15 abr 2026

Esta página fue traducida automáticamente. La versión en inglés es autorizada.

Un depósito, un origen, una CDN#

El aura-storage El servicio gestiona sus archivos binarios: carga, descarga, transformaciones de imágenes, URL firmadas, papelera. Expone su propio API DESCANSO bajo /v1/storage/{project_id} y depende del almacenamiento S3 (SeaweedFS S3) internamente; las herramientas S3 (rclone, boto3) no se conectan a él directamente.

Los objetos se organizan en depósitos . Cada depósito tiene una política (pública o privada), límites de tamaño, un TTL opcional y un conjunto de políticas RLS que controlan quién puede leer/escribir cada ruta.

Información

Los metadatos se encuentran en el esquema del proyecto: storage_buckets, storage_objects, storage_derivatives, storage_project_settings, storage_audit_log. Los bytes están en el almacenamiento S3.

Ruta → RLS → CDN → origen#

Durante una lectura, el servicio verifica el acceso a la ruta solicitada y luego entrega los bytes desde el almacenamiento. Si la consulta lleva parámetros de transformación, la derivada correspondiente se reutiliza si ya existe; de ​​lo contrario, se calcula y luego se almacena en caché. En la carga, el flujo se invierte: cliente → servicio → almacenamiento, después de escribir el control y los límites del depósito.

schematext
                              ┌──── derivative cache ────┐
   GET /v1/storage/{pid}/… ─▶ │ derivative cached?       │
                              │ no  ⇢ origin             │
                              └──────────┬───────────────┘
                                         │
                              ┌──────────▼───────────────┐
                              │ aura-storage             │
                              │  ─ access control        │
                              │  ─ transforms            │
                              │  ─ derivative cache      │
                              └──────────┬───────────────┘
                                         │
                                  S3 storage (SeaweedFS S3)

Seis habilidades nativas#

  • API REST por proyecto. Rutas /v1/storage/{project_id}/… en el almacenamiento S3 (SeaweedFS S3): esta no es una API S3: los SDK S3 no se conectan a ella.
  • Se transforma sobre la marcha. ancho, alto, ajuste, formato (jpeg/png/webp/gif), calidad, rotar, voltear. Cada combinación se almacena en caché como una derivada.
  • URL firmadas. HMAC firma en el método + depósito + clave + vencimiento. TTL 3600 s por defecto, rotación secreta por proyecto.
  • Carga multiparte. Carga simple en multipart/form-data, o init/part/complete para archivos grandes.
  • Papelera y restauración. Eliminación temporal: /trash enumera los objetos eliminados, /restore/{key} los restaura.
  • Depósitos públicos o privados. El depósito contiene la política de acceso, los límites de tamaño y la lista de tipos MIME autorizados.

Cuatro operaciones básicas#

avatar.tstypescript
const { data, error } = await aura.storage.upload('avatars', `${user.id}/${file.name}`, file, {
    contentType: file.type,
    upsert: true,
})

// Sin upsert, una ruta ya ocupada falla en 409 (código CONFLICTO)
Consejo

Las URL de transformación son inmutables según los parámetros. ?width=240&format=png y ?width=240&format=webp son dos URL distintas, por lo tanto, dos derivadas distintas: cada combinación solo se calcula una vez y luego se vuelve a leer desde el caché de derivadas.

RLS en rutas de objetos#

Los metadatos del objeto se encuentran en la tabla storage_objects del esquema del proyecto (columnas bucket_name, key, owner_id, metadata, deleted_at), con RLS habilitado. No hay ningún esquema storage ni función storage.foldername(): las políticas están escritas en las columnas.

políticas entregadas por defectosql
-- Leer: objeto propio o cualquier objeto de un depósito público
create policy storage_objects_select on storage_objects for select
  using (
    owner_id = auth.uid()
    or exists (select 1 from storage_buckets b
                  where b.name = storage_objects.bucket_name and b.public)
  );

-- Escritura: sólo tus propios objetos
create policy storage_objects_insert on storage_objects for insert
  with check (owner_id = auth.uid());

para ir más lejos#