具有 Azure Static Web Apps 的自訂網域

根據預設，Azure Static Web Apps 會為您的網站提供自動產生的網域名稱，但您可以將自訂網域指向您的網站。 系統會為自動產生的網域名稱，以及您可能新增的任何自訂網域自動建立免費的 SSL/TLS 憑證。

當您將自訂網域對應至靜態 Web 應用程式時，有幾個可用選項，其中包括設定子網域和頂點網域。

下表包含文章的連結，這些文章示範如何設定自訂網域型提供者類型。 ¹

動作	使用...	使用...
設定一個具有 www 子網域的網域	Azure DNS	外部提供者
設定頂點網域	Azure DNS	外部提供者

¹ 某些註冊機構 (例如 GoDaddy 和 Google) 不支援會影響您設定頂點網域方式的網域記錄。 請考慮搭配這些註冊機構使用 Azure DNS，來設定頂點網域。

注意

不支援將自訂網域新增至預覽環境。 也不支援 Unicode 網域，包括 Punycode 網域和 xn-- 前置詞。

關於網域

設定頂點網域是設定網域名稱後常見的設定案例。 您可以藉由設定 ALIAS 或 ANAME 記錄，或透過 CNAME 壓平合併來建立頂點網域。 部分網域註冊機構，例如 GoDaddy 和 Squarespace (舊稱為 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.example.com (適用於網站) 的流量。

• DNS 裝載：DNS 主機可維護將網域名稱解析為特定 IP 位址的 DNS 伺服器。

• 名稱伺服器：名稱伺服器負責儲存網域的 DNS 記錄。

若要讓自訂網域驗證與靜態 Web 應用程式搭配使用，DNS 必須可公開解析。 在新增網域之後，必須符合下列其中一個條件，自動憑證更新才能運作：

• 確定用來透過 CNAME 驗證將自訂網域新增至靜態 Web 應用程的公用網際網路 CNAME DNS 記錄仍存在。 只有在 CNAME 驗證用來將網域新增至靜態 Web 應用程式時，此選項才有效。

• 確定自訂網域會在公用網際網路解析為靜態 Web 應用程式。 不論哪個驗證方法用來將網域新增至 Web 應用程式，這個選項都是有效的。 即使您啟用私人端點，此方法仍有效。 Static Web Apps 的私人端點目的是封鎖網站內容的網際網路存取，但不會封鎖網站的網際網路 DNS 解析。

零停機時間移轉

您可能想要將目前為生產網站提供服務的自訂網域移轉至靜態 Web 應用程式，而不需要停機。 DNS 提供者不接受相同名稱和主機的多筆記錄，因此您可以個別驗證網域的擁有權，並將流量路由至您的 Web 應用程式。

1. 在 Azure 入口網站中開啟您的靜態 Web 應用程式。

2. 為您的自訂網域 (APEX 或子網域) 新增 TXT 記錄。 不要輸入顯示的「主機」值，而是在 DNS 提供者中輸入「主機」 ，如下所示：

   • 針對 APEX 網域，輸入 _dnsauth.www.<YOUR-DOMAIN.COM>。
   • 針對子網域，輸入 _dnsauth.<SUBDOMAIN>.<YOUR-DOMAIN.COM>。

3. 一旦驗證了您的網域，您就可以藉由更新 CNAME、ALIAS 或 A 記錄，指向您的預設主機名稱，以將流量移轉至靜態 Web 應用程式

下一步

使用下列連結，以取得您如何根據提供者設定網域的步驟。

• 使用 Azure DNS
• 使用外部 DNS 提供者