在本地安装 Supabase 需要使用 Docker 来运行它的服务。以下是完整的安装步骤:


1. 安装必要的依赖

在安装 Supabase 之前,请确保你的本地环境满足以下要求:

  • Docker(用于运行 Supabase 相关服务)
  • Docker Compose(管理多个 Docker 容器)
  • Git(用于克隆 Supabase 配置)

如果你的系统尚未安装 Docker,可以参考官网进行安装:

安装完 Docker 后,可以运行以下命令检查是否安装成功:

 1docker --version
 2docker compose version

2. 安装 Supabase CLI

Supabase 提供了一个命令行工具 supabase-cli,用于管理本地 Supabase 实例。

Mac(通过 Homebrew 安装)

 1brew install supabase/tap/supabase

Linux

使用 curl 安装:

 1curl -fsSL https://supabase.com/install | sh

或者通过 npm 安装:

 1npm install -g supabase

Windows(使用 Scoop)

 1scoop bucket add supabase https://github.com/supabase/scoop-bucket.git
 2scoop install supabase

安装完成后,运行以下命令检查是否安装成功:

 1supabase --version

3. 初始化 Supabase 项目

在你的项目目录中,运行:

 1supabase init

这会创建一个 .supabase 目录,其中包含 Supabase 需要的配置文件。


4. 启动本地 Supabase

运行以下命令启动 Supabase 本地服务:

 1supabase 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,可以运行:

 1supabase stop

这将停止所有 Supabase 相关的 Docker 容器。


7. 卸载 Supabase

如果你想彻底卸载本地 Supabase,可以运行:

 1supabase stop
 2docker system prune -a

然后手动删除 .supabase 目录。


这样,你就可以在本地成功安装和运行 Supabase 了!🚀

个人笔记记录 2021 ~ 2025