改写回源URL

适用场景

源站的资源路径发生了变更，客户源站的资源存放路径发生了变更，但是用户请求URL里面包含的资源路径没有变更，这时就需要CDN节点来改写回源请求里面的资源路径。

例如：图片文件原先存放在目录“/download/”，现在变更为“/image/”。

工作原理

注意事项

• 单个域名可以配置的回源URL改写规则数量上限是50个。
• 规则改写按照规则列表从上到下顺序依次执行，因此顺序可能会影响您的改写结果。
• 回源URL改写功能与重写功能的区别在于，重写功能的作用位置是在CDN边缘节点上面，会影响CDN内部链路，也会改写缓存key，而回源URL改写功能的作用位置是在CDN回源节点上面，不影响CDN内部链路，不改写缓存key。
• 回源URL改写功能在配置执行规则的情况下，对URL中参数的改写可能会与域名管理 > 性能优化页签下的忽略参数功能相冲突，同时配置的时候，需要注意避免配置冲突。

配置回源URL

1. 登录CDN控制台。
2. 在左侧导航栏，单击域名管理。
3. 在域名管理页面，单击目标域名对应的管理。
   
4. 在指定域名的左侧导航栏，单击回源配置。
5. 单击回源URL改写页签。
6. 单击添加。
7. 根据您的需求，配置待改写的Path、目标Path和执行规则。
   

   参数	示例	说明
   待改写的Path	^/hello$	以正斜线（/）开头的URL，不含http://头及域名。支持PCRE正则表达式。
   目标Path	/hello/test	以正斜线（/）开头的URL，不含http://头及域名。
   执行规则	空	如果配置了多条规则，在匹配执行当前规则后，按照从上到下顺序按依次执行可以匹配的所有规则。
   	break	如果配置了多条规则，若请求的URL匹配了当前规则，匹配执行完当前规则后，剩余规则将不再匹配。 只修改URL中的资源路径部分，不修改URL的参数，不影响回源参数改写功能对URL中参数的改写。
   	enhance break	如果配置了多条规则，若请求的URL匹配了当前规则，匹配执行完当前规则后，剩余规则将不再匹配。 与break相似，但是增加了对URL中参数部分的改写能力，对URL中参数的改写可能会与回源参数改写功能对URL中参数的改写相冲突，这两个功能同时配置的时候，需要注意避免配置冲突。

8. 单击确定，使改写规则开始执行和生效。

   您也可以在回源URL改写页面的规则列表中，单击修改或删除，对当前配置的规则进行相应操作。

配置示例

• 样例一：执行空规则。

  待改写的Path	^/hello$
  目标Path	/index.html
  执行规则	空
  结果说明	原始请求：http://example.com/hello 改写后的回源请求：http://example.com/index.html 该请求将会继续匹配回源URL改写规则列表中其余的规则。

• 样例二：执行break规则。

  待改写的Path	^/hello.jpg$
  目标Path	/image/hello.jpg
  执行规则	break
  结果说明	原始请求：http://example.com/hello.jpg 改写后的回源请求：http://example.com/image/hello.jpg 该请求将不再继续匹配回源URL改写规则列表中其余的规则。

• 样例三：执行enhance break规则。

  待改写的Path	^/hello.jpg?code=123$
  目标Path	/image/hello.jpg?code=321
  执行规则	enhance break
  结果说明	原始请求：http://example.com/hello.jpg?code=123 改写后的回源请求：http://example.com/image/hello.jpg?code=321 该请求将不再继续匹配回源URL改写规则列表中其余的规则。

• 样例四：在文件名是变量的情况下对根目录添加URL前缀。

  例如：将包含/xxx的URL（xxx代表任意文件名称，例如：/hello.jpg、/hello.html等等）改写为/image/xxx，即对根目录下的任意文件的URL都插入路径/image。

  待改写的Path	^(.*)$ 说明 ^(.*)$代表任意字符，()代表的是一个分组，可以在目标Path中通过$1来调用分组的变量内容。
  目标Path	/image$1 说明 $1表示正则表达式中第一对圆括号中的表达式匹配到的内容，$2是第二个小括号里面的内容，依此类推。
  执行规则	break
  结果说明	原始请求：http://example.com/hello.jpg 改写后的回源请求：http://example.com/image/hello.jpg 原始请求：http://example.com/hello.html 改写后的回源请求：http://example.com/image/hello.html 该请求将不再继续匹配回源URL改写规则列表中其余的规则。

• 样例五：在文件名是变量的情况下对指定目录添加URL前缀。
  例如：将包含/live/xxx的URL（xxx代表任意文件名称，例如：/live/hello.jpg、/live/hello.html 等等）改写为/image/live/xxx，即对目录/live下的任意文件的URL都插入路径/image。

  待改写的Path	^/live/(.*)$
  目标Path	/image/live/$1
  执行规则	break
  结果说明	原始请求：http://example.com/live/hello.jpg 改写后的回源请求：http://example.com/image/live/hello.jpg 原始请求：http://example.com/live/hello.html 改写后的回源请求：http://example.com/image/live/hello.html 该请求将不再继续匹配回源URL改写规则列表中其余的规则。

• 样例六：匹配多条规则时，执行空规则。
  配置两条规则如下图所示：
  结果说明：

  • 原始请求：http://example.com/image_01.png
  • 改写后的回源请求：http://example.com/image/image_02.png
    说明 先匹配第一条规则，改写为http://example.com/image_02.png，继续匹配第二条规则，最终改写为http://example.com/image/image_02.png。
• 样例七：匹配多条规则时，执行break规则。
  配置两条规则如下图所示：
  结果说明：

  • 原始请求：http://example.com/image_01.png
  • 改写后的回源请求：http://example.com/image_02.png
    说明 先匹配第一条规则，改写为http://example.com/image_02.png，由于第一条规则为设置为break，所以不再匹配后续规则。