回源URI改寫
更新時間 2025-05-19 16:56:19
最近更新時間: 2025-05-19 16:56:19
分享文章
本文介紹回源URI改寫功能的適用場景和配置說明。
功能介紹
回源URI改寫可以實現在用戶請求需要回源時進行URI改寫， 配置回源URI改寫功能后，全站加速節點向源站發起回源請求時將使用改寫后的URI。
適用場景
- 源站服務器的資源所在的路徑發生了變化，而用戶仍然使用原來的URI，此時可在客戶控制臺配置回源URI改寫功能，將原URI指向新的資源路徑。
- 源站內有同樣的資源在多個地方復用，也可以通過回源URI改寫將資源指向指定的資源路徑。
注意事項
- 回源URI改寫功能只能針對請求URI進行改寫，無法對URI后的參數進行改寫，若要對URI后的參數進行改寫，詳情請見：回源參數改寫。
- URI改寫會按照從上到下順序執行規則列表，因此規則列表的順序會影響改寫結果。
- 單個域名可配置的回源URI改寫的規則上限是50條。
配置說明
- 登錄。
- 單擊左側導航欄【域名管理】-【域名列表】。
- 在【域名列表】頁面，找到目標域名，單擊【操作】列的【編輯】。
- 單擊右側【回源配置】。
- 在【回源URI改寫】模塊，單擊【增加規則】。
- 配置【改寫模式】、【待改寫PATH】、【改寫后PATH】。
- 單擊【保存】，完成配置。
| 參數名 | 說明 |
|---|---|
| 改寫模式 | 默認解碼，對回源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改寫規則列表中其余的規則。
