全部產品
Search
文件中心

CDN:配置自訂頁面

更新時間:Dec 27, 2024

配置自訂錯誤頁面後,當使用者請求的內容不存在或出現錯誤時,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

伺服器作為網關或代理無法及時從上遊伺服器收到請求時,返回此代碼。

操作步驟

  1. 登入CDN控制台

  2. 在左側導覽列,單擊域名管理

  3. 域名管理頁面,找到目標網域名稱,單擊操作列的管理

  4. 在指定網域名稱的左側導覽列,單擊缓存配置

  5. 單擊自定义页面頁簽。

  6. 單擊添加,配置自訂頁面的錯誤碼和連結。

    自訂頁面

  7. 單擊確定,完成配置。

    成功配置自訂頁面後,您可以在自定义页面列表中,對當前的配置進行修改删除操作。

配置樣本

您希望將404頁面顯示為自訂頁面,假設您已經將自訂404頁面error404.html存放在來源站點的根目錄下,並且通過加速網域名稱example.aliyundoc.com可以訪問到這個404頁面,這個時候您可以通過以下配置來實現404狀態代碼的自訂錯誤頁面。

  • 錯誤碼:404

  • 連結:您自訂的URL頁面,例如:http://example.aliyundoc.com/error404.html

  • 結果:訪問返回404報錯時,會跳轉到http://example.aliyundoc.com/error404.html頁面。

相關API

BatchSetCdnDomainConfig