İçeriğe geç
Aurabase Logosu
aura tabanı

Depolama

S3 depolama (SeaweedFS S3) üzerinde proje başına REST API, türev önbellek ile anında görüntü dönüştürmeleri, HMAC imzalı URL'ler, genel veya özel paketler, çöp kutusu ve geri yükleme.

Açıklama6 dk. okuSeviye orta düzey15 Nis 2026 tarihinde revize edildi

Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.

Bir paket, bir kaynak, bir CDN#

aura-storage hizmeti ikili dosyalarınızı yönetir: yükleme, indirme, resim dönüştürmeleri, imzalı URL'ler, çöp kutusu. /v1/storage/{project_id} altında kendi REST API'yi ortaya çıkarır ve dahili olarak S3 depolama alanına (SeaweedFS S3) güvenir - S3 araçları (rclone, boto3) ona doğrudan bağlanmaz.

Nesneler paketler halinde düzenlenir. Her pakette bir politika (genel veya özel), boyut sınırları, isteğe bağlı bir TTL ve her yolu kimin okuyabileceğini/yazabileceğini kontrol eden bir dizi RLS politikası bulunur.

Bilgi

Meta veriler proje şemasında bulunur: storage_buckets, storage_objects, storage_derivatives, storage_project_settings, storage_audit_log. Baytlar S3 depolama alanındadır.

Yol → RLS → CDN → köken#

Okuma sırasında hizmet, istenen yola erişimi kontrol eder ve ardından depodaki baytları sunar. Sorgu dönüşüm parametreleri taşıyorsa, karşılık gelen türev zaten mevcutsa yeniden kullanılır, aksi takdirde hesaplanır ve ardından önbelleğe alınır. Yüklemede akış tersine döner: istemci → hizmet → depolama, kontrol ve paket limitleri yazıldıktan sonra.

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

Altı yerel yetenek#

  • Proje başına REST API. Rotalar /v1/storage/{project_id}/… S3 depolamada (SeaweedFS S3) — bu bir S3 API değil: S3 SDK'lar buna bağlanmaz.
  • Anında dönüştürür. genişlik, yükseklik, sığdırma, format (jpeg/png/webp/gif), kalite, döndürme, çevirme. Her kombinasyon bir türev olarak önbelleğe alınır.
  • İmzalı URL'ler. HMAC yöntem + paket + anahtar + süre sonu imzası. Varsayılan olarak TTL 3600 s, proje başına gizli rotasyon.
  • Çok parçalı yükleme. Çok parçalı/form-veri biçiminde basit yükleme veya büyük dosyalar için başlatma/parçalama/tamamlama.
  • Çöp kutusu ve restorasyon. Geçici silme: /trash silinen nesneleri listeler, /restore/{key} onları geri yükler.
  • Genel veya özel paketler. Paket erişim politikasını, boyut sınırlarını ve yetkili MIME türlerinin listesini taşır.

Dört temel işlem#

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

// Yükseltme olmadan, zaten işgal edilmiş bir yol 409'da başarısız olur (CONFLICT kodu)
İpucu

Dönüşüm URL'leri parametrelere göre değiştirilemez. ?width=240&format=png ve ?width=240&format=webp iki farklı URL'dir, dolayısıyla iki farklı türevdir: her kombinasyon yalnızca bir kez hesaplanır ve ardından türev önbelleğinden yeniden okunur.

RLS nesne yollarında#

Nesne meta verileri, proje şemasının storage_objects tablosunda bulunur (sütunlar bucket_name, key, owner_id, metadata, deleted_at), RLS etkindir. storage şeması veya storage.foldername() işlevi yoktur: politikalar sütunlara yazılır.

varsayılan olarak gönderilen politikalarsql
-- Okuma: kendi nesnesi veya genel bir paketteki herhangi bir nesne
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)
  );

-- Yazma: yalnızca kendi nesneleriniz
create policy storage_objects_insert on storage_objects for insert
  with check (owner_id = auth.uid());

Daha ileri gitmek için#