本教程将引导您通过火山引擎控制台，从零完成第一个 IGA Pages 应用的部署。

前提条件 #

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

第一步：创建项目 #

1. 登录 火山引擎全站加速控制台。
2. 在左侧导航栏找到 服务概览，切换到 Pages 标签页，进入 IGA Pages 管理界面。
3. 点击 创建项目 按钮。

控制台提供三种项目创建方式，请根据自身情况选择一种。

大模型配置（可选）

在创建项目时，可以启用 大模型配置 为应用注入 AI 能力。配置完成后，系统会将相关信息写入环境变量 BASE_URL、MODEL、API_KEY，供应用代码直接读取。
提供三种接入方式：

第二步：等待构建与部署 #

您点击 创建项目 后，系统将自动执行构建和部署流程，页面会跳转到 项目详情。
部署记录 标签页显示了当前部署状态。

• 构建过程通常需要 1-3 分钟，具体时长取决于项目规模和框架类型。
  当状态变为 部署成功 时，表示应用已上线。
• 如果构建失败，点击相应部署记录查看构建日志，根据错误信息排查。
  常见原因包括缺少依赖、构建命令错误或输出目录配置不正确。可参考IGA Pages 构建指南获取详细的排查思路。

第三步：预览应用 #

部署成功后，系统会自动生成一个 预览 URL。

1. 在项目详情页找到部署记录，点击 预览 来获取预览 URL 链接。
2. 点击链接，或将其复制到浏览器地址栏打开，即可查看已部署的应用。

预览 URL 的有效期取决于您选择的加速区域：

预期结果：浏览器中能正常看到您的应用页面（通过模板创建的项目会显示对应框架的默认欢迎页）。
至此，您的第一个 IGA Pages 应用已成功部署。

第四步：绑定自定义域名（可选） #

如果您希望通过自己的域名访问应用，而非使用系统生成的预览 URL：

1. 进入项目详情页，切换到 项目设置 标签页。
2. 找到 域名管理 区域。
3. 点击 添加自定义域名，按照引导填写域名信息并完成 DNS 配置。

   说明

   加速区域为 中国大陆 时，自定义域名必须已完成 ICP 备案。

完整的域名绑定流程与 SSL 证书配置请参见绑定域名及SSL证书。

下一步 #

恭喜您完成了第一个 IGA Pages 应用的部署！根据需要，可以继续阅读以下文档深入使用：