文档中心

AI 原生 BaaS 平台 Supabase 版

Supabase 引擎用户指南

前端部署

本文介绍如何使用 AI 原生数据库管理平台完成前端部署项目的部署与实施。

背景信息

AI 原生数据库管理平台完成了与火山引擎 IGA Pages 的对接，支持基于"推送即发布"（Push-to-Deploy）的一站式发布能力。开发者将代码推送至 Git 仓库后，平台可自动完成构建、部署和线上预览，打通"自然语言生成代码"到"应用发布"的最后一环，帮助用户降低部署运维成本，快速验证和交付应用。

前提条件

已创建 Workspace 且 Workspace 的状态为运行中或已休眠。

注意事项

一个分支只能绑定一个 Pages 项目，一个 Pages 项目可绑定多个分支。多个分支绑定同一个 Pages 项目时，需要在不同分支下创建绑定关系时，指定不同的变量前缀。

绑定 Pages 项目后，分支的公网访问功能应保持开启，否则 Pages 项目将无法访问分支。

操作步骤

在分支管理页面，单击目标分支名称，进入分支总览页。

在分支总览页的前端部署页签，您可以进行绑定项目、同步变量、解绑项目等操作，具体如下。

绑定项目

（可选）在前端部署页签，单击立即授权，完成 Pages 对 AI 原生数据库管理平台的授权。

单击绑定项目，在弹出的绑定项目页面中，完成以下配置后，单击立即绑定。

配置项	是否必选	说明
Page 项目	是	选择需要与分支绑定的 Pages 项目。说明如您需要绑定新的 Pages 项目，您也可以单击新建项目，跳转至全站加速控制台，创建新的 Pages 项目。关于在全站加速控制台创建新项目的详细信息，请参见创建 IGA Pages 项目。
变量前缀	否	指定变量的前缀，用于区分 Pages 项目与不同的分支的绑定关系。说明如目标 Pages 项目只绑定当前一个分支，该配置为可选。如目标 Pages 项目已绑定了其他分支，该配置则为必选。变量前缀与框架变量前缀的总长度不能超过 30 个字符。同步的变量见下文变量说明。
框架变量前缀	否	指定框架变量的前缀，用于区分 Pages 项目与不同的分支的绑定关系。说明变量前缀与框架变量前缀的总长度不能超过 30 个字符。如使用了匹配框架约定的前缀，如 Next.js 框架的 NEXT_PUBLIC_ 、Vite 框架的 VITE_PUBLIC_，客户端可直接读取。

同步变量

在前端部署页签，单击 Pages 项目卡片右上角的同步变量，在弹出的同步变量页面中单击立即同步。

解绑项目

在前端部署页签，单击 Pages 项目卡片右上角的解绑，在弹出的确定解绑该 Pages 项目吗？页面中单击确定。

说明

解绑后将删除 Pages 项目中 Supabase 相关环境变量，请确认后操作。Pages 项目中已完成的部署不受影响。

附录

变量说明

在将 AI 原生数据库管理平台分支绑定 Pages 项目后，会将以下变量同步至 Pages 项目的环境变量。各变量的说明如下表所示。

变量名	说明
SUPABASE_ANON_KEY	Supabase API 的 anon 密钥。
SUPABASE_URL	Supabase 服务的访问连接串。
SUPABASE_SERVICE_ROLE_KEY	Supabase API 的 service_role 密钥。注意拥有该密钥，即拥有访问 Supabase 服务的所有权限，请妥善保管。
POSTGRES_URL	完整的数据库连接字符串。格式为 postgresql://用户名:密码@主机:端口/数据库名，一个变量包含所有连接信息。
POSTGRES_USER	登录数据库的用户名。
POSTGRES_HOST	数据库服务器的地址（IP 或域名）。
POSTGRES_PASSWORD	对应用户的登录密码。
POSTGRES_DATABASE	要连接的目标数据库的名称。

相关 API

API	说明
ListPagesProject	调用 ListPagesProject 接口查询租户账号下的 Pages 项目列表，支持按名称筛选、分页查询和按 Supabase 绑定关系过滤。
BindPagesProject	调用 BindPagesProject 接口将指定的 Pages 项目绑定到 Workspace/Branch，实现 Pages 应用与数据库的集成。
DescribePagesBinding	调用 DescribePagesBinding 接口查询指定 Workspace/Branch 的 Pages 绑定详情，包括绑定的项目信息和环境变量配置。
SyncPagesDeployEnvVars	调用 SyncPagesDeployEnvVars 接口将 Supabase 的环境变量同步到绑定的 Pages 项目，确保 Pages 应用能获取最新的数据库连接信息。
UnbindPagesProject	调用 UnbindPagesProject 接口解除 Pages 项目与 Supabase Workspace/Branch 的绑定关系，停止环境变量同步。
DescribeSupabaseDeployEnvVars	调用 DescribeSupabaseDeployEnvVars 接口查询可同步到 Pages 的 Supabase 环境变量。

最近更新时间：2026.06.22 20:20:51

这个页面对您有帮助吗？

有用

无用