cURL による Supabase へのファイルエクスポート
ローカルファイルを非公開の Supabase Storage にエクスポートするには、認証付きの POST でファイルのバイト列を送信し、オブジェクトをダウンロードして元のファイルと比較します。この手順では、通常の Auth ユーザーを二人使います。一人がファイルをアップロードして読み取り、もう一人が同じファイルをダウンロードして、アクセスポリシーによって拒否されることを確認します。
非公開バケットとポリシーの設定
管理権限のある Supabase プロジェクトと、メールアドレスとパスワードでサインインできる別々の Auth ユーザーが二人必要です。プロジェクトでメール確認が必要な場合は、完了させてください。詳しくはパスワードベースの Authを参照してください。Supabase アカウントを作成しただけでは、これらのアプリケーションユーザーは作成されません。
バケットのクイックスタートに従い、curl-exports という名前の新しい非公開 Storage バケットを作成します。MIME タイプを制限する場合は application/octet-stream を許可し、サイズ制限内のファイルを選んでください。この例では新規のバケットを使います。既存の storage.objects ポリシーも確認してください。このバケットに適用される許可ルールによって、アクセスが許可されることもあります。後述する別ユーザーでの確認では、実際に有効な読み取り権限を検証します。
次の SQL をプロジェクト管理者として一度実行します。サインインしたユーザーの UUID を名前に持つフォルダー内でのみ、アップロードと読み取りを許可します。
create policy "curl_exports_insert"
on storage.objects for insert to authenticated
with check (
bucket_id = 'curl-exports'
and (storage.foldername(name))[1] = (select auth.uid())::text
);
create policy "curl_exports_select"
on storage.objects for select to authenticated
using (
bucket_id = 'curl-exports'
and (storage.foldername(name))[1] = (select auth.uid())::text
and owner_id = (select auth.uid())::text
);
Storage のアクセス制御では、storage.objects ポリシーを説明しています。以下のアップロード処理ではユーザーのアクセストークンを使います。シークレットキーやサービスロールキーを使うと RLS が迂回され、非公開性の検証が無効になります。
シェルツールと認証情報の確認
Linux 上の Bash を使い、cURL、jq、および一般的なユーティリティである cmp、mktemp、rm を事前にインストールしてください。動作確認済みのバージョンは Bash 5.3.15、cURL 8.22.0、jq 1.8.2 です。これらは検証に使ったバージョンであり、厳密なバージョン固定ではありません。スクリプトは cURL の --fail-with-body オプションを使い、一時ファイルを作成する前に必要な各ツールを確認します。リクエストでは .curlrc の設定を無視します。セットアップコマンドは Bash で実行してください。
curl --disable --version && jq --version && bash --version
この手順では、検証したローカルスタックに合わせて、既存のレガシー
anon API キーを使います。Supabase は 2026年末までにレガシーキーを非推奨にする予定です。取得と移行については、API キーガイドを参照してください。スクリプトを実行するシェルで、そのスタックのプロジェクト URL、キー、バケットを設定します。
export SUPABASE_URL='https://YOUR_PROJECT_ID.supabase.co' \
SUPABASE_KEY='YOUR_ANON_KEY' \
SUPABASE_BUCKET='curl-exports'
認証情報マネージャーまたはジョブランナーから、SUPABASE_EMAIL、SUPABASE_PASSWORD、SUPABASE_OTHER_EMAIL、SUPABASE_OTHER_PASSWORD を環境変数として渡してください。最初のペアはアップロードするユーザー、次のペアはアクセスが拒否されるべきユーザーのものです。パスワードをシェルの履歴に残さないでください。プロジェクトキーは、Authorization ヘッダーのユーザー JWT の代わりにはなりません。
この例は、PostgreSQL 17.6 を使用するローカルの Supabase Auth v2.196.0 と Storage v1.74.0 で動作を検証しました。ホスト型プロジェクトの作成、TLS、ダッシュボードの設定、プランのクォータは、別途満たす必要がある前提条件です。ホスト型プロジェクトでは HTTPS を使ってください。ローカル開発スタックではループバック HTTP を使用できます。
一つのファイルのアップロード、ダウンロード、検証
以下を export-to-supabase.sh という名前の新しいファイルに保存してください。現在のシェルに読み込むのではなく、Bash で実行します。第一引数はローカルファイル、第二引数はアップロードするユーザーの UUID 配下のオブジェクトパスです。オブジェクトパスの各セグメントは ASCII の英字または数字で始まり、ASCII の英字、数字、スペース、ドット、アンダースコア、ハイフンのみを含む必要があります。ローカルファイル名は、このオブジェクト名の厳しい制約に従う必要はありません。
#!/usr/bin/env bash
set -euo pipefail
export LC_ALL=C
die() { printf '%s\n' "$1" >&2; exit 1; }
for tool in curl jq cmp mktemp rm; do
command -v "$tool" >/dev/null || die "Missing required tool: $tool"
done
[[ $# -eq 2 ]] || die 'Usage: bash export-to-supabase.sh LOCAL_FILE OBJECT_PATH'
: "${SUPABASE_URL:?Set SUPABASE_URL}" "${SUPABASE_KEY:?Set SUPABASE_KEY}"
: "${SUPABASE_BUCKET:?Set SUPABASE_BUCKET}"
: "${SUPABASE_EMAIL:?Set SUPABASE_EMAIL}" "${SUPABASE_PASSWORD:?Set SUPABASE_PASSWORD}"
: "${SUPABASE_OTHER_EMAIL:?Set SUPABASE_OTHER_EMAIL}"
: "${SUPABASE_OTHER_PASSWORD:?Set SUPABASE_OTHER_PASSWORD}"
file=$1
case "$file" in /*) ;; *) file="./$file" ;; esac
[[ -f "$file" && -r "$file" ]] || die 'Select a readable regular file'
object_path=$2
path_pattern='^[A-Za-z0-9][A-Za-z0-9._ -]*(/[A-Za-z0-9][A-Za-z0-9._ -]*)*$'
[[ "$object_path" =~ $path_pattern ]] || die 'Unsupported object path'
[[ "$SUPABASE_BUCKET" =~ ^[a-z0-9][a-z0-9-]*$ ]] || die 'Unsupported bucket name'
base_url=${SUPABASE_URL%/}
umask 077
work=$(mktemp -d)
trap 'rm -rf -- "$work"' EXIT
sign_in() {
AUTH_EMAIL=$1 AUTH_PASSWORD=$2 jq -n \
'{email: env.AUTH_EMAIL, password: env.AUTH_PASSWORD}' |
curl --disable --fail-with-body --silent --show-error \
"$base_url/auth/v1/token?grant_type=password" \
-H "apikey: $SUPABASE_KEY" -H 'Content-Type: application/json' \
--data-binary @- --output "$3" || die 'Password sign-in failed'
jq -e '.user.role == "authenticated"' "$3" >/dev/null || die 'Expected an authenticated Auth user'
}
sign_in "$SUPABASE_EMAIL" "$SUPABASE_PASSWORD" "$work/owner.json"
sign_in "$SUPABASE_OTHER_EMAIL" "$SUPABASE_OTHER_PASSWORD" "$work/other.json"
token=$(jq -er '.access_token | select(type == "string" and length > 0)' "$work/owner.json")
other_token=$(jq -er '.access_token | select(type == "string" and length > 0)' "$work/other.json")
user_id=$(jq -er '.user.id | select(type == "string" and length > 0)' "$work/owner.json")
other_id=$(jq -er '.user.id | select(type == "string" and length > 0)' "$work/other.json")
[[ "$user_id" != "$other_id" ]] || die 'Use two distinct Auth users'
encoded_path=$(jq -rn --arg path "$user_id/$object_path" \
'$path | split("/") | map(@uri) | join("/")')
object_url="$base_url/storage/v1/object/$SUPABASE_BUCKET/$encoded_path"
download_url="$base_url/storage/v1/object/authenticated/$SUPABASE_BUCKET/$encoded_path"
curl --disable --fail-with-body --silent --show-error --request POST "$object_url" \
-H "apikey: $SUPABASE_KEY" -H "Authorization: Bearer $token" \
-H 'Content-Type: application/octet-stream' \
--data-binary "@$file" --output "$work/upload.json" || die 'File upload failed'
curl --disable --fail-with-body --silent --show-error "$download_url" \
-H "apikey: $SUPABASE_KEY" -H "Authorization: Bearer $token" \
--output "$work/download.bin" || die 'Owner download failed'
cmp -s -- "$file" "$work/download.bin" || die 'Downloaded bytes differ from the selected file'
denied_http=$(curl --disable --silent --show-error "$download_url" \
-H "apikey: $SUPABASE_KEY" -H "Authorization: Bearer $other_token" \
--output "$work/denied.json" --write-out '%{http_code}') || die 'Access-check request failed'
case "$denied_http" in
400)
jq -e '(.statusCode | tostring) == "403" or (.statusCode | tostring) == "404"' \
"$work/denied.json" >/dev/null || die 'Unexpected Storage error'
;;
403|404) ;;
*) die "Expected access denial; received HTTP $denied_http" ;;
esac
printf 'Verified upload and private access.\n'
./report.bin を選択したファイルに置き換えてください。スクリプトの実行中は、そのファイルを変更しないでください。リモートのファイル名はローカルの名前と異なっていても構いません。
bash export-to-supabase.sh './report.bin' 'exports/report.bin'
正常に実行されると、次のように表示されます。
Verified upload and private access.
オブジェクトは curl-exports/<uploader-uuid>/exports/report.bin に残ります。ダウンロードしたコピーと Auth のレスポンスは一時的なもので、スクリプトの終了時に削除されます。内容が一致しない場合や、想定に反して別ユーザーのダウンロードが成功した場合は、この成功メッセージを表示せず、非ゼロの終了コードで終了します。非公開ダウンロード用エンドポイントは、ユーザー JWT と読み取りポリシーを使用します。API キーだけでは、そのアクセス権は得られません。
過去のエクスポートを失わずに既存オブジェクトを扱う方法
POST は新しいオブジェクトを作成します。同じコマンドを再実行すると同じ UUID とオブジェクトパスが対象になるため、既存のオブジェクトがあると拒否されます。以前のオブジェクトは保存されたままです。新しいエクスポートには別のオブジェクトパスを使ってください。
Supabase の標準アップロードガイドでは、x-upsert: true による意図的な置き換えを説明しています。この処理には SELECT と UPDATE のポリシーも必要です。この手順では更新権限を付与せず、上書きもしません。サーバーがファイルを保存した後に接続が失敗した場合、アップロードの成否は不明です。そのオブジェクトを確認してダウンロードしてから、保持するか新しいパスを使うかを判断してください。再試行時の重複レスポンスは、最初のアップロードが成功していたことを意味する場合があります。
ファイルサイズ制限の把握
プロジェクト全体の制限とバケットの制限の両方に収まる、小さなファイルを選んでください。ホスト型プランの上限とバケットの制限については、Supabase のファイル制限ドキュメントを参照してください。cURL の --data-binary @file は入力をメモリにバッファリングします。また、この例では中断した転送を再開しません。大きなファイルについては、別途再開可能なアップロードのガイドに従ってください。
日次ワークフローでのファイルエクスポートの自動化
保存したスクリプトは実行するたびにサインインするため、貼り付けた JWT の有効性に自動化処理が依存することはありません。スケジューラーから環境変数を渡し、スクリプトと入力ファイルには絶対パスを使い、エクスポートごとに新しいオブジェクトパスを選んでください。権限確認用に二つ目のアカウントを維持し、アップロードがすでにリモートに存在していても、非ゼロの終了コードは検証失敗として扱ってください。
よくある問題のトラブルシューティング
認証エラー(401 unauthorized)
まず、プロジェクト URL と API キーを確認してください。パスワードによるログインが失敗する場合は、ユーザーのメールアドレス、パスワード、確認状況を確認します。スクリプトはログインに失敗すると停止し、管理者キーで代用することはありません。転送中にトークンが期限切れになった場合は、前のアップロードが確定したかどうかを確認してから、新しいオブジェクトパスで再実行してください。
ファイル重複エラー
パスの重複はエラーとなり、Storage では通常 HTTP 400 が返されます。新しいエクスポートではスクリプトの第二引数を変更してください。競合を隠すためだけに、自動再試行や upsert を追加しないでください。
ファイルサイズ制限(413 payload too large)
サイズ超過のアップロードでは HTTP 413 が返されることがあります。検証した Storage バージョンでは、バケットのサイズ制限による拒否に対して、本文のステータスが 413 の HTTP 400 が返されました。両方のサイズ制限を確認し、タイプに関する拒否の場合はバケットの MIME 許可リストも確認してください。このスクリプトは application/octet-stream を送信し、ファイルのメディアタイプは検出しません。サービスによる診断については、Storage のエラーコードを参照してください。
アクセス許可の拒否
バケットが非公開であり、ポリシーがバケットの正確な名前、アップロードするユーザーの UUID フォルダー、および owner_id に適用されていることを確認してください。アクセスできない非公開オブジェクトは、存在しないように見える場合があります。検証した Storage バージョンでは、別ユーザーに対して本文のステータスが 404 の HTTP 400 が返されました。スクリプトはまず所有者として同じオブジェクトを読み取って比較するため、存在しないオブジェクトではその確認を通過できません。別ユーザーに HTTP 200 が返された場合は、機密データをエクスポートする前に、既存のポリシーとバケットの公開設定を確認してください。
ご自身での運用は避けたいですか?
Transloadit は、単一の API 呼び出し内の処理の一環として、S3、Azure、Google Cloud などにファイルをエクスポートします。
