回源URI改寫
更新時間 2025-05-27 16:16:11
最近更新時間: 2025-05-27 16:16:11
分享文章
本文簡述回源URI改寫功能及配置方法。
功能介紹
回源URI改寫可以實現在用戶請求回源時對回源URI進行改寫，配置回源URI改寫功能后，邊緣節點向源站發起回源請求時將使用改寫后的URI。
適用場景
- 源站服務器的資源所在的路徑發生了變化，而用戶仍請求原來的URI，此時可在控制臺配置回源URI改寫功能，將原URI指向新的資源路徑。
- 源站內有同樣的資源在多個地方復用，也可以通過回源URI改寫將資源指向指定的資源路徑。
注意事項
- 回源URI改寫功能只能針對請求URI進行改寫，無法對URI后的參數進行改寫，若要對URI后的參數進行改寫，詳情請見：回源參數改寫。
- URI改寫會按照從上到下的順序執行規則列表，因此規則列表的順序會影響改寫結果。
- 單域名可配置的回源URI改寫的規則上限是50條。
配置說明
1.登錄。
2.進入安全與加速工作臺-域名-基礎配置頁面，點擊目標域名。
3.進入源站設置頁面，單擊“編輯配置”。
4.在【回源URI改寫】模塊，單擊【增加規則】
5.配置【改寫模式】、【待改寫PATH】、【改寫后PATH】。
6.單擊【保存】，完成配置。
配置界面
| 參數名 | 說明 |
|---|---|
| 改寫模式 | 默認解碼，對回源URI解碼后改寫，回源時再編碼；選擇編碼，對回源URI原始編碼改寫，回源時不再編碼。 |
| 待改寫PATH | 以/開頭的URI，不含//頭及域名。支持正則表達式，如^/test$。 |
| 改寫后PATH | 以/開頭的URI，不含//頭及域名。 |
| 操作 | 可刪除配置。 |
配置示例
示例一:
| 參數名 | 說明 |
|---|---|
| 改寫模式 | 解碼 |
| 待改寫PATH | ^/videos/(.+) |
| 改寫后PATH | /cdn/$1 |
結果說明 ：原始請求：/videos/a/b/c.mp4，改寫后的回源請求：/cdn/a/b/c.mp4。改寫后的請求將會繼續匹配回源URI改寫規則列表中其余的規則。
示例二:
| 參數名 | 說明 |
|---|---|
| 改寫模式 | 解碼 |
| 待改寫PATH | ^/[^/]+(.+) |
| 改寫后PATH | $1 |
結果說明 ：原始請求：/a/b/c.mp4，改寫后的回源請求：/b/c.mp4。改寫后的請求將會繼續匹配回源URI改寫規則列表中其余的規則。
示例三:
| 參數名 | 說明 |
|---|---|
| 改寫模式 | 編碼 |
| 待改寫PATH | ^/video/(.*) |
| 改寫后PATH | /cdn/$1 |
結果說明 ：
原始請求：/video/視頻/a.mp4，改寫后的回源請求：/cdn/視頻/a.mp4。改寫后的請求將會繼續匹配回源URI改寫規則列表中其余的規則。
原始請求：/video/%E8%A7%86%E9%A2%91/a.mp4，改寫后的回源請求：/cdn/%E8%A7%86%E9%A2%91/a.mp4。改寫后的請求將會繼續匹配回源URI改寫規則列表中其余的規則。
示例四:
| 參數名 | 說明 |
|---|---|
| 改寫模式 | 解碼 |
| 待改寫PATH | ^/video/(.*) |
| 改寫后PATH | /cdn/$1 |
結果說明 ：
原始請求：/video/視頻/a.mp4，改寫后的回源請求：/cdn/%E8%A7%86%E9%A2%91/a.mp4。改寫后的請求將會繼續匹配回源URI改寫規則列表中其余的規則。
原始請求：/video/%E8%A7%86%E9%A2%91/a.mp4，改寫后的回源請求：/cdn/%E8%A7%86%E9%A2%91/a.mp4。改寫后的請求將會繼續匹配回源URI改寫規則列表中其余的規則。
