完成 IGA Pages 项目首次部署后，如需预览项目，IGA Pages 会分配一个形如 your-project-xxx.preview.iga-pages.com 的预览链接。这个链接面向开发自测使用，存在以下限制：

• 预览链接有效期为 3 小时，过期后需要重新生成新的地址。
• 预览链接不是生产可用形态，既不利于品牌呈现和 SEO，也不便于稳定对外分享。

要让项目以稳定规范的形态长期运行，需要把它绑定到自有域名。本教程覆盖从准备域名、ICP 备案、控制台添加域名、DNS 解析到 SSL 证书的完整流程，并给出阿里云、GoDaddy 等主流 DNS 服务商的配置入口。

基础概念速览 #

在开始操作前，先明确几个会反复出现的概念，它们决定了后续流程的顺序与耗时。

加速区域决定流程差异 #

IGA Pages 项目在创建时会绑定一个 加速区域，这是后续自定义域名流程差异的根源。

• 中国大陆：受工信部监管要求约束，自定义域名必须先完成域名所有权验证（通过 TXT 记录），并且域名必须已完成 ICP 备案，缺一不可。控制台在添加域名环节会强校验，未备案的域名会被直接拒绝。
• 全球（不含中国内地）：无需域名所有权验证，也无需 ICP 备案，输入域名后直接通过控制台校验。

下图展示了从一个新域名到通过 IGA Pages 正式上线的完整时序，海外路径会跳过域名验证与备案两步。

预计耗时：

• 海外业务通常 1–2 小时（主要等 DNS 生效）。
• 中国大陆业务在备案完成的前提下也是 1–2 小时，若需新办备案则整体耗时 7–20 个工作日。

准备域名 #

如果还没有域名，需要先在域名注册商处注册。下表列出主流注册商的入口，可按账号体系与价格选择。

ICP 备案（仅中国大陆区域） #

如果项目的加速区域是 全球（不含中国内地），可以跳过本节，直接进入下一节。
加速区域为 中国大陆 时，IGA Pages 会强制要求域名已完成 ICP 备案，否则在添加域名时控制台会直接报错“域名未备案”。下图描述了备案决策路径：

如果域名将通过火山引擎对外提供服务（IGA Pages 即属于此场景），可直接在火山引擎备案中心办理，详细流程见 ICP 备案文档。办理过程中需要准备主体材料（营业执照或身份证）、域名证书、联系方式以及网站负责人核验照片或视频。
备案号下发后，再回到本教程继续。

在 IGA Pages 控制台添加自定义域名 #

操作路径：详见添加自定义域名。

中国大陆区域：先验证所有权，再添加域名 #

中国大陆区域下，添加自定义域名是一个两步流程：先在弹窗内完成域名所有权验证，验证通过后才能正式把域名加入列表。

1. 打开 添加自定义域名 弹窗后，输入要绑定的域名（如 app.example.com），弹窗会即时校验该域名的备案状态。未备案会直接报错，无法继续，需要先完成备案流程。
   

2. 域名通过备案校验后，弹窗会展开第二步 前往 DNS 服务商配置如下 TXT 记录，给出一条形如下面的记录：

   • 记录类型：TXT
   • 主机记录：dcdn_verification
   • 记录值：yuj3SZAnQi6wtfVBKEnBjKWN4Mg9qWZC（示例，每次不同）

   

3. 到 DNS 服务商处把这条 TXT 记录添加到对应域名下（具体操作见[中国大陆区域：先添加 TXT，再添加 CNAME](/docs/6559/2387334#6.2 中国大陆区域：先添加 TXT，再添加 CNAME)）。

4. 保存后回到弹窗点击 验证域名。

5. 系统会即时查询 DNS，验证通过后点击 确定 按钮，将域名添加到列表。

这一步常见疑问是“TXT 验证后是不是就能访问了？”——不是。TXT 记录只解决所有权归属问题，访问流量的接入要靠后续的 CNAME 记录。

海外区域：直接添加，无所有权验证 #

加速区域为 全球（不含中国内地） 时，弹窗只有域名输入框一项，输入域名后控制台会即时进行格式校验，校验通过后直接点 确定 即可添加。

添加完成后：从列表取 CNAME #

无论中国大陆还是海外，域名添加成功后都会出现在 域名管理 列表中。列表会显示该域名对应的 CNAME，形如 app.example.com.c.vedcdnlb.com。这是后续配置 DNS 流量接入要用到的目标地址。
至此控制台侧的添加动作完成，下一步进入 DNS 服务商配置 CNAME，把访问流量真正接到 IGA Pages。

配置 DNS 解析 #

DNS 配置在域名所属的 DNS 服务商处完成。各家服务商配置字段（主机记录、记录类型、记录值）一致，只是控制台界面有差异。

主流 DNS 服务商对照 #

其他常见服务商如 Cloudflare、DNSPod、Namecheap、AWS Route 53 操作流程类似：在对应控制台找到目标域名 → 解析记录 / DNS Records → 添加记录。

中国大陆区域：先添加 TXT，再添加 CNAME #

中国大陆区域下需要分两次配置 DNS。

• 第一次发生在在 IGA Pages 控制台添加自定义域名的弹窗仍然打开时。按弹窗给出的 TXT 内容到 DNS 服务商添加一条 TXT 记录。TTL 保持默认（10 分钟左右），保存后回到弹窗点 验证域名 即可。
  
  这条 TXT 记录用于一次性所有权验证，验证通过后保留与否都不影响后续访问，但通常建议保留以备复核。
• 第二次发生在域名添加完成，列表中已显示域名对应的 CNAME 之后。继续在同一 DNS 控制台为该域名添加一条 CNAME 记录，主机记录填子域名前缀（如 app），记录值填列表中给出的 CNAME 地址（如 app.example.com.c.vedcdnlb.com），TTL 保持默认。
  

海外区域：只需添加 CNAME #

海外区域跳过 TXT 验证，添加域名后直接进入这一步：在 DNS 服务商处为该域名添加一条 CNAME 记录，主机记录填子域名前缀，记录值填域名管理列表中显示的 CNAME 地址。

验证 DNS 是否生效 #

配置完成后可在终端执行 dig app.example.com +short 或 nslookup app.example.com，返回结果包含 IGA Pages 的 CNAME 目标地址即表示生效。也可以回到 IGA Pages 项目设置中，查看域名的 DNS 记录 状态，若为 已设置，表示配置已生效。

配置 SSL 证书 #

启用 HTTPS 是现代 Web 应用的基础要求，浏览器对纯 HTTP 站点会显示“不安全”提示。IGA Pages 自身不签发证书，证书的来源是火山引擎证书中心或 DCDN 服务中托管的已有证书，也支持直接上传证书。

准备一张可用的证书 #

如果您还没有证书，可以通过火山引擎证书中心或第三方 CA（如 DigiCert、GlobalSign）购买证书。证书中心也提供免费 DV 证书，供测试使用。详情参见创建 SSL 证书订单、申请免费证书。

在 IGA Pages 中选用证书 #

操作路径：详见配置 SSL 证书。
在 配置证书 弹窗中，您可以从本地上传证书或选择已经托管在证书中心 / DCDN 服务中的证书。

• 新上传证书：上传一张与当前域名匹配的证书。
  
• 已有托管证书：从已托管的证书列表中选择一张匹配当前域名的证书。
  

证书配置完成后，通常 1–5 分钟内 HTTPS 即可访问。如果证书有效期接近到期，需要在证书中心提前续签或上传新证书，IGA Pages 不会自动续签上游证书。

验证最终访问 #

完成上述配置后，按以下顺序验证：

1. 浏览器输入 https://app.example.com 应正常返回项目页面，地址栏显示安全连接标志。
   
2. 输入 http://app.example.com 应自动跳转至 HTTPS。
3. 点击地址栏安全连接标志，确认证书颁发者与有效期符合预期。
4. 条件允许时，使用不同地域网络（如手机 4G、海外 VPN）验证全球可达性，IGA Pages 已通过全站加速节点完成分发。

至此，项目已通过自有域名稳定对外提供服务，不再受预览链接 3 小时有效期限制。

常见问题 #

Q1：海外区域为什么不用做域名所有权验证和备案？ #

域名所有权验证与 ICP 备案都是中国大陆区域的合规要求：备案是工信部要求，所有权验证是 IGA Pages 在中国大陆区域为配合上游链路审核而强制的前置校验。海外区域不在监管范围内，因此控制台在该区域跳过这两步。

Q2：CNAME 配置后访问报错或仍指向旧站点？ #

先检查同一主机记录下是否存在冲突的 A 记录或其他 CNAME 记录。DNS 不允许同名重复，删除冲突记录后保留新增的 CNAME 即可。其次浏览器或本地 DNS 缓存可能还没刷新，使用 dig 命令或更换网络环境验证更准确。

Q3：根域名（不带子域名前缀）能不能绑定？ #

部分 DNS 服务商不支持根域名的 CNAME 记录。建议优先绑定子域名（www.example.com、app.example.com），并在根域名层做 301 跳转；或者使用支持 ALIAS / ANAME 等价能力的 DNS 服务商。

Q4：如何解绑域名或更换域名？ #

进入项目设置 → 域名管理 → 找到目标域名 → 删除。删除后该域名将不再接入 IGA Pages 流量；如需更换，按本教程重新走一次流程即可。建议在低峰期操作，避免影响线上访问。