自定义Cachekey

背景信息

• 自定义Cachekey功能不会修改回源的URL，仅会修改请求的缓存标识，回源的请求和客户端发起的请求内容保持一致。

• Cachekey是一个文件在ESA节点上缓存时唯一的身份ID，每个在ESA节点上缓存的文件都对应一个Cachekey。文件的Cachekey默认为客户端请求的URL（带参数）。

使用场景

场景一：统一Cachekey

客户的不同请求URL中含有复杂的参数，因此即使多个请求访问的是同一个文件，但由于URL参数不同，ESA节点会将这些不同的请求视为访问不同的文件，并缓存成多个文件，导致回源请求增加。

可通过自定义Cachekey功能设置忽略查询字符串，将同一类请求的Cachekey统一，降低回源率。

场景二：区分Cachekey

客户端请求的URL一样时，ESA将视为请求同一个文件。但实际上请求的Http Header中携带了client字段区分了客户端系统，希望请求不同文件。

此时可通过自定义Cachekey功能根据客户端类型来生成不同的Cachekey，两个请求即可识别为2个不同的Cachekey。

操作步骤

1. 登录ESA控制台。

2. 在左侧导航栏，单击站点管理。

3. 在站点管理页面，单击目标站点名称，或对应站点操作列的详情。

4. 在左侧导航栏，选择规则 > 缓存规则。

5. 单击新增规则，填写规则名称。

6. 在当请求匹配以下规则时...区域设置要匹配的用户请求特征，具体配置规则请参见规则概述。

7. 在绕过缓存区域，设置是否绕过缓存，具体请参见绕过缓存。

8. 在自定义Cachekey区域，单击配置，设置以下参数。

   

   参数	说明
   对查询字符串排序	选择是否开启对查询字符串排序功能，详情请参见查询字符串排序。
   查询字符串	设置去除请求URL中携带的?以及?之后的查询字符串，详情请参见查询字符串。
   HTTP请求标头	包括这些标头名称及其值：指定的HTTP请求标头名称及其值将会加入Cachekey。 检查是否存在：检查指定的HTTP请求标头是否存在。如果存在，把HTTP Header名称加入Cachekey。
   Cookie	包括这些Cookie名称及其值：指定的Cookie参数名称及其值将会加入Cachekey。 检查是否存在：检查指定的Cookie参数是否存在：存在的话，把Cookie参数名称加入Cachekey。
   用户	设备类型：根据客户端UA信息来识别客户端类型，然后根据客户端类型来生成Cachekey。客户端设备类型分为以下三种： desktop tablet mobile 国家/地区：根据客户端IP来识别客户端所在的国家/地区，然后根据国家/地区来生成Cachekey。 语言：根据客户端请求中携带的Accept-Language信息来识别客户端语言，然后根据语言类型来生成Cachekey。

9. 单击确定。

配置示例