六维教程

Supabase 环境搭建

这一篇不需要安装任何本地软件,全程在浏览器里完成。注册账号、创建项目、认识配置项,最后在 SQL Editor 里跑通第一条 SQL 语句。

注册账号

打开 supabase.com 点击 Sign in 按钮,推荐直接用 GitHub 账号登录,后续不需要再记一套密码。登录后进入控制台首页。

创建第一个项目

进入 supabase.com/dashboard 点击 New project,按顺序填写

  1. 项目名称,例如 my-blog,创建后不可修改
  2. 数据库密码,至少要 8 位且包含特殊字符,用于数据库管理操作
  3. 区域(Region),国内用户建议选择 Singapore 或 Tokyo,延迟更低

点击创建后,项目需要初始化约 2 分钟,页面会显示初始化进度。完成前可以先了解配置信息,这两项会伴随你整个开发周期

配置项 是什么 用途
Project URL 你的项目专属地址,形如 https://xxxx.supabase.co 创建客户端时填入
anon public key 面向浏览器的公开密钥,形如一长串 base64 字符 创建客户端时填入

密钥体系

Supabase 的每个项目有两把钥匙

密钥 能否给浏览器 用途
anon public key 可以,本来就是公开的 前端代码里使用,配合 RLS 只能访问被允许的数据
service_role key 绝对不能暴露 绕过所有安全策略,只应放在服务端

新手最常见的错误就是把 service_role key 写进前端代码,等于把数据库大门敞开。记住一条原则,出现在浏览器里的永远只有 anon key。本教程所有示例代码都用 anon key。

认识 Dashboard

项目创建完成后,左侧导航就是 Supabase 的全部家当

菜单 作用 对应本教程
Table Editor 可视化编辑表和数据 第 03 篇
SQL Editor 写 SQL 语句的地方 第 03-05 篇
Auth 用户认证设置和用户列表 第 06-07 篇
Storage 文件存储和 Bucket 管理 第 10 篇
Realtime 实时功能开关 第 11 篇

执行第一条 SQL

点击左侧 SQL Editor,在编辑器里输入以下语句

select version();

点击 Run 按钮,下方结果区会显示 PostgreSQL 的版本信息,类似 PostgreSQL 15.x。能看到版本号,说明数据库连接正常,环境搭建完成。

验证前端配置

回到 Settings 页面的 API 标签,页面上有 Project URL 和 anon public key。把这两个值复制出来,后续所有文章都会用到。建议记在本地的项目配置文件里,第四篇开始会用它初始化客户端。

下一篇 Supabase 数据建模入门

上一篇
Supabase 是什么
下一篇
Supabase 数据建模入门