在 IGA Pages 中，每个 Web 应用以一个项目的形式管理。通过创建项目，您可以将 AI 智能体应用或其他 Web 应用部署到火山引擎全站加速网络上。
IGA Pages 支持三种项目创建方式：模板创建、上传文件创建和导入 Git 仓库，分别适用于快速体验、手动部署和持续集成场景。

前提条件 #

• 一个已完成实名认证的火山引擎账号。
• 本地项目文件 / 一个 GitHub 账号（无论是否包含项目文件）。

操作步骤 #

第一步：进入创建页面 #

1. 登录全站加速控制台。
2. 在左侧导航栏，点击 服务概览。
3. 切换到 Pages 标签页，点击 创建项目。

第二步：选择创建方式 #

在 创建方式 选项中，选择以下任一方式：

模板创建

选择一个预置的应用模板，由平台自动为您创建应用的示例项目代码，适合快速体验。

• 选择模板：关于模板的介绍，请参见支持的框架与项目类型。点击模板卡片上的 预览，可查看示例项目的预览效果。
• 代码配置：
  • 代码源类型：生成的项目代码仅支持保存到您的 GitHub 仓库。

    注意

    首次使用必须先完成 GitHub 账号授权，详见下文GitHub 账号授权。

  • 用户名：选择已经授权的 GitHub 账号。系统将在账号下创建一个新的仓库来保存项目代码。
  • 新建仓库名：设置新建仓库的名称。
  • 仓库属性：设置新建仓库的属性。

上传文件创建

从本地上传 ZIP 压缩包（大小不超过 1024 MB），其中包含您的源代码。此方式无需 GitHub 授权，适合不希望授权第三方访问代码仓库的用户。

导入 Git 仓库

从您的 GitHub 仓库自动拉取代码并完成构建，实现持续交付。

• 用户名：选择已经授权的 GitHub 账号。
• 仓库名：从所选 GitHub 账号下选择需要拉取的代码仓库。

第三步：基本配置 #

1. 在 项目名称 中，输入一个用以标识该项目的名称。
2. 在 加速区域 中，根据用户的地理分布选择 中国大陆 或 海外。

   说明

   加速区域为 中国大陆 时，后续绑定的自定义域名必须已完成 ICP 备案。关于域名设置的更多信息，请参见域名管理。

第四步：大模型配置（可选） #

如果您的应用需要调用大模型服务，可开启 大模型配置，然后选择以下任一方式完成配置：

配置完成后，IGA Pages 将配置保存为以下环境变量，供应用代码在运行时读取：

第五步：确认创建 #

检查所有配置无误后，点击 创建项目 完成创建。系统会自动跳转到 项目详情 页面，并启动首次构建。

创建之后 #

项目创建后，您接下来通常会执行以下操作：

• 等待首次部署完成：在 部署记录 标签页，等待状态变为 部署成功（通常需要 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 账号授权 #

1. 在 IGA Pages 项目创建页面，选择以下 创建方式 之一：模板创建 或 导入 Git 仓库创建。

2. 在 用户名 下拉菜单底部，点击 添加 GitHub 账号授权。

3. 在弹出的对话框，登录您的 GitHub 账号，并同意授权 IGA Pages 应用。

4. 当出现“GitHub 绑定授权成功”提示后，关闭该对话框，回到项目创建页面。

5. 点击 用户名 下拉列表旁边的刷新按钮，列表中将会出现最新授权的用户名。

解除 GitHub 账号授权 #

如需解除授权，请在您的 GitHub 账号中操作：

1. 登录 GitHub，打开账号 Settings。
2. 在左侧导航栏，点击 Integrations 下的 Applications。
3. 切换到 Authorized OAuth Apps 标签页。
4. 找到 IGA Pages 应用，选择 Revoke。