WARNING
本文档由 AI 自动翻译,仅供参考。涉及关键操作或信息时,请以英文原文为准。
用 Supabase 和 Lares 构建应用后端
Supabase 在你的 Olares 设备上为应用提供 PostgreSQL 数据库、用户认证和 API。将 Lares 连接到 Supabase Model Context Protocol(MCP)服务器后,你可以通过对话创建数据表和访问策略。
在本教程中,你将构建并运行一个命令行笔记应用,通过行级安全(RLS)保护每个用户的私有笔记。你还将使用 Metabase 查询存储在另一张数据表中的示例项目费用。
学习目标
通过本教程,你将学会:
- 将 Lares 连接到 Supabase MCP 服务器。
- 创建用于存储用户笔记的数据表,并通过 RLS 配置每个用户的访问权限。
- 使用 Lares 生成笔记应用,在 Code Server 中运行,并使用在 Supabase 中创建的用户账号登录。
- 验证每个用户只能访问自己的笔记。
- 将 Metabase 连接到 Supabase,并查询示例项目费用。
前置条件
- Lares 已配置支持工具调用的模型。按照 Lares 入门完成设置。
- 已从应用市场安装 Code Server。你将使用其编辑器和终端创建并运行笔记应用。
- 已从应用市场安装 Metabase,用于生成报表。
安装 Supabase
- 打开应用市场,搜索“Supabase”。
- 点击获取,然后点击安装,等待安装完成。
将 Lares 连接到 Supabase MCP 服务器
将 Lares 连接到 Supabase,以便在对话中使用数据库工具。
连接认证
Lares 通过同一实例上的 Olares 身份认证进行连接,因此不需要额外提供访问令牌或 API key。在 Olares 设置中,将 Supabase Studio 入口保持为 Internal。
打开 Olares 设置,进入应用 > Supabase > Supabase Studio。
复制 Endpoint 地址,并在末尾添加
/api/mcp。例如:texthttps://<studio-host>/api/mcp打开 Lares,进入 Settings > MCP,点击 Add server。
填写以下设置:
设置项 值 Server name supabase_officialTransport Streamable HTTPMCP URL 复制的入口地址,以 /api/mcp结尾点击 Save。Lares 会建立连接并加载服务器的工具。
在 Lares 中开始新对话,发送以下提示词检查 MCP 连接:
text使用 supabase_official 列出 public schema 中的数据表,并返回 此 Supabase 实例的 API URL。直接使用 MCP 工具,不要修改数据。Lares 应返回 Supabase API URL 和
publicschema 中的数据表列表。如果尚未创建任何数据表,列表将为空。
使用 Supabase 构建并运行笔记应用
使用 Lares 准备 Supabase 数据表、配置访问策略并生成笔记应用。然后在 Code Server 中运行应用,检查每个用户是否只能访问自己的笔记。
使用 Lares 创建笔记表和访问策略
MCP 连接就绪后,使用 Lares 为笔记应用创建数据表和访问策略,确保每个用户只能访问自己的笔记。
每条笔记的 owner_id 字段保存其所属用户的 ID。策略将该值与当前登录用户的 ID 比较,以控制访问权限。
数据库管理权限
MCP 服务器可以修改数据表和访问策略。请检查拟执行的 SQL,并仅批准预期的修改。
在 Lares 对话中描述所需的数据表和策略:
text使用 supabase_official 为我的应用准备一个私有笔记表。 先检查 public schema。创建 public.user_notes,包含: - id:UUID 主键,默认 gen_random_uuid() - owner_id:UUID,必填 - note:text,必填 启用 RLS,并向 authenticated 授予 SELECT、INSERT、UPDATE、DELETE 权限。 创建 own_notes 策略,使用 FOR ALL TO authenticated, 将 USING 和 WITH CHECK 都设为 auth.uid() = owner_id。 使用 apply_migration 修改表结构,执行前展示计划运行的 SQL。 只修改此表,不删除现有数据,也不授予匿名访问权限。 如果表已存在,先说明差异,再提出迁移方案。检查拟执行的 SQL。Lares 请求审批时,仅批准预期的修改,并等待执行完成。
打开 Supabase Studio,进入 Table Editor。找到
user_notes,检查id、owner_id和note列,并确认 RLS policy 指示器显示一条策略。让 Lares 检查
user_notes并总结其 RLS 策略:text使用 supabase_official 检查 public.user_notes。确认已启用 RLS, 并总结策略名称、适用角色,以及 USING 读取条件和 WITH CHECK 写入检查条件。总结应显示 RLS 已启用,且有一条适用于
authenticated角色的own_notes策略。两个条件都将auth.uid()与owner_id比较。
替代方式:在 SQL Editor 中创建笔记表
如果尚未使用 Lares 创建 user_notes,打开 Supabase Studio 的 SQL Editor,粘贴以下查询并点击 Run。然后按照上述步骤检查数据表和策略。
create table public.user_notes (
id uuid default gen_random_uuid() primary key,
owner_id uuid not null,
note text not null
);
alter table public.user_notes enable row level security;
grant select, insert, update, delete on public.user_notes to authenticated;
create policy own_notes on public.user_notes
for all to authenticated
using (auth.uid() = owner_id)
with check (auth.uid() = owner_id);使用 Lares 创建笔记应用
这个命令行应用用于用户登录、添加笔记,以及从 Supabase 的 user_notes 表中列出自己的笔记。
让 Lares 生成程序及其配置文件:
text帮我将私有笔记应用连接到 Supabase。使用 supabase_official 检查 user_notes 及其 RLS 策略,并获取 API URL 和 anon key。 使用 @supabase/supabase-js v2 和 Node.js 22 创建 notes.mjs。 从 process.env 读取 SUPABASE_URL、SUPABASE_ANON_KEY、NOTES_EMAIL 和 NOTES_PASSWORD。我会使用 node --env-file=.env 加载 .env。 使用 signInWithPassword 登录,并支持以下命令: - whoami:显示已登录用户的邮箱和 ID,不显示会话令牌 - add "text":向 user_notes 插入笔记,将 owner_id 设为该用户的 ID, 然后显示保存的笔记及其 ID - list:查询 user_notes 的 id 和 note,依靠 RLS 隔离用户数据 报告 SDK 错误,并在每条命令执行后退出。 将 notes.mjs、.env、.env.example 和 .gitignore 直接保存在 工作区根目录中,不要放在子文件夹里。 在 .env 中填写 API URL 和 anon key。将 NOTES_EMAIL 和 NOTES_PASSWORD 留空,并在 Git 中忽略 .env 和 node_modules/。 在 .env.example 中使用占位值。不要将密码放在对话或源代码中。 告诉我文件的具体位置。不要创建 Auth 用户、修改表结构或策略,也不要运行应用。 准备好文件后停止。Lares 会为同一个应用准备四个文件:
文件 用途 notes.mjs要运行的程序,用于登录 Supabase、添加笔记和列出当前登录用户的笔记。 .env运行程序时使用的配置。Lares 填写 API URL 和 anonkey,你需要补充 Supabase Auth 用户的邮箱和密码。.env.example使用占位值的配置模板,可供参考或用于配置另一份应用。 .gitignore告诉 Git 不要将 .env和node_modules依赖文件夹纳入版本控制。打开 Olares 文件管理器,进入 Data > lares > data > workspace,复制
notes.mjs、.env、.env.example和.gitignore。在 Olares 文件管理器中,进入 Home > Code,创建名为
notes-app的文件夹,并将四个文件全部粘贴到该文件夹中。Code Server 可以访问此文件夹。
为笔记应用创建用户账号
在 Supabase 中创建用户账号,用于登录笔记应用。此账号与你的 Olares 账号不同。
- 打开 Supabase Studio,进入 Authentication > Users > Add user > Create new user。
- 输入邮箱(例如
demo@example.com),并自行设置密码。保持 Auto confirm user? 启用,然后点击 Create user。自动确认允许你在此示例中直接登录,无需接收确认邮件。
在 Code Server 中运行笔记应用
从启动台打开 Code Server。
通过 File > Open Folder 打开
/home/coder/notes-app,该路径对应 Olares 文件管理器中的 Home > Code > notes-app。如果出现提示,确认信任此文件夹。检查 Explorer 中是否显示
notes.mjs和.env。打开 Terminal > New Terminal。
运行
node -v,检查已安装的 Node.js 版本。此示例使用 Node.js 22。如果未安装 Node.js 或版本低于 22,依次运行以下四条命令,通过 nvm 安装:
bashtouch "$HOME/.bashrc" curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh | bash . "$HOME/.nvm/nvm.sh" nvm install 22运行
npm -v,确认 npm 显示版本号。如果在上一步安装了 Node.js,还需再次运行node -v,检查是否显示v22.x.x。在 Code Server 终端中,切换到项目文件夹并安装 Supabase JavaScript SDK:
bashcd /home/coder/notes-app npm install @supabase/supabase-js@2.118.0在 Code Server 中打开
.env。保留SUPABASE_URL和SUPABASE_ANON_KEY不变,将NOTES_EMAIL和NOTES_PASSWORD设为你创建的笔记应用账号的邮箱和密码,然后保存文件:dotenvNOTES_EMAIL="your-email@example.com" NOTES_PASSWORD="your-password"妥善保管密码
将密码保存在
.env中,不要粘贴到 Lares 对话中,也不要写入notes.mjs。替代方式:从 Supabase Studio 和 Olares 设置复制连接信息
打开 Olares 设置,进入应用 > Supabase > Supabase API。将其 Endpoint 复制到
.env的SUPABASE_URL中,不要包含/rest/v1或/api/mcp。在 Supabase Studio 中,打开 Project Settings > API Keys > Legacy anon, service_role API keys,将
anonkey 复制到SUPABASE_ANON_KEY。不要使用service_role,它会绕过 RLS,允许访问其他用户的笔记。在同一终端中运行以下命令,登录、添加笔记并读取保存的笔记。
--env-file=.env选项会从.env加载连接设置和用户凭据:bashnode --env-file=.env notes.mjs whoami node --env-file=.env notes.mjs add "Ask the Lakeview contractor to confirm the delivery window." node --env-file=.env notes.mjs list终端会显示已登录用户、新笔记的 ID 和保存的笔记。每次执行
add命令都会创建一条新记录。
检查用户是否只能访问自己的笔记
在 Supabase Studio 中,重复为笔记应用创建用户账号的步骤,使用不同的邮箱(例如
demo2@example.com)和单独的密码。在 Code Server 中打开
.env,将NOTES_EMAIL和NOTES_PASSWORD更新为第二个用户的邮箱和密码。保留SUPABASE_URL和SUPABASE_ANON_KEY不变,然后保存文件。运行以下命令:
bashnode --env-file=.env notes.mjs whoami node --env-file=.env notes.mjs list当前登录用户应为第二个用户。虽然第一个用户的笔记仍在数据库中,但新用户的笔记列表应为空。
为第二个用户添加一条笔记,然后列出其笔记:
bashnode --env-file=.env notes.mjs add "Compare the Riverside flooring quotes." node --env-file=.env notes.mjs list列表应包含 Riverside 笔记,不包含第一个用户的 Lakeview 笔记。
在
.env中恢复第一个用户的邮箱和密码,保存文件,然后再次运行node --env-file=.env notes.mjs list。你应看到该用户的 Lakeview 笔记,而看不到 Riverside 笔记。
使用 Metabase 查询 Supabase 数据
Metabase 直接连接 PostgreSQL 查询项目费用。通过 Lares 使用 Supabase MCP 创建示例数据后,你需要在 Metabase 中配置数据库连接并运行报表查询。
完成 Metabase 首次设置
如果首次打开 Metabase,请先完成设置向导,再添加 Supabase 连接:
- 打开 Metabase,点击 Let's get started。
- 输入姓名、邮箱、团队名称,并为 Metabase 管理员账号设置密码。点击 Next,回答使用情况问题。
- 在 Add your data 页面,点击 Continue with sample data,继续设置,暂不连接 Supabase。你将在将 Metabase 连接到 Supabase部分添加连接。
- 选择使用数据偏好,点击 Finish,然后点击 Take me to Metabase。
获取数据库连接信息
为 Metabase 准备 Supabase 数据库主机、导出的会话端口和数据库密码。此连接使用数据库用户名 postgres.supabase。
获取数据库主机和端口
打开 Olares 设置,进入应用 > Supabase > 权限 > 导出端口 >
postgres-session。记录 Exported port。如果尚未完成,请在电脑上安装 Olares CLI,并登录你的 Olares 实例。在电脑的终端中运行:
basholares-cli settings apps get supabase记录命令输出中的顶层 URL,用作数据库主机,不要包含
https://或路径。在 Ports 列表中,检查
postgres-session的 EXPOSE 值是否与第 1 步记录的导出端口一致。在 Metabase 中使用此端口。
获取数据库密码
在 Control Hub 中,进入 Browse > supabase-{user-name} > Deployments > db,打开其 Pod,然后打开 db 容器的终端。
运行以下命令显示数据库密码:
sh. /runtime/keys.env printf '%s\n' "$POSTGRES_PASSWORD"保留此终端,添加连接时需要将密码复制到 Metabase。不要将密码粘贴到 Lares 对话中。
使用 Lares 创建项目费用表
在 Lares 中发送以下提示词,创建
project_costs并添加三条虚构的装修费用。此示例中amount的单位为美元。text使用 supabase_official 检查 public schema,并准备一张表。 project_costs:id integer 主键,project text 必填,amount integer 必填。 启用 RLS,不添加匿名访问策略。 插入以下虚构数据: 1, Lakeview, 100 2, Riverside, 200 3, Maple, 300 使用迁移修改表结构,使用 execute_sql 插入示例数据。 先展示拟执行的修改,保留现有数据,避免重复插入。检查拟执行的修改,并在 Lares 中确认。
当工具调用显示 Waiting for approval 时,检查其 SQL,并为预期操作点击 Allow once。迁移、插入示例数据和验证查询可能都需要审批,请按需重复操作。
等待 Lares 完成后,打开 Supabase Studio 的 Table Editor,选择
project_costs。检查其中是否包含提示词中的三条记录。
替代方式:在 SQL Editor 中准备数据表
如果尚未使用 Lares 创建 project_costs,在 Supabase Studio 的 SQL Editor 中运行以下查询。
create table public.project_costs (
id integer primary key,
project text not null,
amount integer not null
);
alter table public.project_costs enable row level security;
insert into public.project_costs values
(1, 'Lakeview', 100),
(2, 'Riverside', 200),
(3, 'Maple', 300);将 Metabase 连接到 Supabase
在 Metabase 中,打开右上角的 Settings 菜单,选择 Admin。进入 Databases > Add database。
选择 PostgreSQL,并填写:
字段 值 Display name Home project costsHost 获取数据库主机和端口第 3 步记录的顶层 URL,去掉 https://Port 获取数据库主机和端口第 1 步记录的 Exported port Database name postgresUsername postgres.supabasePassword 获取数据库密码中的 POSTGRES_PASSWORDUse a secure connection (SSL) 此安装包的局域网连接设为关闭 数据库管理员权限
此连接会授予 Metabase 对 Supabase 的数据库管理员级别访问权限,包括在没有 RLS 读取策略时访问
project_costs。仅在你控制的 Metabase 实例中使用这些凭据。点击 Save。
在 Home project costs 数据库页面,检查 Connection and sync 是否显示 Connected。
在 Metabase 中查询项目费用
打开右上角的 Settings 菜单,选择 Main app。
点击右上角的 New > SQL query。检查 SQL 编辑器上方的数据库选择器,如果尚未选择
Home project costs,请选择该数据库。将以下查询粘贴到 SQL 编辑器,然后点击运行按钮,列出示例项目费用:
sqlselect project, amount from public.project_costs order by id;查询返回包含
project和amount两列的表格,三行分别为Lakeview100、Riverside200 和Maple300。将编辑器中的 SQL 替换为以下查询,再次点击运行按钮计算总额:
sqlselect count(*) as records, sum(amount) as total_usd from public.project_costs;查询返回一行,显示 3 条记录,总额为 600。
故障排查
| 现象 | 检查方法 |
|---|---|
| Lares 无法连接 MCP | 使用以 /api/mcp 结尾的 Supabase Studio HTTPS URL,传输方式为 Streamable HTTP。将 Supabase Studio 入口保持为 Internal。 |
Code Server 找不到 notes.mjs 或 .env | 检查两个文件是否都在 Olares 文件管理器的 Home > Code > notes-app 中,然后在 Code Server 的 /home/coder/notes-app 目录下运行命令 |
终端提示 node: command not found | 在同一终端中运行 . "$HOME/.nvm/nvm.sh",然后运行 nvm use 22。再次运行应用前,先检查 node -v。如果尚未安装 nvm 或 Node.js 22,请按照在 Code Server 中运行笔记应用中的安装步骤操作。 |
node -v 提示缺少 libatomic.so.1 | 在 Code Server 终端中运行 sudo apt-get install -y libatomic1,然后再次检查 node -v |
| 笔记应用返回空列表 | 如果当前登录用户尚未添加笔记,返回空列表属于正常情况。如果缺少已有笔记,运行 node --env-file=.env notes.mjs whoami 检查用户,再检查笔记的 owner_id 是否与该用户 ID 一致,以及 RLS 策略是否与使用 Lares 创建笔记表和访问策略中的设置一致。 |
| Metabase 无法连接 | 检查获取数据库主机和端口中记录的数据库主机和导出的 postgres-session 端口,确认 Metabase 可以访问该主机和端口。用户名使用 postgres.supabase,密码使用获取数据库密码中取得的值。 |
了解更多
- 用 Lares 管理 Olares:选择模型并开始对话。
- 启用自托管 Supabase MCP 服务器:了解上游服务器的网络访问要求。