第 7 章 · 文件存储（Storage）

第 7 章 · 文件存储（Storage）

章节摘要：Supabase Storage 提供 S3 兼容的对象存储能力，支持公开与私有存储桶（Bucket）、前端直传、断点续传、临时签名 URL 与图片变换处理。本章讲解存储桶与对象模型、文件的上传下载与管理、图片处理与加速，以及与 RLS 结合的存储策略访问控制。掌握 Storage，你就能为应用托管图片、音视频、文档等各类非结构化文件，并按用户身份精确控制访问权限。

学习目标

阅读本章后，你将能够：

• 理解对象存储中存储桶、对象与路径的概念
• 完成前端直传、断点续传与签名 URL 下载
• 利用图片变换与 CDN 加速文件分发
• 设计结合 RLS 的存储策略，实现按用户隔离的文件访问

本章概览

数据库擅长存结构化数据，但图片、视频、PDF 这些「非结构化文件」并不适合塞进表里——它们体积大、适合直接以二进制对象存储。Supabase Storage 正是为这类数据准备的托管层。它既能与认证、RLS 联动实现权限控制，又能提供图片处理与 CDN 加速，让文件管理像数据管理一样安全可控。

下图展示了一次文件上传与下载的典型流程，以及访问策略如何在其中起作用。

可以看到，Storage 与数据库紧密配合：文件本身存于对象存储，而其元信息（路径、所有者、大小等）存于数据库，访问控制由存储策略（同样基于 RLS 机制）决定。

子章节导航

本章按「模型 → 操作 → 处理 → 安全」组织：

1. 存储桶与对象模型：建立对象存储的基本概念。
2. 文件上传、下载与管理：实操直传、断点续传与签名 URL。
3. 图片处理与加速：缩略、变换与 CDN。
4. 存储策略与访问控制：用 RLS 机制保护文件访问。

建议按顺序学习；上传下载是日常高频，图片处理与策略按需深入。

与其他章节的关联

Storage 的访问控制复用了第 5 章 RLS 的机制，因此它同样依赖第 4 章的身份认证。文件元信息常记录在数据库表中，因而与第 2、3 章的表设计和 SQL 相关。配合第 6 章 Realtime，还能实现「新文件上传即通知」这类体验。