自定义缓存key

2024-04-28 05:20:31

功能介绍

缓存key是一个文件缓存在边缘节点上时的唯一标识，缓存文件和缓存key是一对一的关系。通常默认情况下，缓存key为客户端请求的原始URL（带参数）。

通过自定义缓存key，可以将原始URL形式不同但实际指向同一个文件的请求，缓存为同一份，从而提升缓存命中率，降低回源量。

适用场景

如果客户端请求不同URL时，实际指向同一份缓存文件，则可以通过自定义缓存key功能来实现将其在边缘节点上映射为同一份文件，避免出现被缓存成不同文件而导致回源率高的问题。

例如：部分客户会在请求URL中设置防盗链串，可能在请求参数中，也可能在URL某一级目录中，假设请求1为：http://www.ctyun.cn/xxxxx/test/a.mp4；请求2为：http://www.ctyun.cn/yyyyy/test/a.mp4；由于请求URL不同，边缘节点默认会视为请求不同文件而缓存成多个不同mp4文件，但实际其一级目录均为防盗链串，二者为同一文件内容。此时可设置缓存key为：http://www.ctyun.cn/test/a.mp4，即对缓存uri部分做自定义设置，从而达到共用同一份缓存的目的。

注意事项

【缓存配置】默认开启去问号缓存，开启后，如果客户的请求URL中含有多个参数值，例如请求1为：http://www.ctyun.cn/a.mp4?a=1，请求2为：http://www.ctyun.cn/a.mp4?a=2；则将这两个请求的缓存key统一为：http://www.ctyun.cn/a.mp4，以达到共用同一份缓存文件，降低回源率的效果。如您期望的自定义缓存key通过去问号缓存即可成功设置，无需配置自定义缓存参数。
自定义缓存key与【缓存配置】去问号缓存同时开启情况下，自定义缓存key优先级更高。
自定义缓存key一旦设置后，一般不建议轻易变动；如果您配置自定义缓存key生效后又再次变更，会导致原有的缓存失效，产生大量回源。
自定义缓存key需开启【静态加速】才可配置，未开启【静态加速】则全部文件不缓存，则无需配置缓存key。
缓存key仅针对边缘节点缓存key生效，不影响节点回源，如果设置了特定的缓存URI或缓存参数，例如保留或忽略全部或特定参数，节点回源时是否对URI进行改写，以及是否携带对应参数，取决于“回源URI改写”和“回源参数改写”功能的配置情况。
当前缓存URI和缓存参数可自助配置。

配置说明

缓存参数

登录控制台。
在加速管理-CDN加速配置页面，点击目标域名。
选择“静态配置-缓存参数”单击“编辑配置”。
单击添加，根据您的需求，配置需要的缓存参数。

配置参数说明：

参数名	配置值	说明
类型	后缀名/目录/首页/全部文件/全路径文件	需要配置的文件类型。
内容	指定类型的具体内容	类型选择后缀名、目录、全路径文件时，需配置具体内容；例如类型为后缀名时，需在内容处指明具体的文件后缀；如类型为目录时，需在内容处指明具体的目录内容。
忽略参数	不忽略/全部忽略/保留指定参数/忽略指定参数	缓存参数配置类型。如选择不忽略，则为带参数缓存；如选择全部忽略，则为去参数缓存；如为保留指定参数，则仅携带指定参数缓存；如为忽略指定参数，则为去指定参数后缓存。注意：保留指定参数不支持参数名带中划线，如参数名：a-b，如需配置，请提交工单。
优先级	数字	缓存配置的优先级；存在多条缓存参数设置时，相同文件类型及内容，执行优先级高的缓存规则。

缓存URI

登录控制台。
在加速管理-CDN加速配置页面，点击目标域名。
选择“静态配置-缓存URI”单击“编辑配置”。
单击添加，根据您的需求，配置需要的缓存参数。