Supabase 环境搭建
这一篇不需要安装任何本地软件,全程在浏览器里完成。注册账号、创建项目、认识配置项,最后在 SQL Editor 里跑通第一条 SQL 语句。
注册账号
打开 supabase.com 点击 Sign in 按钮,推荐直接用 GitHub 账号登录,后续不需要再记一套密码。登录后进入控制台首页。
创建第一个项目
进入 supabase.com/dashboard 点击 New project,按顺序填写
- 项目名称,例如 my-blog,创建后不可修改
- 数据库密码,至少要 8 位且包含特殊字符,用于数据库管理操作
- 区域(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 数据建模入门