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

前提条件 #

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

第一步：创建项目 #

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

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

大模型配置（可选）

如需为应用接入 AI 能力，请在 大模型配置 中启用 AI 加速网关。AI 加速网关兼容 OpenAI 协议，可统一调用平台免费模型和用户自有模型。如需同时接入自有模型，可选择 同时接入自有模型 并完成模型配置。

关于 AI 加速网关的详细接入方式和管理操作，请参见集成 AI 加速网关。

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

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

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

第三步：预览应用 #

部署成功后，系统能够生成预览 URL，方便您在浏览器中预览已部署的应用。

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

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

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

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

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

   说明

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

完整的域名绑定流程与 SSL 证书配置请参见自定义域名配置教程：从默认预览链接到自有域名上线。

下一步 #

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