# 回源URL改写 当回源请求URL与源站URL不匹配时，会导致回源失败。您可以在CDN控制台改写回源URL，提高回源请求URL与源站的匹配度，提升回源命中率。 #### 适用场景 因业务需要，客户调整了资源分类，导致某视频文件在源站的存放路径由/test/改成了/video/，而此时终端用户访问该资源的URL没有发生变化，这种情况下就可以使用回源URL改写的功能改变CDN回源获取资源的URL，终端用户不需要修改访问URL就可以获取正确的资源。 #### 工作原理 配置回源URL改写后，如果用户请求匹配了改写规则，回源时的流程如下图所示。 ![](https://support.huaweicloud.com/usermanual-cdn/zh-cn_image_0000002339748673.jpg "点击放大") 1. 用户使用原URL发起请求，假设原URL为example.com/test/index.html，此时未命中缓存且匹配了回源URL改写规则。 2. 节点使用改写后的URL（example.com/newtest/index.html）向源站发起请求。 3. 源站返回请求资源给CDN节点。 4. CDN节点缓存该资源并返回给用户。 #### 配置约束 - 最多添加20条回源URL改写规则。 - 如果您配置了B类或C1类URL鉴权，暂不支持回源URL改写功能。 - 后台有特殊配置的域名暂不支持改写回源URL。 - 如果您域名的业务类型是全站加速，本功能仅对静态资源生效。 #### 操作步骤 1. 登录[CDN控制台](https://console.huaweicloud.com/cdn/?locale=zh-cn#/cdn/overview)。 2. 在左侧菜单栏中，选择"域名管理"。 3. 在域名列表中，单击需要修改的域名，进入"概览"页面。 4. 选择"回源配置"页签。 5. 在"回源URL改写"模块，单击"添加"，进入配置界面。 图1回源URL改写 ![](https://support.huaweicloud.com/usermanual-cdn/zh-cn_image_0000002583546259.png "点击放大") 表1参数说明 | 参数 | 说明 | |:---|:---| | 匹配方式 | **所有文件**：改写当前域名下所有文件的回源URL。 | | 匹配方式 | **URL路径**：改写指定路径下的回源URL，前缀匹配。如果待改写URI为/test，将会改写前缀匹配到/test的所有文件（例如/test、/test01、/test02等）。 | | 匹配方式 | **通配符**：支持通配符匹配，全路径匹配，待改写URI需要指定到具体路径，如/test/\*/\*.mp4。 | | 匹配方式 | **全路径**：改写当前路径的URL，全路径匹配，待改写URI需要指定到具体路径，如/test/01/abc.mp4。 | | 待改写回源URI | 需要替换的URI。 如果加速域名配置了[配置客户端访问URL重写](https://support.huaweicloud.com/usermanual-cdn/cdn_01_0263.html)功能，CDN将使用重写后的URL回源，此时匹待改写回源URI需要配置为重写后的路径，否则无法匹配到该条规则。 - 以正斜线（/）开头的URI，不含http(s)://头及域名。 - 长度不超过512个字符。 - "匹配方式"为"URL路径"或"全路径"时，支持配置通配符"\*"，如：/test/\*/abc。 - 最多可配置5个"\*"，且"\*"不可连续出现。 - "匹配方式"为"URL路径"或"全路径"时，不支持配置参数。 - "匹配方式"为"通配符"且输入"/"时，匹配根目录。 说明： 华为云CDN于2026年4月调整了"\*"的匹配逻辑： 1. "匹配方式"为"URL路径"或"全路径"时： - 已经配置过"\*"的账号："\*"仅代表单个字符，不做通配符处理，如需调整为通配符匹配，请提交工单申请。 - 从未配置过"\*"的账号："\*"作为通配符匹配，可以匹配**0到多个字符**。 2. "匹配方式"为"通配符"时： - 已经配置过通配符的账号：通配符"\*"可以匹配1到多个字符，如果需要调整为可以匹配**0到多个字符**，请提交工单申请。 - 从未配置过通配符的账号：通配符"\*"可以匹配0到多个字符。 | | 目标回源URI | 替换后的URI。 - 以正斜线（/）开头的URI，不含http(s)://头及域名。 - 长度不超过256个字符。 - "匹配方式"为"通配符"时，通配符 \* 可通过$n捕获（n=1,2,3...，例如：待改写回源URI为/test/\*/\*.mp4，目标回源URI为/newtest/$1/$2.mp4，则用户请求/test/11/22.mp4时，$1捕获11 ，$2捕获22，实际回源的URI为/newtest/11/22.mp4），其他"匹配方式"不支持配置$n。 | | 优先级 | 回源URL改写规则的优先级。 - 优先级设置具有唯一性，不支持多条回源URL改写规则设置同一优先级，且优先级不能输入为空。 - 多条规则下，不同规则中的相同资源内容，CDN按照优先级高的规则执行URL改写。 - 取值为1\~1000之间的整数，数值越大优先级越高。 | 6. 根据业务需要，配置相关改写规则，单击"确定"，完成配置。 #### 配置示例 **示例1**：加速域名www.example.com的回源URL改写配置如下图所示。 ![](https://support.huaweicloud.com/usermanual-cdn/zh-cn_image_0000002323704986.png "点击放大") 原始请求：https://www.example.com/test/a.txt 改写后的回源请求：https://www.example.com/test/b.txt **示例2**：加速域名www.example.com的回源URL改写配置如下图所示。 ![](https://support.huaweicloud.com/usermanual-cdn/zh-cn_image_0000002323868798.png "点击放大") 原始请求：https://www.example.com/test/aaa/bbb.mp4 改写后的回源请求：https://www.example.com/newtest/aaa/bbb.mp4 **示例3**：加速域名www.example.com的回源URL改写配置如下图所示。 ![](https://support.huaweicloud.com/usermanual-cdn/zh-cn_image_0000002357788709.png "点击放大") 原始请求：https://www.example.com/test/aaa/bbb.txt 改写后的回源请求：https://www.example.com/new.jpg **示例4**：加速域名www.example.com的回源URL改写配置如下图所示。 ![](https://support.huaweicloud.com/usermanual-cdn/zh-cn_image_0000002357790521.png "点击放大") 原始请求：https://www.example.com/123.html?id=3 改写后的回源请求：https://www.example.com/thread0/123.html?id=3 #### 相关文档 调用接口修改回源URL改写请参考：[修改域名全量配置接口 - UpdateDomainFullConfig](https://support.huaweicloud.com/api-cdn/UpdateDomainFullConfig.html)。