全部產品
Search
文件中心

ApsaraVideo VOD:忽略參數

更新時間:Dec 27, 2024

開啟忽略參數功能後,CDN節點在處理使用者請求時,會去除請求URL中攜帶在?之後的參數(例如:使用者身份資訊、訪問渠道資訊),以原始URL來產生緩衝hashkey。由此可以有效提高檔案快取命中率,提升分發效率。本文為您詳細介紹配置忽略參數的方法。

功能介紹

說明

URL鑒權功能的優先順序高於忽略參數。由於鑒權方式A中的鑒權資訊包含HTTP請求的參數部分,所以CDN優先進行鑒權判斷,鑒權通過後在CDN節點緩衝一份副本。配置URL鑒權的操作方法,請參見配置URL鑒權

  • 忽略參數

    作用

    適用情境

    去除請求URL中?之後的參數,不同使用者訪問同一個檔案時,即使攜帶不同的URL參數,也能夠命中同一個快取檔案,可以提高快取命中率,減少回源次數,提升檔案分發效率。

    很多使用者會通過在請求URL的?後面攜帶參數的方式來傳遞訪問資訊給來源站點(例如:使用者帳號UID、使用者渠道來源、推薦碼等),URL攜帶參數以後,不同的用戶端訪問CDN上同一個資源檔會攜帶不同的參數。

    如果您的請求URL中?後面攜帶參數,但參數差異與資源內容無關,建議您開啟忽略參數。例如:

    • A使用者:http://example.com/1.jpg?uid=123***

    • B使用者:http://example.com/1.jpg?uid=654***

    如果CDN節點直接使用A、B使用者的原始URL來處理快取檔案訪問請求,將無法命中同一個快取檔案,使用者的每次請求都需要回來源站點擷取資源。

    開啟忽略參數後,CDN節點在尋找和匹配快取檔案時,會去除URL中?後面UID參數,使用URL:http://example.com/1.jpg來匹配。

  • 保留回源參數

    作用

    適用情境

    使用原始URL回源,將使用者的關鍵資訊傳遞給來源站點。

    開啟忽略參數功能後,CDN節點預設使用經忽略參數處理後的URL回源。上面的例子中,A、B使用者的回源請求都會使用URL:http://example.com/1.jpg,在回源時就會丟失關鍵資訊UID。

    通過開啟保留回源參數功能,CDN節點將會使用原始URL回源,這樣就可以把A、B使用者的關鍵資訊UID傳遞給來源站點。

忽略參數包含兩種模式(保留指定參數、刪除指定參數),開啟忽略參數處理流程圖如下所示:

操作步驟

  1. 登入ApsaraVideo for VOD控制台

  2. 在左側導覽列選擇組態管理 > 分發加速配置 > 網域名稱管理,進入到網域名稱管理頁面。

  3. 在網域名稱管理頁面,單擊目標網域名稱操作列的配置

  4. 在網域名稱的左側導覽列,單擊效能最佳化

  5. 在忽略參數地區,單擊修改配置

  6. 請根據您的實際需求配置過濾模式、過濾參數等配置項。

    配置項和說明如下表所示。

    重要

    切換過濾模式,原有配置會被刪除。

    • 過濾模式:保留指定參數

      參數

      說明

      樣本

      忽略参数

      • :開啟忽略參數功能,使用者請求回源時會去除URL中之後的參數。

        說明

        如果僅開啟過忽略參數開關,不設定具體的保留指定參數時,表示去除?之後的所有參數。

      • :關閉忽略參數功能。

      假設原始URL為http://example.com/1.jpg?key1=1&key2=2&key3=3,實現特定的功能情境,設定參數後,原始URL經CDN處理後結果如下:

      • 樣本一,過濾所有參數+使用忽略參數處理後的URL回源

        • 配置:忽略參數設定為保留指定參數為空白,保留回源參數設定為

        • 緩衝key:http://example.com/1.jpg

        • 回源URL:http://example.com/1.jpg

      • 樣本二,保留指定參數+使用忽略參數處理後的URL回源

        • 配置:忽略參數設定為保留指定參數設定為key1保留回源參數設定為

        • 緩衝key:http://example.com/1.jpg?key1=1

        • 回源URL:http://example.com/1.jpg?key1=1

      • 樣本三,過濾所有參數+使用原始URL回源

        • 配置:忽略參數設定為保留指定參數為空白,保留回源參數設定為

        • 緩衝key:http://example.com/1.jpg

        • 回源URL:http://example.com/1.jpg?key1=1&key2=2&key3=3

      • 樣本四,保留指定參數+使用原始URL回源

        • 配置:忽略參數設定為保留指定參數設定為key1保留回源參數設定為

        • 緩衝key:http://example.com/1.jpg?key1=1

        • 回源URL:http://example.com/1.jpg?key1=1&key2=2&key3=3

      保留指定參數

      配置需要保留的參數,最多可以配置10個保留參數,多個參數用英文逗號(,)分隔 。

      保留回源参数

      • 是:在回源請求中保留原始請求URL中的所有參數。

      • 否:在回源請求中攜帶的參數與緩衝hashkey的參數一致(即,保留了指定的參數)。

      規則條件

      規則條件能夠對使用者請求中攜帶的各種參數資訊進行識別,以此來決定某個配置是否對該請求生效。

      • 不使用:不使用規則條件。

      • 選擇已配置的規則引擎,新增或修改規則引擎請參見規則引擎

    • 過濾模式:刪除指定參數

      參數

      說明

      樣本

      刪除指定參數

      配置需要刪除的參數,最多可以配置10個參數,多個參數用空格作分隔字元。

      假設原始URL為http://example.com/1.jpg?key1=1&key2=2&key3=3,實現特定的功能情境,設定參數後,原始URL經CDN處理後結果如下:

      • 樣本一,刪除指定參數+使用忽略參數處理後的URL回源

        • 配置:刪除指定參數設定為key1保留回源參數設定為

        • 緩衝key:http://example.com/1.jpg?key2=2&key3=3

        • 回源URL:http://example.com/1.jpg?key2=2&key3=3

      • 樣本二,刪除指定參數+使用原始URL回源

        • 配置:刪除指定參數設定為key1保留回源參數設定為

        • 緩衝key:http://example.com/1.jpg?key2=2&key3=3

        • 回源URL:http://example.com/1.jpg?key1=1&key2=2&key3=3

      保留回源参数

      • 是:在回源請求中保留原始請求URL中的所有參數。

      • 否:在回源請求中攜帶的參數與緩衝hashkey的參數一致(即,刪除了指定的參數)。

      規則條件

      規則條件能夠對使用者請求中攜帶的各種參數資訊進行識別,以此來決定某個配置是否對該請求生效。

      • 不使用:不使用規則條件。

      • 選擇已配置的規則引擎,新增或修改規則引擎請參見規則引擎

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