Naar de inhoud springen
Aurabase-logo
aurabasis

Opslag

REST API per project op S3-opslag (SeaweedFS S3), on-the-fly beeldtransformaties met afgeleide cache, HMAC ondertekende URL's, openbare of privé-buckets, prullenbak en herstel.

Uitleg6 min lezenNiveau tussenproductHerzien op 15 apr 2026

Deze pagina is automatisch vertaald. De Engelse versie is gezaghebbend.

Eén bucket, één oorsprong, één CDN#

De service aura-storage beheert uw binaire bestanden: uploaden, downloaden, afbeeldingstransformaties, ondertekende URL's, prullenbak. Het stelt zijn eigen REST API bloot onder /v1/storage/{project_id} en vertrouwt intern op S3 opslag (SeaweedFS S3) - de S3 tools (rclone, boto3) maken er geen directe verbinding mee.

Objecten zijn georganiseerd in buckets. Elke bucket heeft een beleid (openbaar of privé), groottelimieten, een optionele TTL en een set RLS-beleidsregels die bepalen wie elk pad kan lezen/schrijven.

Info

De metagegevens bevinden zich in het projectschema: storage_buckets, storage_objects, storage_derivatives, storage_project_settings, storage_audit_log. De bytes bevinden zich in S3-opslag.

Pad → RLS → CDN → oorsprong#

Tijdens het lezen controleert de service op toegang tot het gevraagde pad en levert vervolgens de bytes uit de opslag. Als de query transformatieparameters bevat, wordt de overeenkomstige afgeleide hergebruikt als deze al bestaat, anders berekend en vervolgens in de cache opgeslagen. Bij het uploaden is de stroom omgekeerd: client → service → opslag, na het schrijven van controle- en bucketlimieten.

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

Zes inheemse vaardigheden#

  • REST API per project. Routes /v1/storage/{project_id}/… op S3 opslag (SeaweedFS S3) — dit is geen S3 API: S3 SDK's kunnen er niet op worden aangesloten.
  • Transformeert direct. breedte, hoogte, pasvorm, formaat (jpeg/png/webp/gif), kwaliteit, roteren, spiegelen. Elke combinatie wordt in de cache opgeslagen als een afgeleide.
  • Ondertekende URL's. HMAC handtekening op methode + bucket + sleutel + vervaldatum. Standaard TTL 3600 s, geheime rotatie per project.
  • Uploaden uit meerdere delen. Eenvoudig uploaden in meerdelige/formuliergegevens, of init/part/complete voor grote bestanden.
  • Prullenbak en herstel. Zachte verwijdering: /trash toont verwijderde objecten, /restore/{key} herstelt ze.
  • Openbare of privé-buckets. De bucket bevat het toegangsbeleid, de groottelimieten en de lijst met geautoriseerde MIME-typen.

Vier basisbewerkingen#

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

// Zonder ups mislukt een reeds bezet pad in 409 (CONFLICT-code)
Tip

Transformatie-URL's zijn onveranderlijk door parameters. ?width=240&format=png en ?width=240&format=webp zijn twee verschillende URL's, dus twee verschillende afgeleiden: elke combinatie wordt slechts één keer berekend en vervolgens opnieuw gelezen vanuit de afgeleide cache.

RLS op objectpaden#

Metagegevens van objecten bevinden zich in de tabel storage_objects van het projectschema (kolommen bucket_name, key, owner_id, metadata, deleted_at), met RLS ingeschakeld. Er is geen storage-schema noch een storage.foldername()-functie: het beleid staat in de kolommen geschreven.

beleid dat standaard wordt geleverdsql
-- Lees: eigen object, of een ander object uit een openbare bucket
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)
  );

-- Schrijven: alleen je eigen objecten
create policy storage_objects_insert on storage_objects for insert
  with check (owner_id = auth.uid());

Om verder te gaan#