配置自定义域名

在扣子编程部署网页应用时支持使用扣子编程默认域名或自定义域名。若希望项目有更强的品牌辨识度，你可以将项目部署到自定义域名，以便打造独特的品牌形象，提升用户对品牌的认知度和信任感。本文介绍配置自定义域名的详细步骤。

域名概述

扣子编程会为每个部署项目自动分配以 .coze.site 为后缀的默认域名。你也可以将项目绑定至自定义域名，以便打造专属品牌访问地址，使网站地址更容易被用户记住，还能提升品牌知名度。
你可以从火山引擎购买域名，或使用从第三方服务商处购买的域名。使用自定义域名时，你需要在火山引擎为自定义域名进行备案，并配置 SSL 证书。
默认域名和自定义域名使用方式的区别如下：

费用说明

• 购买火山引擎域名时，火山引擎域名服务产品会收取域名服务费用，这些费用自动从你的火山引擎余额中扣款，不支持用扣子积分抵扣。具体收费标准可参考域名服务计费文档。
• 购买火山引擎的证书时，火山引擎证书中心会收取 SSL 证书费用，这些费用自动从你的火山引擎余额中扣款，不支持用扣子积分抵扣。具体收费标准可参考SSL证书计费说明。

使用限制

配置自定义域名时，存在项目类型、免费证书额度等限制。详情请参见配额与限制。

操作步骤

步骤一：购买域名

在配置自定义域名之前，你需要先购买一个域名。本文以购买火山引擎域名为例，如果你已经从其他服务商处购买了域名，可以跳过本步骤。
使用限制
仅火山主账号或具备 DomainFullAccess 权限的 IAM 用户，才支持购买火山引擎域名。
操作步骤

1. 打开扣子编程建站域名特惠页面。注册域名的详细说明请参见注册域名。
2. 单击相应的域名类型卡片，在域名搜索框中，输入你想注册的域名，单击搜索按钮。
   
3. 在对应域名右侧单击立即购买。根据界面提示完成支付，域名就注册成功了。
   注册域名后，域名会自动进入实名认证流程。打开域名列表页面，你可以查看实名认证的状态。

步骤二：备案域名

根据国家相关法规，所有在中国内地提供服务的网站都必须进行 ICP 备案。由于你的网页应用由扣子编程统一部署在火山引擎的服务器上，因此需要在火山引擎备案系统对域名进行备案。

1. 登录火山引擎备案控制台，单击开始备案。
2. 根据页面提示，填写主办者信息和备案信息，等待审核通过。不同场景的备案流程稍有差异，具体如下表所示。

   场景	备案流程
   首次购买域名，且没有任何备案历史。	首次备案流程
   域名已在其他服务商备案，现需指向火山引擎服务器。	接入备案流程
   你已有其他域名在火山引擎备案，需为新域名备案。	新增服务流程

步骤三：购买或上传 SSL 证书

为确保数据传输的安全，你需要为你的域名准备 SSL证书，以免访问网页时被拦截。扣子编程支持三种证书，具体说明如下。

步骤四：在扣子侧配置自定义域名

完成域名准备和备案后，就可以在你的 AI 编程开发的项目中绑定自定义域名。

1. 在扣子编程左侧导航栏选择项目管理，筛选带有 New 标签的项目，单击目标项目。
   

2. 在 AI 编程开发界面的右上角单击部署。
   

3. 在部署页面的部署域名右侧单击添加域名。

4. 在域名页面单击添加域名，在添加域名对话框中，输入该项目使用的具体域名。
   域名后缀为步骤一中准备好的域名。例如，备案的域名为二级域名example.com，此处可以填写三级域名web.example.com。
   

5. 单击保存域名，下一步。
   扣子编程会为你生成一条解析记录。
   

6. 复制解析记录中的记录值，并在 DNS 中添加对应的解析记录，DNS 侧的配置方法请参考在 DNS 侧为域名配置解析记录。

7. 配置 SSL 证书。
   为确保数据传输的安全，你需要为你的域名配置 SSL证书。扣子编程提供两种证书配置方式。

   证书类型	说明	配置方式
   免费证书	适用于需要为自定义域名快速、免费启用 HTTPS 的场景，例如个人项目或开发测试环境。 有效期与额度：免费证书遵循火山引擎的统一策略，有效期为 3 个月，每个主账号在一个自然年内拥有 20 次免费证书的生成额度。 额度可用：为避免证书过期导致服务中断，强烈建议勾选自动轮转。只要年度额度有剩余，系统将在证书到期前自动为你生成并替换新证书。 额度用尽：当年度免费证书额度用尽时，自动轮转功能将失效。 过期通知：扣子会在证书到期前 3 个工作日向你发送过期提醒。收到通知后，你需要及时切换为付费的火山引擎证书，或等待下一自然年额度重置后，重新生成免费证书。	单击生成免费证书。扣子编程将自动生成免费证书并完成证书安装，整体过程预计需要 3~5 分钟。同时，建议你勾选自动轮转。
   火山引擎证书	适用于对稳定性要求较高的生产环境，或当免费证书额度用尽后，需要为自定义域名提供长期、可靠的 HTTPS 服务。 有效期：通常为 1 年。 购买：根据页面提示先购买火山引擎证书，详细操作说明请参见 SSL 证书快速入门。 续费：​在证书到期前 30天 内执行续费，否则证书将自动失效，详细操作说明请参见续费 SSL 证书。	单击选择并添加，在下拉列表中选择你已购买的火山引擎证书，扣子编程将自动完成证书安装。

相关操作

在 DNS 侧为域名配置解析记录

在你的域名服务商的 DNS 控制台，将扣子编程提供的解析记录添加到对应域名的解析记录中，从而让域名指向扣子编程为你分配的应用服务器地址。
以下是某域名服务商 DNS 控制台的配置示例，在公网权威解析页面，添加对应的域名，并为对应的域名添加一条解析记录。其中，解析记录中的记录值为步骤四：在扣子侧配置自定义域名中复制的解析记录的值。火山引擎 DNS 的配置方法请参考添加解析记录。

部署项目

完成自定义域名配置后，单击右上角的部署，即可部署该项目，具体步骤可参考部署网页应用。

查看域名配置

你可以查看自定义域名的配置，包括完整的域名、域名解析记录、证书的有效期等信息，你也可以重新添加证书。

1. 在扣子编程左侧导航栏选择项目管理，筛选带有 New 标签的项目，单击目标项目。
   

2. 在 AI 编程开发界面，在右侧单击➕打开新的标签页，在弹出的标签页中选择部署。
   

3. 在部署页面的域名页签中，在目标域名右侧单击查看配置。你可以执行以下操作：

   • 查看完整域名：你可以复制此地址，用于分享给你的用户，以便访问网页。
   • 查看 DNS 解析记录：你可以复制此处的解析记录，将其添加到 DNS 的解析记录中。
   • 查看证书类型和有效期：你可以查看当前配置证书的类型和有效期。如果证书即将过期，你可以添加新的证书。
   • 删除域名：当需要更换项目的域名时，你可以从你的项目中解除该域名的绑定。

     说明

     删除域名后，用户将无法通过此域名访问该服务。此操作不可逆，请在执行前仔细确认。

常见问题

• 域名已在其他服务商那边备案，还需要重新备案吗？
• 备案审核需要多长时间？
• 备案未完成会影响部署吗？
• 扣子生成的免费证书和火山证书有什么区别？
• 可以使用其他厂商的 SSL 证书吗？
• 免费证书到期后能生成新的免费证书吗？