本文介绍 IGA Pages 项目设置页支持的全部配置项，包括域名、环境变量、Git 仓库、构建配置、Node.js 版本以及项目删除。

前提条件 #

您已经创建了 IGA Pages 项目。详情请参见创建 IGA Pages 项目。

进入项目设置页 #

1. 登录全站加速控制台。
2. 在左侧导航栏，点击 服务概览。
3. 切换到 Pages 标签页，然后在项目列表中点击您的项目 ID。
4. 在项目详情中，切换到 项目设置 标签页。

项目设置 包含以下模块：

域名管理 #

创建 IGA Pages 项目后，系统会自动生成一个测试域名（*.preview.iga-pages.com）用于临时预览，但默认域名有访问期限和校验限制。生产环境建议绑定自有域名，并配置 SSL 证书启用 HTTPS。

添加自定义域名 #

1. 在 域名管理 模块，点击 添加自定义域名。
2. 在 添加自定义域名 对话框中，输入您的域名。
3. 如果项目绑定的加速区域是 中国大陆，首次添加该域名时，系统会要求验证域名所有权。请按界面提示，在您的 DNS 服务商处添加一条 TXT 记录，记录值由系统提供。
   
4. 点击 确定，完成域名添加。

域名添加成功后，在域名记录的 CNAME 列，会显示系统分配的 CNAME 名称。请在您的 DNS 服务商处创建一条 CNAME 记录，将您的域名指向该 CNAME 名称。

配置 SSL 证书 #

1. 在域名记录的 证书 列，点击 配置证书。
2. 直接上传证书文件，或选择火山引擎证书中心 / DCDN 服务托管的已有证书。

   注意

   证书必须与当前域名匹配。

3. 点击 确定。

证书生效后，您的自定义域名即可通过 HTTPS 访问。

环境变量 #

环境变量是项目运行时注入到应用进程中的键值对，常用于保存 API Key、数据库连接串、第三方服务地址等运行时配置。修改环境变量后需触发下次部署才会生效。

添加环境变量 #

1. 在 环境变量 模块，点击 添加环境变量。
2. 输入 Key 和 Value，点击 确定。

编辑 / 删除环境变量 #

在环境变量列表中，点击对应行的 编辑 或 删除。

与大模型配置的关系 #

如果在创建项目时开启了 大模型配置，系统会自动写入以下环境变量，可在此处直接查看或修改：

配置多个大模型时会自动加序号后缀，如 BASE_URL_1、MODEL_1、API_KEY_1。

限制项 #

Git 管理 #

当前仓库 #

显示当前项目绑定的 GitHub 仓库链接，点击可跳转至 GitHub 查看。

解除关联 #

如果不再希望通过 Git 推送自动触发部署，可点击 解除关联，在弹窗中点击 确认 完成解绑。

切换部署分支 #

默认情况下，推送到 main 分支的每次提交将触发生产部署。如需切换到其他分支：

1. 点击 部署分支 下拉框旁的刷新按钮，拉取仓库最新分支列表。
2. 在下拉框中选择目标分支。
3. 点击 保存。

切换后，该分支的下一次推送即会触发部署。

构建配置 #

构建配置决定了 IGA Pages 在云端如何安装依赖、构建您的项目。系统会根据仓库内容自动识别框架并填充默认值，您也可以手动覆盖。

字段说明 #

修改后点击 保存，下次部署时生效。

Node.js 版本 #

构建和运行 Functions 时使用的 Node.js 版本。请根据项目依赖的 Node.js 特性选择合适的版本。
操作步骤：

1. 在 Node.js 版本 模块，从下拉框中选择需要的版本（当前仅支持 20.x）。
2. 点击 保存。

修改后下次部署时生效，不会影响当前线上版本。

删除项目 #

如不再需要该项目，可在 删除项目 模块点击 删除此项目。

如确认删除，请在弹出的确认框中按提示输入项目名称完成二次确认。