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

npm install @supabase/supabase-js

在代码中引入并配置客户端：

import { createClient } from '@supabase/supabase-js'

const supabaseUrl = 'https://your-project.supabase.co'
const supabaseKey = 'your-anon-key'
const supabase = createClient(supabaseUrl, supabaseKey)

虽然将 API Key 暴露在前端看似不安全，但 Supabase 通过 RLS（行级安全策略）保障了数据安全。只要正确配置策略，即使密钥公开，未授权的用户也无法访问敏感数据。

用户鉴权

注册与登录逻辑非常简洁：

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

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

验证邮件发送后，用户状态将在控制台更新。登录成功后返回的 Session 可用于后续请求的身份标识。

RLS 行级安全策略

RLS 是 PostgreSQL 的原生功能，用于约束数据的读写权限。默认情况下，未开启 RLS 的表无法通过 SDK 查询，这强制开发者必须考虑安全性。

配置示例

假设有一个 user_info 表，存储用户年龄等信息，需关联系统用户 ID：

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

开启 RLS 并设置策略，确保用户只能查看自己的数据：

ALTER TABLE user_info ENABLE ROW LEVEL SECURITY;

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

前端查询时，SDK 会自动注入当前用户的 JWT Token，服务端校验通过后仅返回匹配的数据。若尝试查询他人数据，将返回空结果或报错。

写入同样受控，可限制用户只能插入与自己 ID 匹配的记录。这种机制让前端直接操作数据库成为可能，而无需担心越权风险。

文件存储

Storage 模块提供 S3 兼容的文件存储服务。创建 Bucket 后，可配置类似 RLS 的安全策略，控制用户上传路径。

例如，限制用户只能上传到以其 ID 命名的文件夹：

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

免费层通常有存储空间限制（如 500MB 数据库 + 1GB 存储），超出后可选择本地部署或升级计划。

边缘函数与实时推送

Edge Functions 类似于 Cloudflare Worker，支持运行 Serverless 代码。RealTime 功能则通过 Websocket 监听数据库变更，实现消息推送或状态同步。这两项功能极大丰富了应用交互能力。

此外，Supabase 支持 MCP（Model Context Protocol），可将数据库能力集成至 AI 工具中，辅助自动化开发流程。

本地部署指引

对于需要私有化部署的场景，可通过 Docker 一键启动所有组件。Supabase 包含约 13 个微服务，建议至少 4GB 内存环境。

部署步骤

1. 克隆仓库并准备目录：

   git clone --depth 1 https://github.com/supabase/supabase
   mkdir supabase-project
   cp -rf supabase/docker/* supabase-project/
   

2. 配置环境变量： 复制 .env.example 为 .env，修改端口号（Windows 下建议避开常用端口，如改为 18000）。
3. 拉取镜像并启动：

   cd supabase-project
   docker compose pull
   docker compose up -d
   

启动完成后访问 localhost:18000，使用默认凭证登录。本地部署版本功能与云端一致，SDK 仅需替换 URL 和 Key 即可无缝切换。

Supabase 采用 Apache 2.0 协议开源，商业友好，是构建现代全栈应用的优秀选择。