使用byted-supabase-cli一键部署AI Agent项目:自动构建前端、创建Supabase工作区、执行SQL迁移、部署Edge Function、注入环境变量并发布IGA Pages,生成可直接访问的线上应用链接。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想把本地写好的项目(比如带登录、文件上传、数据库交互的AI Agent原型)直接变成别人能打开链接就用的线上应用,而不是卡在“部署”这一步反复折腾数据库建表、函数上传、环境变量配置和前后端联调上。
准备本地项目结构
确保你的项目根目录下存在 supabase/migrations/ 文件夹,里面至少有一个以时间戳开头的 SQL 迁移文件(如 20240815123456_init.sql),否则部署时数据库不会初始化表结构。
确认 functions/ 目录下有至少一个 Edge Function(例如 hello/index.ts),且该函数已通过 byted-supabase-cli 本地调试验证过逻辑正确性。
前端代码需已支持标准构建流程:执行 npm run build 或 pnpm build 后生成 dist/ 或 out/ 目录,且其中包含 index.html 和静态资源文件。
安装并登录火山引擎 CLI 工具
运行 npm install -g byted-supabase-cli 安装最新版命令行工具;若已安装,请先执行 byted-supabase-cli update 升级到 v2.4.0 及以上版本——旧版本不支持 IGA Pages 的自动环境变量注入功能。
执行 byted-supabase-cli login,按提示打开浏览器完成火山引擎账号授权;授权成功后,CLI 会自动将凭证缓存至 ~/.byted-supabase/config.json。
【必须使用主账号或具备 Supabase 工作区创建权限的子用户登录】,否则后续步骤会在创建工作区时失败并返回 403 错误。
执行一键全栈部署
在项目根目录下运行:byted-supabase-cli pages fast create --project-name my-agent-app --region cn-north-1。
该命令会自动完成以下动作:构建前端静态资源 → 创建新 Supabase 工作区 → 执行 migrations 初始化 PostgreSQL 表 → 部署 functions/ 下全部 Edge Functions → 将 Supabase URL、anon key、service_role key 等自动注入前端环境变量 → 发布 IGA Pages 前端站点。
部署成功后,终端会输出类似 ✅ Preview URL: https://my-agent-app-abc123.iga.pages.volces.com 的可访问地址,该链接即为完整上线的应用入口。

















