配置CNAME常見問題 - CDN

添加 CDN 加速網域名稱後，CDN 會分配一個 CNAME 地址。將加速網域名稱的解析記錄指向該 CNAME 地址後，CDN 加速服務即可生效。本文介紹配置CNAME過程中的常見問題。

如何測試 CNAME 解析是否生效？

在CDN控制台完成CNAME配置後，使用 nslookup 或 dig 等查詢工具驗證。不推薦使用 ping 命令，其返回的解析資訊可能不準確。

Windows

nslookup -type=CNAME <加速網域名稱>

如果返回的結果和CDN提供的CNAME值相等，則證明CNAME解析生效。

Linux/Mac OS

在Linux或Mac OS系統的終端（Terminal）中，使用 dig 命令驗證：

僅查詢CNAME目標地址（推薦）：
```
dig +short <加速網域名稱> CNAME
```
如果返回的結果和CDN提供的CNAME值相等，則證明CNAME解析生效。結果樣本如下：
```
dig +short cdn.example.com CNAME
cdn.example.com.w.alikunlun.com.
```
查詢網域名稱詳細資料：
```
dig <加速網域名稱> CNAME
```
如果ANSWER SECTION的CNAME值和CDN提供的CNAME值相等，則證明CNAME解析生效。

查詢結果顯示 `NXDOMAIN` 或找不到記錄怎麼辦？

按以下步驟排查：

檢查網域名稱拼字：確認查詢命令中輸入的網域名稱無誤。
檢查DNS配置：登入DNS解析控制台，檢查CNAME記錄是否存在、主機記錄是否正確。主機記錄應填寫加速網域名稱的首碼部分，而非完整網域名稱。例如，加速網域名稱為 cdn.example.com 時，主機記錄應填寫 cdn，而非 cdn.example.com。
等待DNS生效：DNS記錄修改後，全域生效需要時間，可等待後重試。
說明
DNS記錄的全球生效時間取決於其TTL。例如，如果舊記錄的TTL是10分鐘，那麼新記錄的生效時間至少為10分鐘。在修改CNAME前，建議將原記錄的TTL設定為較短時間（如60秒）。

查詢到了A記錄，但沒有CNAME記錄，或配置 CNAME 時提示與 A 記錄衝突怎麼辦？

同一主機記錄不能同時存在 A 記錄和 CNAME 記錄。衝突提示說明該主機記錄下已存在 A 記錄或其他類型記錄，解決方案如下：

登入 DNS 解析控制台，找到衝突的 A 記錄（或 MX、TXT 等記錄）。
刪除或暫停該衝突記錄。
重新添加 CNAME 記錄，將記錄值指向 CDN 分配的 CNAME 地址。

說明

刪除 A 記錄後，原解析流量將中斷。建議先用子網域名稱測實驗證 CDN 加速正常後再切換主網域名稱。
建議在業務低峰期操作。
如果網域名稱已開啟全域流量管理（GTM）的健全狀態檢查，GTM 可能自動建立解析記錄導致衝突，需先在 GTM 中處理後再添加 CNAME。

CDN 網域名稱配置完成後，控制台狀態仍顯示"待配置"或"驗證不通過"怎麼辦？

配置完成後，通常需要 5~30 分鐘生效，實際以佈建網域名解析時選擇的TTL為準。全網解析生效後，CDN控制台狀態將顯示正常。請等待後重新整理控制台頁面查看狀態。

如果等待後網域名稱狀態未更新，請按以下步驟排查：

檢查主機記錄是否正確：須與加速網域名稱首碼一致，例如 a.example.com 對應 a，example.com 對應 @。常見錯誤是填寫了 www 但加速網域名稱並非 www.example.com。
檢查 CNAME 記錄值是否匹配：須與 CDN 控制台顯示的 CNAME 地址完全一致，建議直接從控制台複製。
使用 nslookup 或dig命令驗證：確認返回的 CNAME 指向 CDN 分配的地址。
檢查是否有衝突記錄：確認已刪除同一主機記錄下的 A 記錄或其他衝突記錄。

控制台顯示 CNAME 未配置但實際已解析

在以下情境中，CDN 控制台可能顯示CNAME狀態為未配置，但實際加速功能已正常運行，不影響實際使用：

加速地區不含中國內地：如果在添加加速網域名稱時將加速地區設定為全球（不包含中國內地）（對應 API 參數 Scope 取值為 overseas），在中國內地網路環境下檢測 CNAME 時會提示未配置。這是正常現象，不影響目標加速地區的正常使用。可以通過以下方式驗證境外加速是否生效：
1. 使用 nslookup或dig 命令或在 CDN 控制台確認網域名稱已解析到 CDN 分配的 CNAME 地址。
2. 在非中國內地網路環境下訪問加速資源，通過瀏覽器開發人員工具查看回應標頭，若 X-Cache 欄位值為 HIT，則表示 CDN 快取命中，加速已生效。
配置了分線路 DNS 解析：如果在 DNS 服務位址配置了按解析線路區分的記錄（例如中國內地線路解析到 CDN 的 CNAME 地址、非中國內地線路解析到來源站點 IP），CDN 控制台可能因檢測到部分線路未解析到 CDN 而顯示"CNAME 未配置"。只要目的地區域的使用者能正常訪問加速資源，即可忽略該提示。
DNS 解析延遲：新配置或修改 CNAME 記錄後，DNS 解析全網生效通常需要幾分鐘到數小時（取決於 TTL 設定）。在此期間控制台可能顯示未配置，請稍後再檢查。

一個網域名稱是否可以配置多個 CNAME 記錄指向不同的 CDN 地址？

不支援。同一主機記錄只能配置一個 CNAME 記錄值，配置多個可能導致訪問報錯（如返回 403 錯誤）。

解決方案：確保同一主機記錄下只保留一條 CNAME 記錄，記錄值指向當前使用的 CDN 加速網域名稱對應的 CNAME 地址。如有多餘記錄請刪除。

泛網域名稱 CNAME 解析對子網域名稱的影響？

配置泛網域名稱（如 *.example.com）的 CNAME 解析後，所有未單獨配置解析的子網域名稱（如 a.example.com、b.example.com）將自動繼承泛網域名稱解析。如果某些子網域名稱不需要 CDN 加速，需為其單獨配置 A 記錄或其他類型記錄。具體子網域名稱的解析記錄優先順序高於泛網域名稱，不會被覆蓋。

說明

解析優先順序規則可能因 DNS 服務商而異。