文档

配置访问URL改写规则

更新时间:

如果源站资源的存放路径变化,CDN节点存放资源的路径也会随之变化。用户请求的URL路径如果没有变化,就需要CDN节点来改写用户请求的URL,将请求URL重定向到目标Path,减少回源,提升客户端访问性能。

背景信息

HTTP 302状态码(即302 Found),可表示资源被临时改变了位置。配置访问URL改写后,CDN节点会在给客户端发送的302状态码响应信息的HTTP Location头部中放置新的URL地址信息,客户端收到302状态码响应之后,将会向新的URL地址发起请求。

配置访问URL改写规则后,CDN节点默认给客户端发送302重定向状态码,同时也支持303和307重定向状态码,如果您需要修改重定向状态码,可以通过填写信息申请。

编码

含义

处理方法

典型应用场景

302

Found

GET方法不会发生变更,其他方法有可能会变更为GET方法。

由于不可预见的原因该页面暂不可用。在这种情况下,搜索引擎不会更新它们的链接。

303

See Other

GET方法不会发生变更,其他方法会变更为 GET 方法(消息主体会丢失)。

用于PUT或POST请求完成之后进行页面跳转,防止由于页面刷新导致的操作的重复触发。

307

Temporary Redirect

方法和消息主体都不发生变化。

由于不可预见的原因该页面暂不可用。在这种情况下,搜索引擎不会更新它们的链接。当站点支持非 GET 方法的链接或操作的时候,该状态码优于 302 状态码。

重要

单个域名最多可以配置50条重写规则。配置多条规则时,按照CDN控制台访问URL改写列表由上而下的顺序执行。

适用场景

客户源站的资源存放路径发生了变更,CDN节点上的资源存放路径也发生了变更,但是用户请求URL里面包含的资源路径没有变更,这时就需要CDN节点来改写用户请求里面的资源路径。例如:图片文件原先存放在目录“/download/”,现在变更为“/image/”。

URI重写规则

操作步骤

  1. 登录CDN控制台

  2. 在左侧导航栏,单击域名管理

  3. 域名管理页面,找到目标域名,单击操作列的管理

  4. 在指定域名的左侧导航栏,单击缓存配置

  5. 单击访问URL改写页签。

  6. 单击添加,根据您的实际需求,配置访问URL改写参数。

    重写

    参数

    说明

    待改写的Path

    以正斜线(/)开头的URL,不含http://头及域名。支持PCRE正则表达式,例如:^/hello$。

    目标Path

    以正斜线(/)开头的URL,不含http://头及域名,例如:/index.html。

    执行规则

    • 默认支持RedirectBreak这两种规则。

      • Redirect:如果请求URL匹配了某条规则,该请求将会被302重定向到目标URL, CDN节点返回给客户端的Location信息为目标URL(不修改原始URL中的参数)。执行完当前规则后,当存在其他配置规则时,会继续匹配剩余规则。

      • Break:如果请求URL匹配了某条规则,该请求将会被改写为目标URL(不修改原始URL中的参数)。执行完当前规则后,当存在其他配置规则时,将不再匹配剩余规则。

    • 同时支持enhance-breakenhance_redirect三种规则,这三种规则需要提交工单申请后台配置。

      • : 配置了多条规则的情况下,如果请求URL匹配了某条规则,执行完当前规则以后,还会继续匹配后续规则。

      • enhance_break : 和 break类似,但是会修改包含参数在内的整个URL。

      • enhance_redirect : 和redirect类似,但是会修改包含参数在内的整个URL。

    说明

    不同的执行规则使用的改写方式不同,改写后的URL是否支持其他域名、其他协议也存在差异:

    • Breakenhance_break采用直接改写用户请求URL的方式,不支持改写为其他域名,也不支持改写为其他协议(例如从HTTP协议改写为HTTPS协议)。

    • Redirectenhance_redirect采用302跳转方式实现URL改写,支持改写为其他域名,也支持改写为其他协议:

      • 302 Location地址除了可以设置为当前的加速域名,还支持设置为其他域名,可以实现这样的效果:原始URL使用的域名是example.com,改写后的URL使用新的域名aliyundoc.com

      • 302 Location地址支持使用其他协议,可以实现这样的效果:原始URL使用HTTP协议,改写后的URL使用HTTPS协议。

    规则条件

    规则条件能够对用户请求中携带的各种参数信息进行识别,以此来决定某个配置是否对该请求生效。

    • 不使用:不使用规则条件。

    • 选择已配置的规则引擎,新增或修改规则引擎请参见规则引擎

    开启Nginx变量计算

    默认为不勾选,勾选上以后可以在目标URL中使用nginx内置变量。配置示例如下:

    • 待改写的Path:^/test.jpg$

    • 目标Path:/test.${arg_type}

    • 开启Nginx变量计算以后实现的效果是会把${nginx_var}值计算出来,${arg_type}表示原始URL中参数type的值。

    说明

    该参数需提交工单申请后台配置。

  7. 单击确定,完成配置。

    成功配置重写功能后,您可以在重写列表中,对当前的配置进行修改删除操作。

配置示例

访问URL改写规则按照正则表达式配置如下图所示:正则表达

客户端请求http://example.aliyundoc.com/hello时,请求中包含/helloCDN节点会在302状态码的Location信息里写入新的URL地址http://example.aliyundoc.com/index.html,并返回给客户端,客户端对http://example.aliyundoc.com/index.html发起请求。

相关API

BatchSetCdnDomainConfig

  • 本页导读 (1)
文档反馈