> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# ファイルストレージ

オブジェクトストレージコントラクト経由のワークスペーススコープ付きアップロード。

## 初心者向けのウォークスルー

前提条件: 以下の 2 つの初心者向けガイドを読み、Web ローカルのセットアップを完了し、エディターでルートにあるこのモノリポジトリを開きます。 Web 設定は `apps/web/.env.local` に属します。 Next.js はルート `.env` を読み取りません。デフォルトのフェイク モードの `/dashboard` はデータベースなしのデモです。 `/auth` には移行されたデータベースが必要です。

簡単に説明すると、ワークスペースは 1 つのチームの個別のユーザー、データ、設定です。サーバーは信頼できるバックエンドです。プロバイダー キーがブラウザーや電話コードに含まれないようにします。移行は、テーブルを作成または更新する、バージョン管理されたデータベースの変更です。 AI モデルは答えを返すエンジンです。モデル カタログは、使用可能なモデル ID と価格のサーバーのリストです。プロバイダーは、AI、電子メール、請求サービスなどの外部サービスです。資格は、ワークスペースで機能を使用できるようにする付与です。 Webhook は、あるサービスが別のサービスの URL に送信するメッセージです。

1. 認証情報なしのトライアルの場合は、`STORAGE_PROVIDER=memory` を保持します。このチェックアウトに表示されるアップロード コントロールがない場合は、小さなサンプル イメージをワイヤリングする前に、コーディング エージェントに `apps/web/app/api/storage/avatar/route.ts`、`apps/web/app/api/storage/logo/route.ts`、`apps/web/app/api/storage/organization-logo/route.ts`、および一致する設定ページを検査するよう依頼してください。

2. 永続性を確認するには、`apps/web/.env.local` で `STORAGE_PROVIDER=s3`、`STORAGE_REGION`、および `STORAGE_BUCKET` を設定し、サーバーのみのテスト資格情報をローカルに追加して、再起動します。

3. イメージがストレージから再ロードされます。メモリ ファイルはプロセスが再起動されると消えます。 S3 エラーについては、バケット、エンドポイント、アクセス ポリシーを確認してください。

カスタム コードの場合は、提供された `prompts/README.md` から始めて、最も近いプロンプト (アプリ画面の場合は `prompts/new-app-screen.md`、パブリック ページの場合は `prompts/new-landing-page.md`) をコピーします。サーバー、データベース、またはプロバイダーの作業については、コーディング エージェントにこのガイドのタスクを与え、`AGENTS.md`、`.ai/PROJECT_CONTEXT.md`、および一致する `.ai/` ミラーを読み取るように依頼します。ここで指定されている正確なソース ファイルを調べてください。ファイルをリストし、編集前にチェックします。ワークスペースの所有権とサーバーのみの秘密を保持します。そして差分を見せてください。必要な動作、入力フィールドと出力フィールド、許可されるロール、予想される成功とエラー、テスト アカウント、プロバイダー、またはデバイスを指定します。サンプル値を使用します。絶対に本当の秘密を貼り付けないでください。

[始める前に](https://supastack.dev/ja/docs/web/before-you-start.md)

【端末の基本】(/docs/web/terminal-basics)

[Webローカル設定](https://supastack.dev/ja/docs/web/ship-in-5-minutes.md)

[エージェント プロンプトとプロジェクト メモリ](https://supastack.dev/ja/docs/web/agents.md)


## ストレージ バックエンドを選択します

`STORAGE_PROVIDER=memory` は認証情報不要のデフォルトです。`local` は `STORAGE_LOCAL_DIR`（デフォルトは `./.data/storage`、本番環境では明示的な指定が必須）配下のディスクにオブジェクトを書き込み、単一サーバー構成向けに `/api/storage/local/[...key]` の HMAC 署名付き期限付き URL（`STORAGE_LOCAL_SIGNING_SECRET`、未設定時は `AUTH_SECRET` にフォールバック）経由で配信します。`s3` は `apps/web/src/storage-runtime.ts` を使用して `@supastack/storage` コントラクト上に AWS SDK クライアントを構成し、デフォルトでパススタイル URL が有効な Supabase Storage や MinIO をサポートします。

```
STORAGE_PROVIDER=s3
STORAGE_REGION=us-east-1
STORAGE_BUCKET=your-product-bucket
# Set STORAGE_ACCESS_KEY_ID and STORAGE_SECRET_ACCESS_KEY on the server.
# Optional: STORAGE_ENDPOINT, STORAGE_FORCE_PATH_STYLE, STORAGE_PUBLIC_BASE_URL
# Self-hosted single-server disk storage:
# STORAGE_PROVIDER=local
# STORAGE_LOCAL_DIR=./.data/storage
# STORAGE_LOCAL_SIGNING_SECRET=
# Local MinIO Compose overrides: MINIO_ROOT_USER / MINIO_ROOT_PASSWORD
```


## アップロード境界を再利用する

出荷されるルートには、`/api/storage/` の下のオブジェクト、アバター、プロフィール ロゴ、および組織ロゴが含まれます。 ID/ワークスペースの権限を解決し、保存する前にアップロードの形式を検証します。任意のクライアント オブジェクト キーを受け入れるのではなく、選択したルートのサイズ/タイプ ポリシーを検査します。

パブリック URL はプレゼンテーションであり、承認ではありません。保護されたコンテンツをアプリケーションの検証済み読み取り境界の内側に保持し、製品データのバケット/CDN ポリシーを構成します。


## 実際のストレージの動作をテストする

アップロードの許可/拒否、MIME とサイズの拒否、外部ワークスペースのパス、オブジェクトの欠落、プロバイダーの障害をテストします。メモリ モードはプロセス間で持続しません。リリース前に、選択したバックエンドに対してストレージと取得を検証します。

[Supabase ストレージのセットアップ](https://supastack.dev/ja/docs/web/project-structure.md)

[ルート在庫のアップロード](https://supastack.dev/ja/docs/web/project-structure.md)


## インストールとセットアップ

STORAGE_PROVIDER がアダプターを選択します: テストとローカル開発には memory、任意の S3 互換バケットには s3(STORAGE_BUCKET、STORAGE_ENDPOINT、STORAGE_ACCESS_KEY_ID、STORAGE_SECRET_ACCESS_KEY、STORAGE_PUBLIC_BASE_URL)。認証情報はサーバー専用のままです。

packages/storage は ObjectStorage コントラクト(オブジェクトロケーターへの put/get/delete)に加え、assertWorkspaceObjectKey と buildWorkspaceObjectKey を提供し、保存されるすべてのオブジェクトがワークスペースと目的(avatar、file、logo)で名前空間化されるようにします。

```
Uploads and reads go through authenticated routes:
  /api/storage/objects
  /api/storage/avatar
  /api/storage/logo
  /api/storage/organization-logo
```


## 実装ワークフロー

アップロードは認証済みルート層の後ろに置きます: ワークスペースを解決し、コンテンツタイプとサイズを検証し、ワークスペーススコープのキーを構築してからアダプター経由で保存します。オブジェクトが意図的に公開される場合を除き、読み取りも同様に配信します。

アバターと組織ロゴには独自の検証を持つ専用ルートがあり、任意のプロダクトファイルは宣言された目的と共に /objects を経由します。


## 検証とトラブルシューティング

匿名アップロードが拒否されること、あるワークスペースが別のオブジェクトキーを読めないこと、大きすぎる・許可されていないコンテンツタイプが失敗すること、削除されたオブジェクトが解決されなくなることを確認します。テストでは memory アダプターを使い、実バケットはオプションの smoke パスで検証してください。


## 次へ

[AI 機能](https://supastack.dev/ja/docs/web/ai.md)