回源URL重写

更新时间: 2025-08-05 03:28:49

 

因业务需要，客户调整了资源分类，会导致文件在源站的存放路径发生了变化，而此时终端用户访问该资源的URL没有发生变化，这种情况下就可以使用回源URL改写的功能改变CDN回源获取资源的URL，终端用户不需要修改访问URL就可以获取正确的资源。

 

配置项	说明
待重写的回源URI	以正斜线“/”或“*”开头的URI,  不含http(s)://头及域名 长度不超过1024个字符 URI支持通配符*匹配，如：/test/*/*.mp4。URI不含通配符“*”时，默认为全路径匹配。URI为单“*”时，默认匹配所有文件，即改写当前域名下所有文件的回源URL。
目标回源URI	长度不超过1024个字符 以正斜线 / 开头（例如：/newtest/b.jpg），通配符 * 可通过 $n 捕获（n=1,2,3....），例如：待重写回源URL配置为/test/*/*.jpg，目标回源Path配置为/newtest/$1/$2.jpg，则用户访问请求的回源URL为/test/a/b.jpg时，根据$1将捕获第一个通配符内容，即为a；$2将捕获第二个通配符内容，即为b，则实际回源URL将被改写为/newtest/a/b.jpg。$符个数需小于等于通配符“*”个数

可支持配置20条回源URL重写规则 顶部规则的优先级大于底部 仅支持同域名下URI改写

 

示例

示例一
待改写URI:/hello.jpg?code=123 ；目标回源URI：/image/hello.jpg?code=123
原始请求：http://www.example.com/hello.jpg?code=123
重写后的回源请求：http://www.example.com/image/hello.jpg?code=123

 

示例二
待改写URI: /test/*; 目标回源URI：/image/test/$1
原始请求：https://www.example.com/test/1.html
改写后的回源请求： https://www.example.com/image/test/1.html

 

示例三
待改写URI: /.html ; 目标回源URI：/admin/$1.html$2
原始请求：https://www.example.com/1.html?sign=1
改写后的回源请求： https://www.example.com/admin/1.html?sign=1

 

示例四
待改写URI:/test//.jpg ; 目标回源URI：/newtest/$1/$2.jpg
原始请求：http://www.example.com/test/a/b.jpg
改写后的回源请求:http://www.example.com/newtest/a/b.jpg

 

示例五
待改写URI:/test///a.jpg ; 目标回源URI：/new/$1/$2/a.jpg
原始请求：http://www.example.com/test/a/b/a.jpg
改写后的回源请求:http://www.example.com/new/a/b/a.jpg

 

示例六
待改写URI:/test1/a.jpg* ; 目标回源URI：/new/a.jpg?$1
原始请求：http://www.example.com/test1/a.jpg?imageMogr2/thumbnail/!50px
改写后的回源请求:http://www.example.com/new/a.jpg?imageMogr2/thumbnail/!50px

 

示例七
待改写URI为“*”时默认对所有文件的改写; 目标回源URI：/new.jpg
原始请求：https://www.example.com/aaa/bbb/1.html
改写后的回源请求： https://www.example.com/new.jpg