コンテンツへスキップ
オーラベースのロゴ
オーラベース

ストレージ

S3 ストレージ上のプロジェクトごとの REST API (SeaweedFS S3)、派生キャッシュを使用したオンザフライ画像変換、HMAC 署名付き URL、パブリックまたはプライベート バケット、ゴミ箱と復元。

解説6 分 読み取りレベル 中間2026/04/15 に改訂

このページは自動翻訳されました。英語版が正式です。

1 つのバケット、1 つのオリジン、1 つの CDN#

aura-storage サービスは、バイナリ ファイル (アップロード、ダウンロード、画像変換、署名付き URL、ゴミ箱) を管理します。これは、独自の REST API を /v1/storage/{project_id} の下で公開し、内部的に S3 ストレージ (SeaweedFS S3) に依存します。S3 ツール (rclone、boto3) は直接接続しません。

オブジェクトはバケットに編成されます。各バケットには、ポリシー (パブリックまたはプライベート)、サイズ制限、オプションの TTL、および各パスを読み取り/書き込みできるユーザーを制御する一連の RLS ポリシーがあります。

情報

メタデータはプロジェクト スキーマ内に存在します: storage_buckets、 storage_objects、 storage_derivatives、 storage_project_settings、 storage_audit_log。バイトは S3 ストレージにあります。

パス → RLS → CDN → 原点#

読み取り中に、サービスは要求されたパスへのアクセスをチェックし、ストレージからバイトを提供します。クエリに変換パラメータが指定されている場合、対応する導関数が既に存在する場合は再利用され、存在しない場合は計算されてキャッシュされます。アップロードでは、制御とバケット制限を書き込んだ後、フローが逆になります。クライアント→サービス→ストレージです。

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

6つのネイティブアビリティ#

  • プロジェクトごとの REST API。 S3 ストレージ (SeaweedFS S3) 上で /v1/storage/{project_id}/… をルーティングします。これは S3 API ではありません。S3 SDK はプラグインされません。
  • その場で変換します。 幅、高さ、フィット、形式 (jpeg/png/webp/gif)、品質、回転、反転。各組み合わせは派生物としてキャッシュされます。
  • 署名付き URL。 HMAC メソッド + バケット + キー + 有効期限の署名。デフォルトでは TTL 3600、プロジェクトごとにシークレットローテーション。
  • マルチパートアップロード。 multipart/form-data での単純なアップロード、または大きなファイルの場合は init/part/complete。
  • ゴミ箱と復元。 論理的な削除: /trash は削除されたオブジェクトをリストし、/restore/{key} はそれらを復元します。
  • パブリックまたはプライベート バケット。 バケットには、アクセス ポリシー、サイズ制限、および承認された MIME タイプのリストが含まれます。

4つの基本操作#

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

// UPSERT を行わないと、すでに占有されているパスは 409 (CONFLICT コード) で失敗します。
ヒント

変換 URL はパラメータによって不変です。 ?width=240&format=png と ?width=240&format=webp は 2 つの異なる URL、つまり 2 つの異なる派生です。各組み合わせは 1 回だけ計算され、その後派生キャッシュから再読み取りされます。

オブジェクト パス上の RLS#

オブジェクトのメタデータは、 RLS が有効な状態で、プロジェクト スキーマの storage_objects テーブル (列 bucket_name、 key、 owner_id、 metadata、 deleted_at) に存在します。 storage スキーマも storage.foldername() 関数もありません。ポリシーは列に書き込まれます。

デフォルトで配信されるポリシーsql
-- 読み取り: 独自のオブジェクト、またはパブリック バケットの任意のオブジェクト
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)
  );

-- 書き込み: 自分のオブジェクトのみ
create policy storage_objects_insert on storage_objects for insert
  with check (owner_id = auth.uid());

さらに進むには#