IGA Pages 支持集成火山引擎 Supabase，为您的 Web 应用快速接入数据库、认证、存储等后端能力（BaaS），无需自行搭建和运维后端服务。完成绑定后，IGA Pages 会将 Supabase 工作空间（Workspace）的连接信息以环境变量形式自动注入项目，应用代码在构建和运行时即可直接读取，无需手动配置。

本文介绍如何在 IGA Pages 控制台为项目绑定火山引擎 Supabase。您也可以在火山引擎 Supabase 控制台侧完成 Pages 项目的集成，详情请参见前端部署。

前提条件 #

• 已创建 IGA Pages 项目。详情请参见创建 IGA Pages 项目。
• 已在火山引擎 Supabase（AIDAP）中创建工作空间与分支。详情请参见相关文档。

开通跨服务授权 #

IGA Pages 访问您的火山引擎 Supabase 资源前，需先完成跨服务授权。授权时，系统会为账号创建以下两个服务关联角色：

首次进入 Supabase 集成页时，可按以下步骤开通授权：

1. 登录全站加速控制台。
2. 在左侧导航栏，点击 服务概览。
3. 切换到 Pages 标签页，再切换到 扩展能力 子标签页。
4. 在 Supabase（火山引擎） 卡片中，点击 管理。首次进入会显示 开启扩展能力 引导页。
   
5. 点击 开通跨服务授权，在跳转的授权页中确认上述两个角色，点击 授权。
   
   完成授权后，即可进行绑定操作。

绑定火山引擎 Supabase #

IGA Pages 提供两个绑定入口，对应两种视角，创建的绑定关系互通，您可按使用习惯任选其一：

• Supabase 视角：在 扩展能力 的 Supabase 列表中操作，先 添加 一条分支与 Pages 项目的绑定，再针对该分支 新建绑定 更多 Pages 项目，实现一个分支绑定多个 Pages 项目。
• Pages 项目视角：在某个项目的 项目详情 中操作，绑定对象固定为当前 Pages 项目，可为其 新建绑定 多个 Supabase 分支。

从 Supabase 列表绑定 #

在 Supabase 列表中，您先通过 添加 建立一条 Supabase 分支与 Pages 项目的绑定；之后可针对该分支 新建绑定 更多 Pages 项目或 解除绑定，也可再次 添加 绑定其他分支。

1. 登录全站加速控制台。

2. 在左侧导航栏，点击 服务概览。

3. 切换到 Pages 标签页，再切换到 扩展能力 子标签页。

4. 在 Supabase（火山引擎） 卡片中，点击 管理，进入 Supabase 列表。

5. 点击右上角的 添加，在弹出的配置中完成以下设置，将一个 Supabase 工作空间下的分支与一个 Pages 项目建立关联：

   配置项	说明
   Supabase	依次选择目标工作空间所在的地域、工作空间及分支。
   Pages 项目	选择要与该分支关联的 Pages 项目。
   前端框架	系统会根据所选 Pages 项目自动识别框架（如 Next.js、Vite）。无法自动识别时，可手动选择。
   客户端环境变量前缀	注入客户端可见环境变量时使用的框架变量前缀。系统会根据前端框架自动填充（如 Next.js 为 NEXT_PUBLIC_、Vite 为 VITE_），也可手动修改。

   

6. 点击 确定，完成绑定。绑定后的分支会作为一条记录显示在 Supabase 列表中。

在列表中的每条记录上，您可以继续管理该分支的绑定关系：

• 新建绑定：为该分支再关联其他 Pages 项目，实现一个分支绑定多个 Pages 项目。
• 解除绑定：移除该分支与某个 Pages 项目的绑定，其注入的环境变量会同步移除。

如需绑定其他 Supabase 分支，可再次点击列表右上角的 添加。

从 Pages 项目绑定 #

在某个 Pages 项目的详情页中，绑定对象固定为当前 Pages 项目，您可以为它 新建绑定 多个 Supabase 分支。

1. 登录全站加速控制台。
2. 在左侧导航栏，点击 服务概览。
3. 切换到 Pages 标签页，在项目列表中点击您的项目 ID。
4. 在项目详情中，切换到 拓展能力 标签页。
5. 在 Supabase（火山引擎） 卡片右上角，点击 新建绑定。
6. 在弹出的配置中，Pages 项目已固定为当前项目，选择要绑定的 Supabase 工作空间与分支，确认 客户端环境变量前缀 后，点击 确定。

绑定完成后，在 拓展能力 标签页的 Supabase（火山引擎） 卡片上，您还可以对该绑定执行以下管理操作：

• 更新环境变量：点击 更新环境变量，在弹出的对话框中修改 客户端环境变量前缀，系统会按新前缀更新注入到该 Pages 项目的环境变量。前缀必须以字母开头，且只能包含英文字母、数字和下划线。
• 解除绑定：点击 解除绑定，移除该 Pages 项目与对应 Supabase 分支的绑定，其注入的环境变量会同步移除。

注入的环境变量 #

绑定成功后，IGA Pages 会将 Supabase 工作空间的连接信息写入项目环境变量，供应用在构建和运行时读取。下表中的 <前缀> 表示客户端环境变量前缀，其取值随前端框架变化（Next.js 为 NEXT_PUBLIC_、Vite 为 VITE_；若前缀留空则无前缀）：

解除绑定 #

如不再需要某个绑定，可在 Supabase 列表或项目详情的 Supabase（火山引擎） 卡片中，找到对应绑定并点击 解除绑定。解除后，该绑定注入的环境变量会同步移除。

通过 CLI 操作 #

除控制台外，您也可以使用 IGA Pages CLI 完成集成绑定与环境变量管理。详情请参见IGA Pages CLI 使用手册。