全部產品
Search
文件中心

CDN:重寫回源參數

更新時間:Nov 18, 2025

如果使用者發起的原始請求URL中攜帶的參數與需要發送給來源站點的參數不一致,您可以通過回源參數重寫功能重寫回源請求URL中攜帶的參數。實現忽略所有參數、添加參數、刪除參數、保留參數、修改參數等操作。

背景資訊

  • URL參數是追加在URL上的一個或多個名稱/值對,位於?後面,格式為name=value。多個參數之間用&隔開。

  • 有時URL中還會包含#及其後面的字元,#用於指引瀏覽器定位到網頁中的特定位置。

    例如:http://www.example.com/index.html#segment,這裡的#segment代表網頁index.htmlsegment位置,瀏覽器開啟URL對應的頁面之後,將會自動定位至該位置。改寫參數圖

參數優先順序

  • 回源參數重寫,重寫的是回源請求URL的查詢參數,支援配置多個不同的重寫操作,優先順序為添加参数>删除参数>仅保留修改参数。當不同的重寫操作用於同一個參數時,只有高優先順序的規則會生效。

  • 開啟忽略参数的情況下,在剩餘的重寫操作裡面,僅添加参数還會生效。

衝突說明

重寫回源參數重寫回源URLenhance break規則和忽略參數功能可能會衝突,配置時注意避免衝突,且後配置的功能生效。

對緩衝key的影響

  • 重寫回源參數功能是在CDN回源節點上完成,不影響CDN的內部鏈路,且不重寫緩衝key。

  • 忽略參數功能是在CDN邊緣節點上完成,會影響CDN的內部鏈路,且會重寫緩衝key。

操作步驟

  1. 登入CDN控制台

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

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

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

  5. 單擊重寫回源參數頁簽。

  6. 開啟功能開關

  7. 配置需要重寫的回源參數。

    根據實際業務需求,按照介面提示配置不同的重寫操作,您也可以在一種操作類型的文字框中添加多個參數。更多資訊,請參見配置樣本

  8. 單擊確定,重寫操作開始執行和生效。

    您也可以在重寫回源參數頁面,單擊修改配置,修改已配置的規則。

    image

配置樣本

  • 配置樣本一:忽略所有參數。

    image

    配置項

    填寫樣本

    忽略参数

    開啟

    添加参数

    删除参数

    仅保留

    修改参数

    規則條件

    不使用

    結果說明

    原始請求:http://example.com/index.html?code1=1&code2=2&code3=3

    重寫後的回源請求:http://example.com/index.html

  • 配置樣本二:保留指定參數。

    image

    配置項

    填寫樣本

    忽略参数

    關閉

    添加参数

    删除参数

    仅保留

    code2

    修改参数

    規則條件

    不使用

    結果說明

    原始請求:http://example.com/index.html?code1=1&code2=2&code3=3

    重寫後的回源請求:http://example.com/index.html?code2=2

  • 配置樣本三:添加參數+刪除參數+修改參數。

    image

    配置項

    填寫樣本

    忽略参数

    關閉

    添加参数

    code4=4

    删除参数

    code2

    仅保留

    修改参数

    code3=0

    規則條件

    不使用

    結果說明

    原始請求:http://example.com/index.html?code1=1&code2=2&code3=3

    重寫後的回源請求:http://example.com/index.html?code1=1&code3=0&code4=4