文档中心

AI 原生 BaaS 平台 Supabase 版

使用 Storage

通过 S3 协议访问 Storage

AI 原生 BaaS 平台 Supabase 版（以下简称火山引擎 Supabase）支持通过 S3 标准协议访问对象存储（Storage）服务。通过暴露 /v1/s3 接口，您可以直接使用 AWS S3 SDK、S3 命令行工具（CLI）或其他 S3 兼容的第三方工具来管理存储桶（Bucket）和文件（Object），无需重写既有的对象存储集成代码。

前提条件

已创建使用 Supabase 引擎的 Workspace 且 Workspace 的状态为运行中。关于创建 Workspace 的更多详细信息，请参见创建 Workspace。

已通过目标 Workspace 成功登录 Supabase 控制台。关于登录控制台的详细信息，请参见登录 Supabase 控制台。

操作步骤

开启 S3 协议访问

在 Supabase 控制台单击左侧的 Storage，进入 Storage 页面。

在 Storage 页面，单击 Configuration > S3，即可进入 S3 Configuration 页面。

在 S3 Configuration 页面，打开 Enable connection via S3 protocol 开关，之后您可以获取该 Workspace 的 Endpoint（终端节点）和 Region（区域）。

管理 Access keys

为了通过服务端或第三方工具安全访问，您需要创建访问密钥（AK/SK）。

在 S3 Configuration 页面的 Access keys 区域，单击 New access key。

在弹出的对话框中，输入 Description（密钥描述），例如 backup-service-key。

单击 Create access key。

系统将生成 Access Key ID 和 Secret Access Key。

警告

安全提醒：Secret Access Key 仅在创建成功时展示一次，关闭弹窗后无法再次查看。请务必及时妥善保存密钥信息。

使用说明

认证方式选择

火山引擎 Supabase 支持以下两类 S3 认证方式，请根据应用场景选择：

维度	AK/SK 模式	Session Token 模式
主要使用者	服务端应用、任务系统、迁移工具	前端应用、移动端
凭证组成	Access Key ID + Secret Access Key	Project Ref + Anon Key + User JWT
权限范围	默认拥有高权限（Service Role）	受 RLS（行级安全）策略约束，基于用户身份访问
典型场景	数据备份、离线处理、第三方客户端接入	用户个人文件直传、受限内容下载

客户端配置示例

以 Python boto3 库为例，配置示例如下：

注意事项

每个项目（Project）最多支持创建 50 组 Access keys。

为了保证数据安全，不建议在前端代码中硬编码 AK/SK。前端场景请优先使用 Session Token 模式。

S3 接口目前支持标准协议的子集，如遇到不支持的特定 API 操作，请参考 API 文档或咨询技术支持。

常见问题与故障排查

访问时报错 403 Forbidden 且提示 FeatureNotEnabled？

请检查控制台 S3 Configuration 页面中 S3 协议开关是否已开启。

为什么我看不到 Secret Access Key？

Secret Access Key 仅在创建时显示一次。如果遗失，请删除旧密钥并重新创建。

最近更新时间：2026.08.25 12:34:59

这个页面对您有帮助吗？

有用

无用