コンテンツへスキップ
supastack
ドキュメントを閲覧
WebNext.js

For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ja/docs/web/storage.md (or send Accept: text/markdown).

ファイルストレージ

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

このガイドについて質問
開くアプリ

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

前提条件: 以下の 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/ ミラーを読み取るように依頼します。ここで指定されている正確なソース ファイルを調べてください。ファイルをリストし、編集前にチェックします。ワークスペースの所有権とサーバーのみの秘密を保持します。そして差分を見せてください。必要な動作、入力フィールドと出力フィールド、許可されるロール、予想される成功とエラー、テスト アカウント、プロバイダー、またはデバイスを指定します。サンプル値を使用します。絶対に本当の秘密を貼り付けないでください。

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

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

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

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

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 パスで検証してください。

よくある質問

14 件の質問

supastack とは何ですか？

supastack は AI SaaS 製品を構築するためのモジュラー基盤です。共通インフラをまとめて提供するので、製品固有の機能に集中できます。

Web とモバイルに対応していますか？

はい。supastack には Web とモバイル体験の出発点として Next.js アプリと Expo アプリが含まれています。

どの認証が含まれていますか？

Better Auth がメール/パスワード、OTP、ソーシャルログインをカバーします。個人ワークスペースはアカウントと一緒にプロビジョニングされ、初日からレコードが境界内に収まります。

AI はどうサポートされていますか？

supastack には設定可能なマルチプロバイダー AI、使用量追跡、予算、暗号化された自前キー（BYOK）サポートが含まれています。

サブスクリプションはどう管理されますか？

このキット上に構築された製品では、Stripe 課金・サブスクリプション・権限が有料アクセスの基盤になります。プロバイダーの秘密はサーバー側に留まります。

製品固有のコードはどこに置きますか？

製品固有の機能は別のコードベースに置き、製品側が supastack の基本モジュールを設定・統合します。

supastack の価格は？

キットは生涯アップデート付きの一回払いです：単一フレームワーク 249 ドル（期間限定のローンチ価格 — 通常価格 349 ドルから 100 ドル割引）、または全フレームワーク（Next.js・iOS・Android）499 ドル（期間限定のローンチ価格 — 通常価格 599 ドルから 100 ドル割引）、追加開発者シート 1 席 75 ドル。キットのサブスクリプションはありません。このサイトのチェックアウトはライセンスキーをメールで配信し、GitHub 招待でリポジトリアクセスを提供します。

ワークスペースはどうデータを囲いますか？

ユーザーレコードは workspaceId でスコープされます。認証、権限、AI 使用量、課金イベント、監査エントリは個人ワークスペースの境界内に留まります。

バックグラウンドジョブはどう機能しますか？

Trigger.dev が明示的なジョブランタイムです。JobRunner コントラクトは enqueue・status・cancel のみを約束し、ワークフロー意味論は Trigger.dev 固有で明示的です。

メールとアウトリーチの違いは？

トランザクションメールはタスク完了通知などの製品ワークフローをカバーします。コールドアウトリーチやキャンペーンは製品自身に属し、このキットのメールモジュールの外です。

モバイルの購入はどのように機能しますか？

モバイルでは RevenueCat によるネイティブ購入と復元に対応し、アクセス権をサーバーで検証します。公開前にストアアカウントを設定し、実機テストを完了してください。Web 課金は別に管理します。

AI プロバイダーのキーはどこにありますか？

BYOK 認証情報は暗号化され、サーバー側に留まります。キーはログでサニタイズされ、使用量と予算はワークスペースレベルで可視です。

チェックアウトで使える支払い方法は？

Stripe ホストのチェックアウトはカードを受け付け、Stripe アカウントでウォレットを有効にすれば Alipay と WeChat Pay も提供できます——中国の購入者に便利です。ウォレット認可は非同期で確定するため、決済完了と同時にライセンスページが更新されます。

返金を受けることはできますか？

リポジトリへのアクセス権を取得した後は、supastack は永久にあなたのものとなるため、返金はできません。ですがご安心ください。生涯アップデートを含む完全なソースコードを入手し、ご自身やクライアントのために無制限にプロダクトを構築・公開できます。コードの転売や、リポジトリをスターターキットやテンプレートとして再配布することのみ禁止されています。

JA
テーマ