Supabase 本地开发指南
使用 Supabase CLI 在 localhost 运行 Postgres、Auth、Storage 等全套后端，API 网关默认 54321。
Supabase 是开源 Firebase 替代方案（PostgreSQL + Auth + Storage + Realtime）。Supabase CLI 可在本地 Docker 中启动完整栈，便于与前端联调。
前置条件
- Docker Desktop（或 Docker Engine + Compose）
- Supabase CLI
brew install supabase/tap/supabase
# 或 npm i -g supabase快速开始
supabase init
supabase startCLI 会输出本地 URL 与密钥，例如：
| 服务 | 典型 localhost 地址 |
|---|---|
| API | http://localhost:54321 |
| Studio | http://localhost:54323 |
| PostgreSQL | localhost:54322 |
| Inbucket（邮件测试） | http://localhost:54324 |
具体端口以 supabase start 输出为准。
前端连接
.env.local：
NEXT_PUBLIC_SUPABASE_URL=http://localhost:54321
NEXT_PUBLIC_SUPABASE_ANON_KEY=<anon key from supabase start>常用命令
supabase stop
supabase status
supabase db reset
supabase migration new my_change与裸 PostgreSQL 区别
Supabase 本地栈 = Postgres + Auth API + Storage + Kong 网关；不仅是一个 :5432 数据库。
常见问题
Docker 未运行supabase start 依赖 Docker；先启动 Docker Desktop。
端口冲突
在 config.toml 调整 [api] port 等。
小结
Supabase 本地开发运行 supabase start，API 入口多为 **http://localhost:54321**，Studio 在 54323，适合 Next.js 等全栈项目本地联调。