本地开发与命令行工具

Learn how to develop locally and use the Supabase CLI

要使用本地运行的 Supabase 堆栈来开发你的应用，你需要安装 Supabase CLI 和一个容器运行环境。

🌐 To develop your applications using the locally running Supabase stack, you'll need to install the Supabase CLI and a container runtime.

兼容 Docker API 的容器管理器是前提条件：

🌐 A container manager compatible with Docker APIs is a prerequisite:

Docker Desktop（macOS、Windows、Linux）- 首选选项
Rancher Desktop（macOS、Windows、Linux）
Podman（macOS、Windows、Linux）
OrbStack（macOS）

快速入门 #

🌐 Quickstart

选择一种安装方法，并在下列每一步中使用相同的标签。Homebrew 会给你一个全局的 supabase 命令。npm、pnpm 和 yarn 会把 CLI 安装到你的项目中作为开发依赖，因此你需要通过你的包管理器运行它（npx supabase、pnpm supabase 或 yarn supabase）。详情请看安装和运行 CLI。

🌐 Pick an install method and use the same tab in every step below. Homebrew gives you a global supabase command. npm, pnpm, and yarn install the CLI into your project as a dev dependency, so you run it through your package runner (npx supabase, pnpm supabase, or yarn supabase). See Install and run the CLI for details.

安装 Supabase CLI：
```
1
npm install supabase --save-dev
```
在你的仓库里，初始化本地 Supabase 项目：
```
1
npx supabase init
```
启动本地 Supabase 堆栈：
```
1
npx supabase start
```
在本地通过 http://localhost:54323 查看你的 Supabase 实例。

如果你的本地开发机器连接到不受信任的公共网络，你应该在启动本地开发环境之前创建一个独立的 Docker 网络，并绑定到 127.0.0.1。这会将网络访问限制在你的本地主机上。

🌐 If your local development machine is connected to an untrusted public network, you should create a separate Docker network and bind to 127.0.0.1 before starting the local development stack. This restricts network access to only your localhost machine.

1
docker network create -o 'com.docker.network.bridge.host_binding_ipv4=127.0.0.1' local-network
2
npx supabase start --network-id local-network

你绝不应该把本地开发环境公开暴露。

🌐 You should never expose your local development stack publicly.

本地开发 #

🌐 Local development

使用 Supabase 进行本地开发可以让你在本地计算机的独立环境中进行项目开发。在本地工作有几个好处：

🌐 Local development with Supabase allows you to work on your projects in a self-contained environment on your local machine. Working locally has several advantages:

更快的开发：你可以马上做出更改并看到结果，无需等待远程部署。
离线工作：即使没有网络连接，你也可以继续开发。
性价比高：本地开发是免费的，而且不会消耗你项目的配额。
增强隐私：开发过程中敏感数据会保留在你的本地机器上。
安全测试：你可以尝试不同的配置和功能，而不会影响你的生产环境。

一旦设置好，你就可以初始化一个新的 Supabase 项目，启动本地环境，并开始使用本地 Supabase 服务开发你的应用。这包括访问本地 Postgres 数据库、认证、存储以及其他 Supabase 功能。

🌐 Once set up, you can initialize a new Supabase project, start the local stack, and begin developing your application using local Supabase services. This includes access to a local Postgres database, Auth, Storage, and other Supabase features.

命令行接口 #

🌐 CLI

Supabase CLI 是一个工具，允许开发者在本地运行 Supabase 服务，并直接从终端管理托管的项目。它提供了一套用于各种任务的命令，包括：

🌐 The Supabase CLI is a tool that enables developers to run Supabase services locally and manage hosted projects directly from the terminal. It provides a suite of commands for various tasks, including:

搭建和管理本地开发环境
为你的数据库模式生成 TypeScript 类型
处理数据库迁移
管理环境变量和密钥
将你的项目部署到 Supabase 平台

使用命令行工具，你可以简化开发工作流程、自动化重复任务，并在不同环境中保持一致性。这是本地开发和 CI/CD 流水线中都必不可少的工具。

🌐 With the CLI, you can streamline your development workflow, automate repetitive tasks, and maintain consistency across different environments. It's an essential tool for both local development and CI/CD pipelines.

请查看CLI入门指南了解更多信息。

🌐 See the CLI Getting Started guide for more information.