你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

在 Azure Static Web Apps 中使用自定义域

  • 项目

默认情况下，Azure Static Web Apps 为你的网站提供自动生成的域名，但可以将自定义域指向你的站点。 免费的 SSL/TLS 证书是自动为自动生成的域名以及你可以添加的任何自定义域创建的。

将自定义域映射到静态 Web 应用时，可以使用几个选项。 可以配置子域和顶点域。

下表包含一些文章的链接，这些文章演示如何配置基于自定义域的提供程序类型。 1

操作 使用... 使用...
设置一个带有 www 子域的域 Azure DNS 外部提供程序
设置顶点域 Azure DNS 外部提供程序

1 一些注册机构（如 GoDaddy 和 Google）不支持会影响顶点域的配置的域记录。 请考虑将 Azure DNS 与注册机构结合使用来设置顶点域。

注意

不支持将自定义域添加到 预览环境 。 也不支持 Unicode 域，包括 Punycode 域和 xn-- 前缀。

关于域

一旦你的域设置完成，设置顶点域就是一个常见的配置场景。 创建顶点域是通过配置 ALIAS 或 ANAME 记录或者通过 CNAME 平展来实现的。 一些域注册机构（如 GoDaddy 和 Google）不支持这些 DNS 记录。 如果域注册机构不支持所需的所有 DNS 记录，请考虑使用 Azure DNS 配置域。

或者，对于不支持 ALIAS 记录、 ANAME 记录或 CNAME 平展的域注册机构，可以为静态 Web 应用配置记录 A 。 这会将流量定向到静态 Web 应用的单个区域主机。 不建议使用 A 记录，因为应用程序不再受益于其全局分发，如果流量全局分布，则可能会影响应用程序性能。

下面是设置自定义域时会遇到的术语。

  • 顶点域或根域：对于域 www.example.com，www 前缀被称为子域，而 example.com 的剩余部分被称为顶点域。

  • 域注册机构：注册机构验证域名的可用性，销售购买域名的权利。

  • DNS 区域：域名系统 (DNS) 区域托管与特定域关联的 DNS 记录。 有各种记录可用于出于不同目的定向流量。 例如，域 example.com 可能包含几个 DNS 记录。 一个记录处理 mail.example.com 的流量（对于邮件服务器），另一个处理 www.contoso.com 的流量（对于网站）。

  • DNS 托管：DNS 主机可以维护将域名解析为特定 IP 地址的 DNS 服务器。

  • 名称服务器：名称服务器负责存储域的 DNS 记录。

若要使用静态 Web 应用的自定义域验证，DNS 必须可公开解析。 添加域后，必须满足以下条件之一才能自动续订证书才能正常工作：

  • 确保仍存在用于通过 CNAME 验证将自定义域添加到静态 Web 应用的公共 Internet CNAME DNS 记录。 仅当 CNAME 验证用于将域添加到静态 Web 应用时，此选项才有效。
  • 确保自定义域通过公共 Internet 解析为静态 Web 应用。 无论用于将域添加到 Web 应用的验证方法如何，此选项都是有效的。 即使启用了专用终结点，此方法也是有效的，因为静态Web 应用专用终结点阻止对站点内容的 Internet 访问，但不会阻止对站点的 Internet DNS 解析。

零停机时间迁移

你可能希望将当前为生产网站提供服务的自定义域迁移到静态 Web 应用，且不会停机。 DNS 提供程序不接受同一名称/主机的多个记录，因此可以单独验证域的所有权并将流量路由到 Web 应用。

  1. 在 Azure 门户中打开静态 Web 应用。
  2. 为自定义域（APEX 或子域）添加 TXT 记录。 在 DNS 提供程序中输入主机值，而不是按如下所示输入主机值：
    • 对于 APEX 域，请输入 _dnsauth.www.<YOUR-DOMAIN.COM>。
    • 对于子域，请输入 _dnsauth.<SUBDOMAIN>.<YOUR-DOMAIN.COM>。
  3. 验证域后，可以通过更新CNAMEALIASA或记录以指向默认主机名将流量迁移到静态 Web 应用

后续步骤

访问以下链接，了解有关如何基于提供程序设置域的步骤。