用途：在本地用 Docker 和 Supabase CLI 运行完整 Supabase 栈，使本地 API 与生产一致，支持离线开发、快速迭代和可重复的迁移流程。
主要能力：本地启动 Postgres、Auth、Storage、Realtime、Edge Functions 与 Studio；用 supabase db diff 生成迁移，用 supabase db reset 重放迁移与 seed.sql；将验证过的迁移推送到远程项目。
必要用法：需 Docker Desktop 运行、Node.js 18+，命令均用 npx supabase。初始化：npx supabase init；启动：npx supabase start；查看状态：npx supabase status；新建迁移：npx supabase migration new create_profiles；重置并应用迁移与种子：npx supabase db reset；从 Studio 改动生成迁移：npx supabase db diff -f add_bio_to_profiles；链接远程：npx supabase link --project-ref <your-project-ref>；推送迁移：npx supabase db push；停止：npx supabase stop。本地端点包括 API http://localhost:54321、DB postgresql://postgres:postgres@localhost:54322/postgres、Studio http://localhost:54323、Inbucket http://localhost:54324，需将 anon key 与 service_role key 写入 .env.local。
适用场景：本地初始化 Supabase 项目、开发数据库 schema 与 RLS、编写种子数据、测试 Edge Functions、在提交前验证迁移链。
限制：Docker 未运行会报无法连接 Docker daemon；端口 54321 被占用需先 stop；迁移 SQL 语法错误会导致 db reset 失败；auth.users 仅存在于 Supabase 管理的 Postgres 实例中，在外部运行迁移会报 relation "auth.users" does not exist；db diff 为空表示未检测到 schema 变更。首次 start 需拉取 Docker 镜像，耗时数分钟。