回源URL改写

更新时间:2026-03-12 14:21:12

当您在CDN配置了回源URL改写,CDN将在回源时按照您配置的改写需求发起回源请求。

如何设置回源URL改写

  1. 登录CDNetworks控制台, 选择对应的产品。
  2. 进入自助配置页面,找到要设置的域名,点击上方配置修改或者域名右侧的编辑按钮 Upcoming Updates to Product Navigation and Document Center
  3. 进入配置修改页面,找到回源设置-回源URL改写,点击添加修改
  4. 根据需求配置要改写的内容。

Upcoming Updates to Product Navigation and Document Center

URL匹配模式
匹配符合要求的客户端请求URL。支持填写正则表达式,不需要以/开头,平台默认会在配置中补充前缀^https?://[^/]/,例如: .*.jpg$,表示针对关联该规则的所有域名对JPG文件的请求都将匹配该规则。

回源域名
仅支持填写回源域名,不支持回源IP。

回源域名还可以通过源配置批量修改源配置中配置,但生效优先级低于本配置。也就是说,当您在多个地方均配置了回源域名,以回源URL改写中配置的值生效。

回源请求HOST
当你需要指定客户端与之通信的服务器的主机名或域名时,则必须配置回源请求Host值,因为不同域名可能共享同一个源站IP,源站使用这个值来决定响应什么内容。配置之后,当客户端携带对应Host发起回源请求时,源站将响应Host对应的主机名或域名对应的内容。
例如,如果配置了回源请求Host值www.cdnetworks.net, 客户端请求域名www.testdomain.com将会携带www.cdnetworks.netHost中回源,源站将响应www.cdnetworks.net对应的内容。

回源请求Host还可以通过源配置批量修改源配置回源Host和回源端口中配置,但生效优先级都比回源URL改写低,若同时配置以回源URL改写中的配置内容生效。

旧路径
填写需要被修改的旧路径,即旧的uri内容。支持正则。
旧路径和新路径必须同时配置才能生效。

新路径
填写修改后的新路径,新路径将替代旧路径回源。支持正则。
旧路径和新路径必须同时配置才能生效。

忽略大小写

  • 如果选择了,将会忽略您定义的URL匹配规则的大小写匹配客户端请求。比如您配置a.jpg,无论客户端请求URL是http://domain/a.jpghttp://domain/A.jpg都将按照该配置的改写需求回源。
  • 如果您选择,则将严格按照您在URL匹配规则配置中的设置匹配客户端请求。比如您配置a.jpg,客户端请求URL为http://domain/a.jpg时认为匹配成功,会按照该配置的改写需求回源,http://domain/A.jpg则认为不匹配,不会按该配置的改写需求回源;
  • 该配置项默认值为

优先级
您可以选择该规则生效的优先级,数字越大匹配和执行的优先级越高。在同一匹配条件下,执行优先级高的规则。

完成上述配置后,请点击确认,然后选择下一步提交您的配置。为了避免配置影响您的生产环境,我们推荐您先预部署,把配置生效到测试环境中来验证您的配置是否正确。当配置确定无误后,单击直接部署将配置正式生效到线上环境,通常约3-5分钟后,配置将正式生效到线上环境。关于预部署测试的更多细节,请参考教程通过预部署来验证配置是否生效

配置示例

当用户请求的URL路径正好是a.jpg时,比如http://您的CDN域名/a.jpg,CDN将改写回源请求URL:

  • 把原来的回源URL中的路径/test/123.jpg换成/123.jpg
  • 把原来的回源域名换成www.testdomain.com

也就是说,CDN回源请求会变成http://www.testdomain.com/123.jpg

Upcoming Updates to Product Navigation and Document Center

注意事项

  1. 回源URL配置除了允许配置URL中的回源域名URI之外,还额外支持配置回源请求Host,但并未强制配置,您可以根据需求选择性地配置。这是为了方便您灵活配置,不用到多个配置地址中逐一配置。
  2. 回源URL改写源配置批量修改源配置回源Host和回源端口均支持配置回源域名回源请求Host,但回源URL改写优先级高于其他配置,当出现多处配置时,平台会优先按照回源URL改写中的配置内容生效。
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!