在本地安装 Supabase 需要使用 Docker 来运行它的服务。以下是完整的安装步骤:
1. 安装必要的依赖
在安装 Supabase 之前,请确保你的本地环境满足以下要求:
- Docker(用于运行 Supabase 相关服务)
- Docker Compose(管理多个 Docker 容器)
- Git(用于克隆 Supabase 配置)
如果你的系统尚未安装 Docker,可以参考官网进行安装:
安装完 Docker 后,可以运行以下命令检查是否安装成功:
docker --version
docker compose version
2. 安装 Supabase CLI
Supabase 提供了一个命令行工具 supabase-cli
,用于管理本地 Supabase 实例。
Mac(通过 Homebrew 安装)
brew install supabase/tap/supabase
Linux
使用 curl
安装:
curl -fsSL https://supabase.com/install | sh
或者通过 npm
安装:
npm install -g supabase
Windows(使用 Scoop)
scoop bucket add supabase https://github.com/supabase/scoop-bucket.git
scoop install supabase
安装完成后,运行以下命令检查是否安装成功:
supabase --version
3. 初始化 Supabase 项目
在你的项目目录中,运行:
supabase init
这会创建一个 .supabase
目录,其中包含 Supabase 需要的配置文件。
4. 启动本地 Supabase
运行以下命令启动 Supabase 本地服务:
supabase start
此命令会:
- 拉取 Supabase 所需的 Docker 镜像
- 运行 PostgreSQL、Auth、Storage 和其他服务
⚠️ 注意:首次运行 supabase start
可能会下载多个 Docker 镜像,可能需要一些时间。
5. 访问 Supabase
当 Supabase 启动后,你可以访问:
- Supabase Studio(管理界面):
http://localhost:54323
- PostgreSQL 连接信息:
- 主机:
localhost
- 端口:
54322
- 用户名:
postgres
- 密码:
postgres
- 数据库:
postgres
- 主机:
你可以使用 psql
或任何数据库管理工具(如 DBeaver、TablePlus)连接到本地数据库。
6. 关闭 Supabase
如果你需要关闭 Supabase,可以运行:
supabase stop
这将停止所有 Supabase 相关的 Docker 容器。
7. 卸载 Supabase
如果你想彻底卸载本地 Supabase,可以运行:
supabase stop
docker system prune -a
然后手动删除 .supabase
目录。
这样,你就可以在本地成功安装和运行 Supabase 了!🚀