Lagerung
REST-API pro Projekt auf S3-Speicher (SeaweedFS S3), spontane Bildtransformationen mit abgeleitetem Cache, HMAC signierte URLs, öffentliche oder private Buckets, Papierkorb und Wiederherstellung.
Ein Bucket, ein Ursprung, ein CDN#
Der Dienst aura-storage verwaltet Ihre Binärdateien: Upload, Download, Bildtransformationen, signierte URLs, Papierkorb. Es stellt seine eigene REST-API unter /v1/storage/{project_id} zur Verfügung und verlässt sich intern auf S3-Speicher (SeaweedFS S3) – die S3-Tools (rclone, boto3) stellen keine direkte Verbindung dazu her.
Objekte sind in Buckets organisiert. Jeder Bucket verfügt über eine Richtlinie (öffentlich oder privat), Größenbeschränkungen, eine optionale TTL und eine Reihe von RLS-Richtlinien, die steuern, wer jeden Pfad lesen/schreiben kann.
Die Metadaten befinden sich im Projektschema: storage_buckets, storage_objects, storage_derivatives, storage_project_settings, storage_audit_log. Die Bytes befinden sich im Speicher S3.
Pfad → RLS → CDN → Ursprung#
Während eines Lesevorgangs prüft der Dienst den Zugriff auf den angeforderten Pfad und stellt dann die Bytes aus dem Speicher bereit. Wenn die Abfrage Transformationsparameter enthält, wird die entsprechende Ableitung wiederverwendet, sofern sie bereits vorhanden ist, andernfalls berechnet und dann zwischengespeichert. Beim Hochladen ist der Ablauf umgekehrt: Client → Dienst → Speicher, nach dem Schreiben von Kontroll- und Bucket-Limits.
┌──── derivative cache ────┐
GET /v1/storage/{pid}/… ─▶ │ derivative cached? │
│ no ⇢ origin │
└──────────┬───────────────┘
│
┌──────────▼───────────────┐
│ aura-storage │
│ ─ access control │
│ ─ transforms │
│ ─ derivative cache │
└──────────┬───────────────┘
│
S3 storage (SeaweedFS S3)
Sechs native Fähigkeiten#
- REST-API pro Projekt. leitet /v1/storage/{project_id}/… auf S3-Speicher (SeaweedFS S3) – dies ist keine S3-API: S3 SDKs lassen sich nicht darin einbinden.
- Verwandelt sich im Handumdrehen. Breite, Höhe, Passform, Format (JPEG/PNG/WebP/GIF), Qualität, Drehen, Spiegeln. Jede Kombination wird als Ableitung zwischengespeichert.
- Signierte URLs. HMAC Signatur auf Methode + Bucket + Schlüssel + Ablauf. TTL 3600 s standardmäßig, geheime Rotation pro Projekt.
- Mehrteiliger Upload. Einfacher Upload in Multipart/Formulardaten oder init/part/complete für große Dateien.
- Papierkorb und Wiederherstellung. Vorläufiges Löschen: /trash listet gelöschte Objekte auf, /restore/{key} stellt sie wieder her.
- Öffentliche oder private Buckets. Der Bucket enthält die Zugriffsrichtlinie, Größenbeschränkungen und die Liste der autorisierten MIME-Typen.
Vier Grundoperationen#
const { data, error } = await aura.storage.upload('avatars', `${user.id}/${file.name}`, file, {
contentType: file.type,
upsert: true,
})
// Ohne Upsert schlägt ein bereits belegter Pfad in 409 fehl (CONFLICT-Code)
Transformations-URLs sind durch Parameter unveränderlich. ?width=240&format=png und ?width=240&format=webp sind zwei unterschiedliche URLs und daher zwei unterschiedliche Ableitungen: Jede Kombination wird nur einmal berechnet und dann erneut aus dem Ableitungscache gelesen.
RLS auf Objektpfaden#
Objektmetadaten befinden sich in der Tabelle storage_objects des Projektschemas (Spalten bucket_name, key, owner_id, metadata, deleted_at), wobei RLS aktiviert ist. Es gibt kein storage-Schema und keine storage.foldername()-Funktion: Richtlinien werden in die Spalten geschrieben.
-- Lesen: eigenes Objekt oder ein beliebiges Objekt aus einem öffentlichen 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)
);
-- Schreiben: nur Ihre eigenen Objekte
create policy storage_objects_insert on storage_objects for insert
with check (owner_id = auth.uid());