Przejdź do treści
Logo Aurabase
aurabaza

Składowanie

Interfejs API REST na projekt w pamięci S3 (SeaweedFS S3), transformacje obrazów w locie z pochodną pamięcią podręczną, podpisane adresy URL HMAC, zasobniki publiczne lub prywatne, kosz i przywracanie.

Objaśnienie6 min przeczytanePoziom mediatorZmieniono 15 kwi 2026

Ta strona została przetłumaczona automatycznie. Wersja angielska jest miarodajna.

Jeden segment, jedno źródło, jeden CDN#

Usługa aura-storage zarządza Twoimi plikami binarnymi: wysyłaniem, pobieraniem, transformacjami obrazów, podpisanymi adresami URL, koszem. Udostępnia własne REST API pod /v1/storage/{project_id} i opiera się na pamięci masowej S3 (SeaweedFS S3) wewnętrznie — narzędzia S3 (rclone, boto3) nie łączą się z nim bezpośrednio.

Obiekty są zorganizowane w segmenty. Każdy segment ma politykę (publiczną lub prywatną), limity rozmiaru, opcjonalny czas TTL i zestaw zasad RLS kontrolujących, kto może czytać/zapisywać każdą ścieżkę.

Informacje

Metadane znajdują się w schemacie projektu: storage_buckets, storage_objects, storage_derivatives, storage_project_settings, storage_audit_log. Bajty znajdują się w pamięci S3.

Ścieżka → RLS → CDN → początek#

Podczas odczytu usługa sprawdza dostęp do żądanej ścieżki, a następnie udostępnia bajty z pamięci. Jeśli zapytanie zawiera parametry transformacji, odpowiednia pochodna jest ponownie wykorzystywana, jeśli już istnieje, w przeciwnym razie jest obliczana, a następnie buforowana. Podczas przesyłania przepływ jest odwrotny: klient → usługa → pamięć masowa, po zapisaniu limitów kontroli i zasobnika.

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

Sześć rodzimych umiejętności#

  • API REST na projekt. Trasy /v1/storage/{project_id}/… w pamięci S3 (SeaweedFS S3) — to nie jest S3 API: S3 SDK nie są do niego podłączane.
  • Przemienia się w locie. szerokość, wysokość, dopasowanie, format (jpeg/png/webp/gif), jakość, obrót, odwrócenie. Każda kombinacja jest buforowana jako pochodna.
  • Podpisane adresy URL. HMAC podpis metody + segment + klucz + data ważności. Domyślnie TTL 3600 s, tajna rotacja na projekt.
  • Przesyłanie wieloczęściowe. Proste przesyłanie w formacie multipart/form-data lub init/part/complete w przypadku dużych plików.
  • Śmieci i renowacja. Miękkie usuwanie: /trash wyświetla listę usuniętych obiektów, /restore/{key} przywraca je.
  • Zasobniki publiczne lub prywatne. Wiadro zawiera politykę dostępu, limity rozmiaru i listę autoryzowanych typów MIME.

Cztery podstawowe operacje#

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

// Bez upsert, ścieżka już zajęta kończy się niepowodzeniem w 409 (kod CONFLICT)
Wskazówka

Adresy URL transformacji są niezmienne według parametrów. ?width=240&format=png i ?width=240&format=webp to dwa różne adresy URL, a zatem dwie różne pochodne: każda kombinacja jest obliczana tylko raz, a następnie ponownie odczytywana z pamięci podręcznej pochodnych.

RLS na ścieżkach obiektów#

Metadane obiektu znajdują się w tabeli storage_objects schematu projektu (kolumny bucket_name, key, owner_id, metadata, deleted_at), z włączoną opcją RLS. Nie ma schematu storage ani funkcji storage.foldername(): zasady są zapisane w kolumnach.

zasady dostarczane domyślniesql
-- Przeczytaj: własny obiekt lub dowolny obiekt z publicznego zasobnika
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)
  );

-- Pisanie: tylko własne obiekty
create policy storage_objects_insert on storage_objects for insert
  with check (owner_id = auth.uid());

Aby pójść dalej#