全站加速
全站加速
- 文档首页
全站加速IGA Pages控制台操作指南创建 IGA Pages 项目
复制全文
下载 pdf
文档反馈
问问助手在 IGA Pages 中，每个 Web 应用以一个项目的形式管理。通过创建项目，您可以将 AI 智能体应用或其他 Web 应用部署到火山引擎全站加速网络上。
IGA Pages 支持三种项目创建方式：模板创建、上传文件创建和导入 Git 仓库，分别适用于快速体验、手动部署和持续集成场景。
前提条件
- 一个已完成实名认证的火山引擎账号。
- 本地项目文件 / 一个 GitHub 账号（无论是否包含项目文件）。
操作步骤
第一步：进入创建页面
- 登录全站加速控制台。
- 在左侧导航栏，点击 服务概览。
- 切换到 Pages 标签页，点击 创建项目。
第二步：选择创建方式
在 创建方式 选项中，选择以下任一方式：
模板创建
选择一个预置的应用模板，由平台自动为您创建应用的示例项目代码，适合快速体验。
- 选择模板：关于模板的介绍，请参见支持的框架与项目类型。点击模板卡片上的 预览，可查看示例项目的预览效果。
- 代码配置：
- 代码源类型：生成的项目代码仅支持保存到您的 GitHub 仓库。
注意
首次使用必须先完成 GitHub 账号授权，详见下文GitHub 账号授权。
- 用户名：选择已经授权的 GitHub 账号。系统将在账号下创建一个新的仓库来保存项目代码。
- 新建仓库名：设置新建仓库的名称。
- 仓库属性：设置新建仓库的属性。
- 代码源类型：生成的项目代码仅支持保存到您的 GitHub 仓库。
上传文件创建
从本地上传 ZIP 压缩包（大小不超过 1024 MB），其中包含您的源代码。此方式无需 GitHub 授权，适合不希望授权第三方访问代码仓库的用户。
导入 Git 仓库
从您的 GitHub 仓库自动拉取代码并完成构建，实现持续交付。
注意
首次使用必须先完成 GitHub 账号授权，详见下文GitHub 账号授权。
- 用户名：选择已经授权的 GitHub 账号。
- 仓库名：从所选 GitHub 账号下选择需要拉取的代码仓库。
第三步：基本配置
- 在 项目名称 中，输入一个用以标识该项目的名称。
- 在 加速区域 中，根据用户的地理分布选择 中国大陆 或 海外。
说明
加速区域为 中国大陆 时，后续绑定的自定义域名必须已完成 ICP 备案。关于域名设置的更多信息，请参见域名管理。
第四步：大模型配置（可选）
如果您的应用需要调用大模型服务，可开启 大模型配置，然后选择以下任一方式完成配置：
配置方式 | 说明 |
|---|---|
一键快速创建大模型 | 系统自动对接火山方舟平台并创建 API Key。默认使用的模型为 |
火山方舟模型 | 系统自动对接您的火山方舟资源，由您选择已创建的 API Key 和 推理接入点。 |
其他模型 | 自定义第三方大模型服务的 Base URL、模型名称、API Key（以 OpenAI 格式调用）。 |
配置完成后，IGA Pages 将配置保存为以下环境变量，供应用代码在运行时读取：
环境变量 | 说明 |
|---|---|
| 大模型服务的 API Endpoint。 |
| 大模型服务的模型名称。 |
| 大模型服务的 API Key。 |
说明
如果添加了多个大模型配置，环境变量名会自动加序号后缀，如 MODEL_BASE_URL_1、MODEL_NAME_1、MODEL_API_KEY_1，依此类推。后续如需新增其他运行时配置，请参见环境变量。
第五步：火山 Supabase 配置（可选）
如果您的应用需要数据库、认证等后端能力，可开启 火山 Supabase 配置，为项目绑定火山引擎 Supabase 工作空间（Workspace）。绑定后，Supabase 的连接信息会以环境变量形式自动注入项目。
开启 火山 Supabase 配置 开关。
完成 实例配置：
- 引擎：选择 Supabase 引擎版本（如 Supabase 1.24）。
- 服务授权：首次使用需完成跨服务授权，授权 IGA Pages 访问您的火山引擎 Supabase 资源。关于跨服务授权的详细说明，请参见开通跨服务授权。
- 名称：设置工作空间名称，规格为 Serverless。
勾选并同意《产品和服务测试协议》，完成配置。
注意
开启火山 Supabase 配置会创建 Supabase 工作空间并产生计费，具体以火山引擎 Supabase 的计费标准为准。
说明
如果您已在火山引擎 Supabase 中创建了工作空间，也可以在项目创建完成后，通过项目详情的 拓展能力 标签页绑定已有工作空间。绑定操作详情，请参见集成火山引擎 Supabase。关于火山引擎 Supabase 自身的使用，请参见前端部署。
第六步：确认创建
检查所有配置无误后，点击 创建项目 完成创建。系统会自动跳转到 项目详情 页面，并启动首次构建。
创建之后
项目创建后，您接下来通常会执行以下操作：
- 等待首次部署完成：在 部署记录 标签页，等待状态变为 部署成功（通常需要 1-3 分钟）。
- 获取预览地址：点击右上角 预览，复制临时预览 URL 在浏览器中打开。详见管理 IGA Pages 部署。
- 绑定自定义域名（生产环境推荐）：默认预览域名仅 3 小时有效，生产环境请绑定自有域名。详见域名管理。
- 追加环境变量（可选）：如需注入数据库连接、第三方密钥、构建参数等配置，详见环境变量。
- 调整构建配置（可选）：如需修改框架、构建命令、Node.js 版本等，详见构建配置、Node.js 版本。
GitHub 账号授权
仅 模板创建 和 导入 Git 仓库 两种方式需要 GitHub 授权。如不希望授权，可改用 上传文件创建。
授权原理
全站加速通过名为 volc-iga-pages 的 OAuth 应用代理对您 GitHub 代码库的操作，不会存储您的 GitHub 登录信息。GitHub 账号授权需要您登录 GitHub 账号，并授权 volc-iga-pages 应用访问您的代码库。
添加 GitHub 账号授权
在 IGA Pages 项目创建页面，选择以下 创建方式 之一：模板创建 或 导入 Git 仓库创建。
在 用户名 下拉菜单底部，点击 添加 GitHub 账号授权。
在弹出的对话框，登录您的 GitHub 账号，并同意授权 IGA Pages 应用。
当出现“GitHub 绑定授权成功”提示后，关闭该对话框，回到项目创建页面。
点击 用户名 下拉列表旁边的刷新按钮，列表中将会出现最新授权的用户名。
解除 GitHub 账号授权
如需解除授权，请在您的 GitHub 账号中操作：
- 登录 GitHub，打开账号 Settings。
- 在左侧导航栏，点击 Integrations 下的 Applications。
- 切换到 Authorized OAuth Apps 标签页。
- 找到 IGA Pages 应用，选择 Revoke。