当前位置：首页 > news >正文

Supabase CLI（命令行工具）的安装和配置

news 2025/10/29 18:36:40

提供了两种不同的工作方式，你需要根据你的开发习惯选择一种。

工作方式 A：本地开发 (推荐用于开发和测试)

这种方式会在你的电脑上用 Docker 模拟一整套 Supabase 环境，包括数据库、认证等等。

启动 Docker Desktop。
Start Docker Desktop (or any Docker engine that exposes the Windows named pipe). The Supabase local stack runs entirely in Docker, so the CLI exits until Docker is up.
- 翻译： 启动 Docker Desktop。因为 Supabase 的本地环境完全运行在 Docker 容器里，所以如果 Docker 没启动，CLI 命令会直接退出。
- 操作： 在你的电脑上找到 Docker Desktop 这个程序，然后启动它。确保它已经运行并处于“running”状态。
触发 CLI 下载并初始化本地环境。
Once Docker is running, use pnpm exec supabase --help (or pnpm exec supabase start). That first invocation downloads the actual CLI binary...
- 翻译： 等 Docker 运行起来后，在你的项目终端里运行 pnpm exec supabase --help。这次调用会下载真正的 CLI 程序，并消除之前的那个警告。
- 操作： 在你的项目根目录下的终端里，运行以下命令来启动你的本地 Supabase 服务：
  codeBash
```
pnpm exec supabase start
```
  这个命令会下载所需文件，并利用 Docker 创建本地的数据库等服务。第一次运行会比较慢。
应用数据库迁移。
After the CLI is ready, run your migrations: pnpm exec supabase migration up
- 翻译： 等 CLI 准备好后，运行你的数据库迁移。
- 操作： 保持上一个终端窗口不动，新开一个终端窗口，在项目根目录下运行你之前问过的那个命令：
  codeBash
```
pnpm exec supabase migration up
```
  这个命令会把 supabase/migrations 文件夹里的 SQL 文件应用到你刚刚启动的本地 Docker 数据库里。

工作方式 B：直接连接远程项目 (用于直接修改线上开发/测试环境)

如果你不想在本地用 Docker 跑一整套服务，而是想让本地的 CLI 工具直接管理你线上的 Supabase 项目（比如你的开发环境项目）。

If you don’t plan to run the local stack... link to a remote project instead (pnpm exec supabase link --project-ref <ref> + pnpm exec supabase db push --db-url <url>), or skip supabase start entirely.

翻译： 如果你不打算运行本地环境，你可以跳过 supabase start，直接连接到一个远程项目。
操作：
1. 关联你的线上项目：
  codeBash
```
# <ref> 需要替换成你 Supabase 网站上项目的真实ID
pnpm exec supabase link --project-ref <your-project-ref>
```
2. 应用数据库变更：
  codeBash
```
# 这种方式通常使用 `db push` 而不是 `migration up`
# 它会比较本地 schema 和远程数据库的差异并同步
pnpm exec supabase db push
```
  注意： 这种方式更直接，但也更危险，因为它会直接修改你的线上数据库。对于版本化的迁移 (migration up)，通常需要更谨慎的操作或在 CI/CD 流程中执行。