功能介紹
回源參數改寫功能,可改寫回源請求URL中的查詢參數,即問號后的參數串。可支持參數的新增、刪除、修改,以及保留或忽略所有參數。
適用場景
如果用戶發起的原始請求URL中攜帶的參數與需要發送給源站的參數不一致,您可以通過回源參數改寫功能改寫回源請求URL中攜帶的參數。
配置說明
- 登錄。
- 單擊左側導航欄【域名管理】-【域名列表】。
- 在【域名列表】頁面,找到目標域名,單擊【操作】列的【編輯】。
- 單擊右側【回源配置】。
- 在【忽略所有回源參數】模塊,【回源參數改寫】模塊進行配置.
- 單擊【保存】,完成配置。
忽略所有回源參數配置說明:
| 參數名 | 配置值 | 說明 |
|---|---|---|
| 忽略所有回源參數 | 開關 | 默認為關閉,即回源不忽略參數,啟用則忽略所有參數回源。 |
回源參數改寫配置說明:
| 參數名 | 配置值 | 說明 |
|---|---|---|
| 改寫參數模式 | 追加/覆蓋 | 追加:可通過追加實現在原有參數基礎上進行新增,刪除,修改。 覆蓋:覆蓋原有參數,參數以覆蓋后的配置為準,如僅保留部分參數或者替換全部參數。 |
| 優先級 | 默認10 | 配置下發優先級;存在多條回源參數規則時,按照優先級從低到高依次執行,數字越大,優先級越高。 |
| 參數名:參數值 | - | 需配置的參數名和參數值: 1.追加參數a,值為123,則如果原來無參數a,則新增參數a,且值為123;如果原來有參數a,則修改參數a的值為123。 2.追加參數a,值為空,則代表刪除參數a。 3.覆蓋參數a,則參數值可為固定值,也可為某個參數變量,或其他變量: 1)覆蓋參數a,參數值為123,則無論原來是否有參數a以及是否有值,均去掉原有的所有參數,替換為參數a,且值為123。 2)覆蓋參數a,參數值為$arg_a,則僅保留參數a回源,且其值取原始請求參數a的值。 |
| 操作 | 可刪除配置 |
配置示例
示例一:忽略所有參數回源
| 參數名 | 配置示例 |
|---|---|
| 忽略回源參數 | 開啟(默認關閉,即回源不忽略參數,啟用后忽略所有參數回源。) |
結果說明 :忽略所有參數回源;即如果原始請求url為://www.daliqc.cn/a/a.html?b=2&c=3&d=4,則回源時url為://www.daliqc.cn/a/a.html。
示例二:回源添加參數
| 參數名 | 配置示例 |
|---|---|
| 改寫參數模式 | 追加 |
| 優先級 | 默認10 |
| 參數名 | a |
| 參數值 | 123 |
結果說明 :回源添加a=123參數;即如果原始請求url為://www.daliqc.cn/a/a.html?b=2&c=3&d=4,則回源url為://www.daliqc.cn/a/a.html?b=2&c=3&d=4&a=123。
示例三:回源刪除參數
| 參數名 | 配置示例 |
|---|---|
| 改寫參數模式 | 追加 |
| 優先級 | 默認10 |
| 參數名 | b |
| 參數值 | 置空,即代表刪除該參數 |
結果說明 :回源刪除b參數;即如果原始請求url為://www.daliqc.cn/a/a.html?b=2&c=3&d=4,則回源url為://www.daliqc.cn/a/a.html?c=3&d=4。
示例四:回源僅保留部分參數
| 參數名 | 配置示例 |
|---|---|
| 改寫參數模式 | 覆蓋 |
| 優先級 | 默認10 |
| 參數名 | c |
| 參數值 | $arg_c |
結果說明 :回源僅保留c參數;即如果原始請求url為://www.daliqc.cn/a/a.html?b=2&c=3&d=4,則回源url為://www.daliqc.cn/a/a.html?c=3。
示例五:回源修改參數值
| 參數名 | 配置示例 |
|---|---|
| 改寫參數模式 | 追加 |
| 優先級 | 默認10 |
| 參數名 | d |
| 參數值 | 123 |
結果說明 :回源修改d參數值為123;即如果原始請求url為://www.daliqc.cn/a/a.html?b=2&c=3&d=4,則回源url為://www.daliqc.cn/a/a.html?b=2&c=3&d=123。
注意事項
- 如果同時配置回源參數改寫規則和忽略回源參數,忽略回源參數的優先級更高,回源參數規則全部失效,即最終生效的是忽略所有參數。
- 如果同時配置多條追加和覆蓋,按照優先級從低到高依次執行,同等優先級配置下發先后順序依次執行:
- 不同優先級:例如配置增加參數a=1,優先級為10,同時又配置刪除參數a,優先級為11,則先執行增加參數,再在增加的基礎上執行刪除參數,最終回源不攜帶a參數。
- 相同優先級:例如先配置添加參數a=1,再配置刪除參數a,則最終參數a添加無效;如先配置刪除參數a,再添加參數a=1,則最終參數a=1添加生效。
- 回源參數改寫功能實際配置下發在邊緣節點,即邊緣回中間層,以及中間層回源全鏈路都會受影響。
- 回源參數改寫功能不影響緩存key,緩存key可單獨設置。