Supabase 全栈开发实战：从云端到本地部署指南

用户鉴权

虽然将 API Key 暴露在前端看似不安全，但得益于行级安全策略（RLS），只要配置得当，数据依然是安全的。

注册与登录流程非常简洁：

// 注册
await supabase.auth.signUp({ email: '[email protected]', password: 'password' })

// 登录
const { data, error } = await supabase.auth.signInWithPassword({ email: '[email protected]', password: 'password' })

验证邮件发送后，用户状态变为激活。登录成功后返回的 Session 包含用户 ID 等信息。

RLS 行级安全策略

RLS 是 PostgreSQL 的原生功能，用于约束特定用户对特定行的访问权限。这是实现前端直连数据库安全的关键。

创建一个业务表 user_info，关联系统用户表 auth.users 的 ID：

ALTER TABLE user_info ADD COLUMN user_id UUID REFERENCES auth.users(id);

启用 RLS 并添加策略，确保用户只能查看或修改自己的数据：

-- 查询策略
CREATE POLICY "Users can view own data" ON user_info
FOR SELECT USING (auth.uid() = user_id);

-- 插入策略
CREATE POLICY "Users can insert own data" ON user_info
FOR INSERT WITH CHECK (auth.uid() = user_id);

前端调用时，SDK 会自动携带 JWT Token。若尝试访问他人数据，服务器会返回 403 Forbidden。

文件存储

Storage 模块支持 S3 协议。创建 Bucket 后可上传下载文件，同样支持配置安全策略。

例如，限制用户只能上传到以其 User ID 命名的文件夹内。前端上传时需动态生成路径：

const { data, error } = await supabase.storage
  .from('images')
  .upload(`public/${user.id}/file.png`, file)

若路径不符合策略，上传将被拒绝。免费版云存储空间有限（数据库 500MB，存储 1GB），超出后可考虑本地部署。

边缘函数与实时推送

Edge Function 类似于 Cloudflare Worker，支持运行服务端逻辑。RealTime 功能通过监听数据库变化，利用 WebSocket 向客户端推送通知，适用于消息提醒等场景。

此外，MCP（Model Context Protocol）支持将 Supabase 能力集成至 AI 工具中，增强 AI 对数据的操作权限。

本地部署指引

Supabase 完全开源，支持 Docker 自托管。克隆仓库并准备环境：

git clone --depth 1 https://github.com/supabase/supabase
mkdir supabase-project
cp -rf supabase/docker/* supabase-project
cp supabase/docker/.env.example supabase-project/.env
cd supabase-project
docker compose pull
docker compose up -d

Windows 环境下需注意命令兼容性，部分复制操作需手动执行。修改 .env 中的端口配置（如改为 18000）以避免冲突。

启动后访问 localhost:18000，默认账号密码可在文档中找到。本地部署后，SDK 只需替换 URL 和 Key 即可正常使用，解锁全部功能且支持商用。