配置自訂Cachekey規則提高快取命中率-邊緣安全加速-阿里雲

配置自訂Cachekey，開發人員可以根據HTTP請求的不同部分（例如URI、請求參數、HTTP要求標頭或自訂變數等）制定規則來產生Cachekey，將訪問同一個檔案的一類請求轉化為統一的Cachekey，避免將同一類請求緩衝為不同檔案的問題，從而提高緩衝的命中率，降低回源率，減少請求的回應時間和頻寬消耗。

使用情境

重要

自訂Cachekey功能不會修改回源的URL，僅會修改請求的緩衝標識，回源的請求和用戶端發起的請求內容保持一致。

Cachekey是一個檔案在DCDN節點上緩衝時唯一的身份ID，每個在DCDN節點上緩衝的檔案都對應一個Cachekey。檔案的Cachekey預設為用戶端請求的URL（帶參數）。

情境一

客戶不同請求的URL中含有複雜的參數，因此即使多個請求訪問的是同一個檔案，但由於URL參數不同，DCDN節點會視為請求不同檔案而將不同請求緩衝成多個檔案，造成回源的請求增加。

可通過自訂Cachekey規則將同一類請求的Cachekey統一，降低回源率。

情境二

用戶端請求的URL一樣時，DCDN將視為請求同一個檔案。但實際上請求的Http Header中攜帶了client欄位區分了用戶端系統，希望請求不同檔案。情境一

此時可通過自訂Cachekey將client欄位的值拼接至Cachekey，兩個請求即可識別為2個不同的Cachekey。情境二

操作步驟

登入DCDN控制台。
在左側導覽列，單擊域名管理。
在域名管理頁面，單擊目標網域名稱對應的配置。
在指定網域名稱的左側導覽列，單擊緩衝配置。

在自訂Cachekey頁簽配置Cachekey。

說明

支援對URI、參數操作、HTTP Header進行修改，同時支援自訂變數，從請求中提取需要的欄位。最終的Cachekey將由URI、參數操作、HTTP Header、自訂變數四部分組合而成。

自訂Cachekey

參數類型	操作說明
規則條件	規則條件能夠對使用者請求中攜帶的各種參數資訊進行識別，以此來決定某個配置是否對該請求生效。不使用：不使用規則條件。若需新增或編輯規則條件，請在規則引擎中進行管理。
URI	當用戶端請求的URI與配置中的源URI相匹配時，系統會用配置中的目標URI替換源URI，來產生Cachekey。則使用配置中的目標URI替換源URI來拼接Cachekey。支援配置多個URI替換策略。若存在多條策略，則按照從上到下的順序依次進行匹配。一旦匹配到某個源URI，系統將使用該策略對應的目標URI執行替換操作，並停止與後續策略的匹配。源URI：以正斜線（/）開頭的URI，不含http://頭及網域名稱。支援`PCRE`Regex。目標URI：以正斜線（/）開頭的URI，不含http://頭及網域名稱。
參數操作	操作的對象是使用者發起的原始請求URL中攜帶的參數，可以對參數進行新增、刪除、修改、僅保留操作，操作後的結果將會拼接到Cachekey中。支援設定多個操作，存在多個操作的情況下，將會從上到下按順序逐個執行。新增：將新增的請求參數拼接到Cachekey中。例如：原始URL為`http://image.example.com/cat.jpg`，新增一個請求參數`type=jpg`，則Cachekey為`http://image.example.com/cat.jpg?type=jpg`。刪除：在產生Cachekey的時候刪除原始請求URL中的指定參數。例如：原始URL為 `http://image.example.com/cat.jpg?type=jpg`，刪除參數`type`，則Cachekey為`http://image.example.com/cat.jpg`。修改：在產生Cachekey的時候修改原始請求URL中的指定參數。例如：原始URL為 `http://image.example.com/cat.jpg?type=jpg`，修改參數`type=png`，則Cachekey為。僅保留：在產生Cachekey的時候僅保留原始請求URL中的指定參數。例如：原始URL為`http://image.example.com/cat.jpg?type=jpg&path=image`，保留參數`type`，則Cachekey為`http://image.example.com/cat.jpg?type=jpg`。
HTTP HEADER	將用戶端原始請求中攜帶的指定HTTP Header的值拼接到Cachekey中。支援配置多個HTTP Header名稱（多個 HTTP Header 名稱之間用空格分隔），效果是每個HTTP Header的值將會按順序拼接到Cachekey中。例如：原始URL為 `http://image.example.com/cat.jpg`，用戶端請求攜帶了一個`HTTP Header（path:image）`；如果HTTP Header中設定了`path`這個要求標頭，則Cachekey為`http://image.example.com/cat.jpgimage`。
自訂變數	可以使用Regex來匹配用戶端原始請求中攜帶的指定請求參數的值、指定HTTP Header的值、指定Cookie參數的值、指定的URI，Regex匹配命中時，將對應的值拼接到Cachekey中。具體使用請參見配置樣本。

單擊確定，完成配置。

配置樣本

URI

用戶端的請求http://aliyundoc.com/a/b/image.jpg和http://aliyundoc.com/a/b/c/image.jpg 將視為請求同一個檔案，該檔案的Cachekey為http://aliyundoc.com/c/image.jpg。 URI

參數操作

用戶端的請求http://aliyundoc.com/a/b/image.jpg?delete_par=1&modify_par=1 將按規則添加add_par=1，刪除delete_par，將modify_par的值修改為2，最終轉化為http://aliyundoc.com/a/b/image.jpg?modify_par=2&add_par=1。

重要

參數操作中，如對同一個變數同時進行了多個操作，則各種操作的生效優先順序：新增>刪除>僅保留>修改。

參數操作

HTTP HEADER

用戶端請求的HTTP HEADER的User-Agent和Accept-Language的值將被拼接到Cachekey中。例如請求http://aliyundoc.com/a/b/image.jpg中的User-Agent=Mozilla/5.0 (Linux; X11)，Accept-Language=en，則該請求的Cachekey為：http://aliyundoc.com/a/b/image.jpgMozilla/5.0(Linux;X11)en。

自訂變數

樣本一

變數名為language，來源為Request Header，來源欄位名為Accept-Language，匹配規則為 ([%w]+),([%w]+)，Variant 運算式為$1aa。自訂變數

用戶端的請求http://aliyundoc.com/a/b/image.jpg且攜帶HTTP要求標頭Accept-Language=en,ch ，則匹配規則將匹配到en賦值給Variant 運算式中的$1。Variant 運算式還將在末尾拼接上aa，得到enaa的變數並取別名為language，拼接在URL後方形成最終的Cachekey：http://aliyundoc.com/a/b/image.jpgenaa。

說明

Variant 運算式中的$n的含義是匹配規則中第n個括弧所匹配到的內容。例如樣本一中Accept-Language=en,ch，匹配規則為([%w]+),([%w]+)，則$1=en，$2=ch。

樣本二

變數名為expired，來源為Request Cookie，來源欄位名為a，匹配規則為[%w]+:(.*)，Variant 運算式為 $1。自訂變數

用戶端的請求http://aliyundoc.com/a/b/image.jpg且攜帶Cookie a=expired_time:12635187，則匹配規則將匹配到12635187賦值給Variant 運算式中的$1並取別名為expired，拼接在URL後方形成最終的Cachekey：http://aliyundoc.com/a/b/image.jpg12635187。

樣本三

同時設定URI規則和自訂變數。

URI：
將所有URI符合/abc/.*/abc的請求都合并成 /abc。
自訂變數：
變數名為testname，來源為Path，匹配規則為/abc/xyz/(.*)，Variant 運算式為$1。
用戶端的請求URLhttp://aliyundoc.com/abc/xyz/abc/image.jpg，按URI的配置Cachekey將被合并成http://aliyundoc.com/abc/image.jpg，然後根據自訂變數的配置該URL將會命中/abc/xyz/(.*)，此時$1將被賦值為abc並拼接到Cachekey中，形成最終的Cachekey：http://aliyundoc.com/abc/image.jpgabc，從而達到兩個規則群組合使用，實現更複雜的緩衝邏輯。
如果沒有匹配到CacheKey的自訂變數，則Variant 運算式$1就不會被拼接到CacheKey中。