配置自訂錯誤頁面後,當使用者請求的內容不存在或出現錯誤時,CDN節點會返回自訂的錯誤頁面,而不是預設的錯誤頁面。自訂錯誤頁面可以提高使用者體驗,讓使用者看到更友好的錯誤提示。
背景資訊
阿里雲CDN提供了在出現指定錯誤碼的時候,能夠讓使用者跳轉到自訂頁面的功能。
當用戶端通過瀏覽器請求Web服務時,如果請求的URL不存在,Web伺服器預設會返回404報錯頁面。Web伺服器預設的報錯頁面通常不美觀,為了提升訪問者的體驗,您可以配置自訂頁面,根據所需自訂HTTP或HTTPS響應狀態代碼跳轉的完整URL地址。
自訂頁面如果使用的是CDN加速的資源,那麼將會按照正常的CDN內容分發來計費。
支援的狀態代碼
僅支援針對400、403、404、405、414、416、500、501、502、503、504這些狀態代碼設定自訂頁面。
|
狀態代碼 |
描述 |
|
400 |
您訪問的頁面請求錯誤時,返回此代碼。 |
|
403 |
伺服器拒絕請求時,返回此代碼。 |
|
404 |
請求伺服器上不存在的網頁時,返回此代碼。 |
|
405 |
禁用請求中指定的方法時,返回此代碼。 |
|
414 |
請求的URL過長伺服器無法處理時,返回此代碼。 |
|
416 |
頁面無法提供請求的範圍時,返回此代碼。 |
|
500 |
伺服器遇到錯誤無法完成請求時,返回此代碼。 |
|
501 |
伺服器不具備完成請求的功能時,返回此代碼。 |
|
502 |
伺服器作為網關或代理從上遊伺服器收到無效響應時,返回此代碼。 |
|
503 |
伺服器目前無法使用時,返回此代碼。 |
|
504 |
伺服器作為網關或代理無法及時從上遊伺服器收到請求時,返回此代碼。 |
操作步驟
登入CDN控制台。
在左側導覽列,單擊域名管理。
在域名管理頁面,找到目標網域名稱,單擊操作列的管理。
在指定網域名稱的左側導覽列,單擊缓存配置。
-
單擊自定义页面頁簽。
-
單擊添加,配置自訂頁面的錯誤碼和連結。
例如,錯誤碼選擇
404,描述自動顯示為對應說明,連結輸入自訂錯誤頁面地址如http://example.aliyundoc.com/error404.html,單擊確定完成配置。 -
單擊確定,完成配置。
成功配置自訂頁面後,您可以在自定义页面列表中,對當前的配置進行修改或删除操作。
配置樣本
您希望將404頁面顯示為自訂頁面,假設您已經將自訂404頁面error404.html存放在來源站點的根目錄下,並且通過加速網域名稱example.aliyundoc.com可以訪問到這個404頁面,這個時候您可以通過以下配置來實現404狀態代碼的自訂錯誤頁面。
-
錯誤碼:404
-
連結:您自訂的URL頁面,例如:
http://example.aliyundoc.com/error404.html。 -
結果:訪問返回404報錯時,會跳轉到
http://example.aliyundoc.com/error404.html頁面。
常見問題
配置自訂 403 頁面時如何避免網域名稱跳轉或迴圈重新導向?
為 403 狀態代碼配置自訂錯誤頁面時,如果直接在錯誤版面設定中配置跳轉連結,可能出現網域名稱跳轉或迴圈重新導向的問題。可通過以下方式避免:
-
通過 CDN 控制台的重寫存取 URL功能進行配置,而非直接在自訂錯誤頁面中設定跳轉連結。
-
將待重寫的 Path 設定為
/,並將目標路徑指向正確的 403 靜態頁面地址(例如/error/403.html)。
請確保 403 錯誤頁面本身不會再次觸發 403 狀態代碼的重新導向,否則會導致迴圈重新導向,無法正常訪問頁面。