CDN：HTTPS排障指南

在CDN控制台上傳自訂SSL認證時可能遇到多種報錯。常見的報錯類型及處理方法：

• 認證格式錯誤：CDN僅支援PEM格式的認證。請確認認證內容以 -----BEGIN CERTIFICATE----- 開頭、以 -----END CERTIFICATE----- 結尾，且通常每行64個字元。如果您的認證是DER、P7B或PFX格式，需要先轉換為PEM格式。

• 私密金鑰格式錯誤：私密金鑰檔案的header需與密鑰演算法匹配：RSA密鑰為 -----BEGIN RSA PRIVATE KEY-----（PKCS#1格式），ECC/SM2密鑰為 -----BEGIN EC PRIVATE KEY-----。如果您的私密金鑰以 -----BEGIN PRIVATE KEY----- 開頭（PKCS#8格式），需先轉換再上傳：RSA密鑰執行 openssl rsa -in old_server_key.pem -out new_server_key.pem，ECC/SM2密鑰執行 openssl ec -in old_server_key.pem -out new_server_key.pem。此外，私密金鑰不能帶有密碼保護，去除密碼保護的方法參見私密金鑰檔案去除密碼保護。

  說明

  對SM2（國密）密鑰執行上述 openssl ec 命令時，需使用OpenSSL 1.1.1及以上版本（SM2自1.1.1版本開始引入），且編譯時間需啟用國密演算法支援。否則命令會直接報錯，易被誤判為私密金鑰檔案本身有問題。

  如果您的OpenSSL不支援SM2，建議使用阿里雲數位憑證管理服務提供的國密認證工具或通過控制台直接託管。

• 認證與私密金鑰不匹配：上傳的認證和私密金鑰必須是同一對。RSA密鑰使用以下命令比對兩者的modulus是否一致：

  openssl x509 -noout -modulus -in your_cert.pem | openssl md5
  openssl rsa -noout -modulus -in your_key.pem | openssl md5

  ECC/SM2密鑰沒有modulus概念，請改用比對公開金鑰的方式，分別執行以下命令，兩者輸出一致即匹配：

  openssl x509 -pubkey -noout -in your_cert.pem
  openssl ec -pubout -in your_key.pem

  如果不確定密鑰類型，可使用同時適用於RSA和ECC的通用方法，兩行輸出的MD5值一致即匹配：

  openssl x509 -pubkey -noout -in your_cert.pem | openssl md5
  openssl pkey -pubout -in your_key.pem | openssl md5

• 認證網域名稱不匹配：認證的CN或SAN必須包含加速網域名稱。檢查命令：openssl x509 -in cert.pem -noout -text | grep -E -A1 "Subject:|Subject Alternative Name"

• 認證/密鑰過長：控制台對上傳內容有長度限制。請檢查：憑證鏈結中是否混入多餘空行、不可見字元或BOM頭（可用文字編輯器顯示不可見字元後清理）；是否誤將根CA認證粘貼進憑證鏈結（只需上傳伺服器憑證和中間認證）；是否把私密金鑰誤粘貼到了認證文字框（或相反）。

• 認證已到期：使用 openssl x509 -in your_cert.pem -noout -dates 命令檢查認證有效期間。

具體格式要求和轉換方法，請參見認證格式說明。

如果私密金鑰帶有密碼保護，上傳時會報私密金鑰格式錯誤。您需要先去除密碼保護：

1. 確認密鑰是否帶有密碼保護

   RSA演算法加密的私密金鑰，使用OpenSSL運行以下命令。如果提示 Enter pass phrase for <加密的私密金鑰檔案>:，說明已加密；如果直接顯示私密金鑰資訊，說明未加密；如果出現error報錯，說明該私密金鑰不是RSA加密的檔案：

   openssl rsa -in <加密的私密金鑰檔案> -text -noout

   ECC/SM2演算法加密的私密金鑰，使用以下命令檢查：

   openssl ec -in <加密的私密金鑰檔案> -text -noout

2. 解密私密金鑰

   認證的密碼編譯演算法為RSA時，執行以下命令解密私密金鑰：

   openssl rsa -in <加密的私密金鑰檔案> -passin pass:<私密金鑰密碼> -out <解密的私密金鑰檔案>

   認證的密碼編譯演算法為ECC或SM2時，執行以下命令解密私密金鑰：

   openssl ec -in <加密的私密金鑰檔案> -passin pass:<私密金鑰密碼> -out <解密的私密金鑰檔案>

可能原因及處理方法：

1. 萬用字元認證已部署到其他網域名稱：萬用字元認證已部署到其他CDN網域名稱後，新增網域名稱如需複用同一認證，預設認證列表無法直接選擇。需通過自訂上傳方式在CDN控制台完成部署，之後才可使用數位憑證管理服務控制台的部署認證功能。

2. 認證綁定網域名稱與加速網域名稱不匹配：檢查認證綁定的網域名稱是否與當前CDN加速網域名稱匹配，注意區分兩種情況：單網域名稱認證（如僅綁定 example.com）不能用於子網域名稱 image.example.com，需單獨為該子網域名稱申請認證；而萬用字元認證（如 *.example.com）可以匹配同級的所有子網域名稱（如 image.example.com、api.example.com）。

3. 帳號不一致：確保認證和CDN網域名稱在同一阿里雲帳號下。

4. 免費認證未添加www首碼：申請SSL免費認證時不會自動添加www首碼，需手動輸入完整的網域名稱進行申請。

5. 網域名稱格式導致無法自動匹配：若因網域名稱格式（如根網域名稱與子網域名稱）導致無法自動匹配，建議在數位憑證管理服務控制台建立部署任務將認證部署至CDN，或下載認證檔案後通過"自訂上傳"方式配置。

若認證仍未出現在資源清單中，請按以下順序排查：

1. 確認網域名稱已添加到CDN。登入CDN控制台，進入網域名稱管理頁面，檢查目標網域名稱是否在列表中。認證服務的關聯網域名稱列表僅顯示已添加到CDN的網域名稱，新網域名稱未添加時列表為空白。

2. 確認認證綁定的網域名稱包含加速網域名稱。萬用字元認證（如*.example.com）可覆蓋所有同級子網域名稱，但不覆蓋更深層子網域名稱（如a.b.example.com）和主網域名稱本身（如example.com）。認證綁定的網域名稱與加速網域名稱不匹配時，認證不會出現在可選列表中。

3. 按順序操作：先在CDN控制台為網域名稱配置HTTPS認證（選擇已有認證或自訂上傳），完成後再通過認證控制台的雲產品部署進行後續管理。認證控制台的雲產品部署依賴CDN控制台側的配置，必須先完成CDN控制台的認證配置。

配置HTTPS認證的具體操作，請參見配置HTTPS認證。

當您上傳自訂上傳（認證+私密金鑰）類型的認證時，如果系統提示認證重複，說明相同的認證內容已存在於系統中，可能是之前為其他網域名稱上傳過同一張認證。處理方法：

• 複用已有認證（推薦）：無需重複上傳。在CDN控制台的HTTPS配置頁面，將認證來源切換為已有認證，在列表中搜尋並選擇該認證直接部署即可。

• 確需重新上傳：修改認證名稱後再重新上傳。

癥狀：為加速網域名稱上傳泛網域名稱（萬用字元）認證後，訪問三級及以上網域名稱時瀏覽器提示認證錯誤。

可能原因：根據HTTPS認證網域名稱匹配規範（RFC 6125），泛網域名稱認證只能匹配萬用字元所在層級的下頂層網域。例如*.abc.com的認證可以匹配a.abc.com、b.abc.com，但無法匹配主網域名稱abc.com，也無法匹配第三層網域名x.a.abc.com。

解決方案：

• 對於更深層級的網域名稱，申請對應層級的泛網域名稱認證。例如需要加速1.cdn.abc.com、2.cdn.abc.com等第三層網域名時，應使用*.cdn.abc.com的泛網域名稱認證。

• 若同時需要覆蓋主網域名稱abc.com，需為主網域名稱單獨申請認證，或使用SAN（Subject Alternative Name）認證同時包含abc.com和*.abc.com。

癥狀：在CDN控制台為網域名稱配置免費認證時，系統提示"檢測網域名稱是否在阿里雲CDN"，無法繼續配置。

原因：免費認證的配置需要CDN加速網域名稱正確解析到CNAME值。如果網域名稱未正確解析到CDN分配的CNAME，系統檢測不到網域名稱在阿里雲CDN上，就會提示該報錯。

1. 登入網域名解析服務商控制台，檢查加速網域名稱的解析記錄，確認已正確解析到CDN分配的CNAME值。

2. 網域名稱解析生效需要一定時間，確認解析正確後重新在CDN控制台嘗試配置免費認證。

3. 如果網域名稱已正確解析但仍提示該報錯，可藉助 dig、nslookup 等工具確認解析已生效，並清除瀏覽器緩衝後重試。

DCDN（全站加速）網域名稱配置免費認證時出現同樣的提示，處理方法相同。

ERR_SSL_PROTOCOL_ERROR 通常表示CDN節點未正確配置SSL認證或認證無效。請按以下步驟排查：

1. 檢查CDN控制台HTTPS配置，確保認證已上傳並啟用，且認證狀態正常（未到期）。

2. 若使用自訂認證，請確保認證格式正確（PEM格式）且私密金鑰無密碼保護。

3. 確保認證與私密金鑰匹配，且認證綁定的網域名稱與加速網域名稱一致。

4. 使用以下命令驗證CDN節點實際返回的認證是否正確：

   openssl s_client -connect <加速網域名稱>:443 -servername <加速網域名稱> < /dev/null 2>/dev/null | openssl x509 -noout -subject -dates

5. 若之前未配置過HTTPS認證，請先在CDN控制台完成認證配置。在配置完成前，可臨時使用HTTP協議訪問（去掉URL中的“s”）。

癥狀：瀏覽器報 ERR_SSL_VERSION_OR_CIPHER_MISMATCH（Chrome）或 SSL_ERROR_NO_CIPHER_OVERLAP（Firefox），串連被直接阻斷。這是兩款瀏覽器對同類協商失敗的不同報錯。

可能原因：用戶端與CDN節點協商不出共同支援的TLS協議版本或加密套件，瀏覽器會直接阻斷串連。此類錯誤屬於TLS協議層問題，不會顯示為認證風險警告，請勿按認證信任鏈結問題排查。在已正確配置認證的前提下，本錯誤與認證有效性無關（即使認證完全正確也可能出現）；但如果CDN側根本未配置任何認證，所有依賴認證的金鑰交換套件也會不可用，同樣會觸發此錯誤，因此需先確認認證已配置。

排查步驟：

1. 確認認證已配置：在CDN控制台檢查HTTPS認證狀態，排除“未配置認證”的可能。

2. 確認用戶端支援的TLS協議版本與加密套件：過舊的用戶端可能僅支援TLSv1.0等低版本協議或者老舊加密套件。

3. 檢查CDN側已啟用的TLS版本與加密套件：確認與用戶端能力存在交集。阿里雲CDN控制台支援配置TLSv1.0、TLSv1.1、TLSv1.2、TLSv1.3，建議啟用TLSv1.2和TLSv1.3。加密套件建議使用AES-128-GCM、AES-256-GCM等AEAD密碼編譯演算法的套件，金鑰交換機制使用ECDHE_RSA或ECDHE_ECDSA（配合ECC認證），避免使用加密強度低的老舊套件。配置方法請參見配置TLS版本與加密套件。

4. 兼顧舊用戶端：若業務必須相容僅支援低版本協議的舊用戶端，可臨時在CDN側開啟對應的低版本協議。低版本協議存在安全風險，僅建議作為過渡方案，應儘快推動用戶端升級。

1. 確保認證已正確部署：登入CDN控制台，在HTTPS配置中確認已選擇新認證或上傳了新認證內容。

2. 檢查網域名稱匹配：確保認證綁定的網域名稱與CDN加速網域名稱完全一致（包括www首碼等）。

3. 等待生效並清除本機快取：新認證部署到所有CDN節點需要一定時間（通常1~10分鐘），請等待後複測。認證下發與CDN資源緩衝無關，清除瀏覽器緩衝或使用無痕瀏覽器視窗驗證即可。

4. 使用命令列驗證節點認證：繞過瀏覽器緩衝幹擾，直接查看CDN節點當前部署的認證：

   curl -vI https://<加速網域名稱> 2>&1 | grep -E "subject:|expire date:|issuer:"

5. 來源站點認證更新不會自動同步：若來源站點認證更新，CDN側不會自動同步，必須手動在CDN控制台更新認證。

在CDN控制台上已為網域名稱配置了HTTPS認證，但使用瀏覽器訪問網站時仍提示認證風險。可能原因及處理方法：

• 原因1：憑證鏈結不完整

  上傳認證時未包含完整的中間憑證鏈結。部分裝置（尤其是iOS和部分Android裝置）對憑證鏈結完整性要求更嚴格，會直接提示風險。建議使用線上工具（如myssl.com）檢測憑證鏈結完整性，補全中間認證後重新上傳。也可以通過命令列檢查：

  openssl s_client -connect <加速網域名稱>:443 -servername <加速網域名稱> < /dev/null 2>&1 | grep -i "verify"

  如果輸出中包含 verify error 或 unable to get local issuer certificate，說明憑證鏈結不完整。

• 原因2：認證已到期

  您需要為認證續約，續約成功後在CDN控制台上及時更新認證。更新認證請參見配置HTTPS認證。

• 原因3：使用了自簽名HTTPS認證

  由自己產生的、非CA機構頒發的認證，稱為自我簽署憑證。自我簽署憑證不在瀏覽器的根信任認證列表中，容易被仿冒和遭受中間人攻擊，因此會觸發風險提示，且無法通過補全憑證鏈結解決。建議更換成由可靠的CA機構簽發的HTTPS認證。

• 原因4：網頁內有HTTP連結資源（混合內容）

  網頁使用了HTTP協議載入的資源（圖片、JS、CSS等），瀏覽器會顯示混合內容警告。現代瀏覽器預設會阻斷HTTP載入的指令碼、iframe等主動混合內容，對圖片等被動內容僅顯示警告。處理方法：將頁面中的HTTP資源連結修改為HTTPS，或使用協議相對路徑（//domain/path）。

• 原因5：系統時間不正確

  檢查電腦的系統時間是否正確，系統時間不正確會導致瀏覽器將認證判定為已到期或尚未生效，從而提示認證風險。您需要將系統時間修改正確後再嘗試瀏覽網站。

• 原因6：HSTS緩衝導致無法回退HTTP

  如果網站之前配置了HSTS（HTTP Strict Transport Security）回應標頭，瀏覽器會在指定時間內強制使用HTTPS訪問。若此時認證到期或被移除，瀏覽器將直接阻斷訪問且不提供“繼續前往”選項。處理方法：儘快修複認證問題；如需臨時清除本地HSTS緩衝，Chrome瀏覽器可訪問 chrome://net-internals/#hsts 刪除對應網域名稱的HSTS記錄。HSTS的配置方法請參見配置HSTS。

癥狀：加速網域名稱已配置HTTPS認證，直接通過HTTPS訪問正常，但通過HTTP訪問時不會跳轉到HTTPS，仍以HTTP返回內容。

原因：配置HTTPS認證只是讓CDN節點具備處理HTTPS請求的能力，不會改變HTTP請求的處理方式。HTTP到HTTPS的跳轉需要單獨配置協議重新導向。

處理方法：

1. 在CDN控制台為該加速網域名稱開啟協議重新導向，跳轉方式選擇HTTP強制跳轉HTTPS。配置方法請參見配置協議重新導向。

2. 配置生效後清理瀏覽器緩衝並複測。執行以下命令，正常應返回301或302狀態代碼，且回應標頭Location為https開頭的地址：

   curl -I http://<加速網域名稱>

癥狀：大多數裝置能夠順利訪問通過HTTPS協議加速的網域名稱，但一些較舊或特定配置的用戶端無法訪問，或出現認證校正失敗。

原因：CDN在處理HTTPS請求時依賴於SNI（Server Name Indication）。SNI是TLS協議的一個擴充，它允許用戶端在發起HTTPS串連請求時指定想要訪問的主機名稱。某些較舊或特定配置的用戶端（例如停止維護多年的舊版作業系統或用戶端TLS庫、部分物聯網IoT裝置等）可能不支援SNI或者在發起HTTPS請求時不會發送SNI資訊。這種情況下，CDN節點無法確定用戶端想要訪問的確切網站，從而不能提供正確的SSL/TLS認證，導致HTTPS串連失敗。

先區分問題類型：如果所有裝置、所有瀏覽器都無法通過HTTPS訪問或認證校正失敗，通常是憑證鏈結問題，請按下方"憑證鏈結問題排查"處理；如果僅特定舊裝置或特定用戶端（如Android端微信小程式）失敗，而其他瀏覽器訪問正常，通常是SNI相容性問題，請按下方"SNI問題排查"處理。

SNI問題排查：

1. 確認故障範圍：是否僅在特定用戶端（如Android微信小程式）出現認證校正失敗，而在其他瀏覽器中測試正常。如果是，基本可以排除憑證鏈結問題，繼續排查SNI。

2. 抓取用戶端的TLS握手報文，分析用戶端發起請求時是否攜帶SNI資訊。若未攜帶SNI，CDN節點無法返回該網域名稱的認證。

3. 分析用戶端與服務端交換認證時是否報 Certificate Unknown 後拋出 Reset。若出現該現象且請求未攜帶SNI，即可確認是SNI相容性問題。

4. 查看服務端返回的認證是否為該網域名稱的認證，排除認證配置錯誤。

憑證鏈結問題排查（適用於所有裝置均失敗的情境）：

1. 查看憑證鏈結是否完整。上傳認證時需包含伺服器憑證及完整的中間憑證鏈結。

2. 檢查中間認證是否正確。中間認證錯誤會導致認證校正失敗，可使用瀏覽器的匯出認證功能匯出中間認證進行比對，或使用線上工具（如myssl.com）檢測後補全重新上傳。

改善措施：

• 升級用戶端系統：確保使用的作業系統和軟體都是最新版本，以獲得對SNI的支援。

• 更新IoT裝置韌體：對於物聯網裝置，定期檢查並安裝廠商提供的最新韌體更新。

• 確保憑證鏈結完整：上傳認證時確保包含完整的中間憑證鏈結，避免因憑證鏈結不完整導致部分裝置校正失敗。

癥狀：本地網速正常，但通過HTTPS訪問CDN加速網域名稱時網頁載入很慢（例如使用隱私模式瀏覽器訪問很慢），訪問速度明顯低於預期。

可能原因：HTTPS訪問慢通常不是TLS協議版本協商問題（協議版本談不攏會直接連接失敗，而不是變慢），常見原因包括：

• OCSP查詢逾時：用戶端驗證憑證撤銷狀態時需要即時訪問CA機構的OCSP伺服器，查詢逾時會令頁面載入卡住數秒。阿里雲CDN支援OCSP Stapling：由CDN節點代替用戶端向CA查詢並緩衝認證狀態，在TLS握手時隨認證一起下發，避免用戶端即時查詢。需要注意的是，首次請求或OCSP緩衝到期後，CDN節點需要向CA重新查詢，在此期間仍可能存在短暫延遲。配置方法請參見配置OCSP Stapling。

• 憑證鏈結過大：上傳的憑證鏈結中若包含不必要的根憑證，會增加TLS握手的資料量。僅需上傳伺服器憑證和中間認證，根憑證由用戶端系統內建，無需包含。

• DNS調度問題：網域名稱解析到了距離用戶端較遠的CDN節點，網路時延本身較大。這屬於解析調度問題，不是TLS問題。

• TLS協議版本較低：TLSv1.3握手（1-RTT）比TLSv1.2（2-RTT）往返更少，啟用高版本協議可縮短握手耗時。

排查步驟：

1. 定位耗時階段：使用瀏覽器開發人員工具的Network面板，查看HTTPS請求的耗時分布。若耗時集中在SSL/TLS握手階段，按以下步驟繼續排查；若握手很快而內容下載慢，則不是TLS問題，應從回源或網路鏈路方向排查。

2. 檢查OCSP Stapling：確認CDN側是否已開啟OCSP Stapling。未開啟時，可結合抓包確認用戶端握手後是否存在等待OCSP查詢的現象；開啟後由CDN節點隨握手下發認證狀態，可消除該等待。

3. 檢查憑證鏈結大小：確認上傳的憑證鏈結僅包含伺服器憑證和中間認證，不包含根憑證，避免握手資料量過大。

4. 排除調度問題：使用 dig、nslookup 確認加速網域名稱的CNAME解析結果，若用戶端被調度到距離較遠的CDN節點，請檢查本地DNS解析配置或聯絡阿里雲排查調度策略。

5. 確認協議版本：確認CDN側已啟用TLSv1.2或TLSv1.3。TLSv1.3握手往返更少，正常情況下不建議關閉。配置方法請參見配置TLS版本與加密套件。

6. 複測：調整後重新訪問，確認訪問速度恢複正常。

DCDN（全站加速）網域名稱出現同樣的HTTPS訪問慢問題，排查與處理方法相同。