本文将为您介绍如何在 veImageX 控制台配置缓存键值。
缓存键值介绍
缓存键是每个在缓存中的文件的唯一标识。在收到一个用户请求时，veImageX 会对请求生成一个缓存键。通常情况下，缓存键包含 host，路径和查询字符串。例如，www.example.com/image.png?version=1。然后，veImageX 会尝试将该缓存键与缓存文件的缓存键相匹配。需要留意的是，缓存键的匹配过程是大小写敏感的。
- 如果找到一个匹配，则表示缓存命中。在这个情况下，veImageX 将缓存的文件发送给用户。
- 如果未找到匹配，则表示缓存未命中。在这个情况下，veImageX 会向源站请求该文件。在收到该文件后，veImageX 会使用该缓存键来缓存文件。
缓存键配置
veImageX 提供了缓存键配置的功能。您可以在控制台中创建缓存键规则。该功能的目的是指示 veImageX 在对请求的文件生成缓存键时，缓存键中包含哪些请求 URL 中的查询参数。由于生成的缓存键会被 veImageX 用来匹配缓存的文件，因此缓存键规则会直接影响缓存命中率。
使用场景
如果您站点上文件 URL 中的查询参数并不是用来区分文件的，您可以通过创建缓存键规则来指定 veImageX 在生成的缓存键中需要丢弃的查询参数，以提高缓存命中率，减少回源请求。例如，URL 中包含了 auth 参数。其目的是用来验证用户的身份，不是用来区分文件。在这个情况下，该参数就无需包含在生成的缓存键中。
默认缓存键值规则
注意
仅当您关闭忽略参数缓存后，您才可修改默认缓存键值规则的参数缓存类型配置。
如果您不配置任何缓存键值规则，系统会使用默认的缓存键值规则。该默认规则出现在规则列表中，而且不能被删除，如下图所示。
默认规则指定了 veImageX 保留所有 URI 参数。规则的生效范围是加速域名下的所有文件。您不可以更改生效范围，但是可以修改 URI 参数处理方式。如果某个用户请求的内容不匹配您配置的任何缓存键值规则，则会匹配系统默认的缓存键值规则。
操作步骤
登录 veImageX 控制台。
选择 服务管理 > 基础配置 > 配置 > 缓存配置，进入缓存配置页面。
选择缓存键值配置，单击编辑按钮。
在缓存键值下方，根据自身业务需求，单击添加缓存键值规则按钮，进行规则配置。
配置项 说明 优先级 表示规则的优先级。如果有多条规则，则按优先级来执行规则。您可以通过拖拽调整规则的优先级。默认缓存键值规则的优先级是最低的。 规则类型
选择一个规则类型。该配置的取值如下：
- 文件后缀：缓存键值规则应用于特定后缀名的所有文件。
- 目录匹配：缓存键值规则应用于特定目录下的所有文件。
- 文件全路径：缓存键值规则应用于特定文件。
规则
根据指定的规则类型，输入规则内容。规则内容不能超过 1,024 个字符。你可以输入一个或者多个配置，多个配置以英文分号（;）分隔。
规则内容是区分大小写的。比如对于文件后缀规则，您输入的配置是png;txt。此时，是无法匹配.PNG和.Txt文件的。
规则内容的要求如下：- 如果类型是文件后缀，需要输入一个或者多个文件后缀。比如
xlsx或者png;txt。文件后缀只可以包含英文字母和数字。 - 如果类型是目录匹配，需要输入一个或者多个目录路径。目录路径的输入要求如下：
- 目录路径必须以反斜杠（/）开头和结尾。比如
/www/img/volc/;/www/doc/。如果要指定加速域名下的所有目录，输入/。 - 目录路径可以包含可打印 ASCII 字符，以下字符除外：
- 连续斜杠（//）、百分号（%）、空格。
- 目录路径必须以反斜杠（/）开头和结尾。比如
- 如果类型是文件全路径，需要输入一个或者多个文件路径。文件路径的输入要求如下：
- 文件路径必须以反斜杠（/）开头。比如
/www/img/volcano.png;/doc/study.docx。 - 文件路径支持使用通配符（*）表示一个或者多个连续字符。
- 文件路径可以包含可打印 ASCII 字符，以下字符除外：
- 连续斜杠（//）、百分号（%）、空格、美元符号（$）、问号（?）、Delete（ASCII code 127）。
- 文件路径必须以反斜杠（/）开头。比如
参数缓存类型
指定 veImageX 在缓存文件和匹配缓存中的文件时，处理请求 URL 中的查询参数的方式。该配置的取值如下：
- 保留全部参数：保留全部查询参数。
- 删除全部参数：不保留任何查询参数。
- 删除部分参数：删除指定的查询参数。
- 保留部分参数：保留指定的查询参数。
指定参数
指定需要要保留或者删除的查询参数。多个查询参数用英文分号（;）分隔。比如
version;size。- 如果参数缓存类型是保留全部参数或者删除全部参数，该参数固定值为
*。*表示全部查询参数。 - 如果参数缓存类型是删除部分参数或者保留部分参数，您可以指定一个或者多个查询参数，但是您不能指定
*。同时，您指定的查询参数不能包含连续斜杠（//）、百分号（%）、空格。
该配置的默认值是
*。忽略大小写 指定在匹配用户请求的内容时，查询参数是否区分大小写。比如您设置参数缓存类型为删除指定参数，指定参数为 sign，同时设置 忽略大小写为关闭。此时如果用户请求中包含参数 Sign，veImageX 判断为大小写不同，触发回源。同时，veImageX 在缓存该文件时，保留Sign参数。完成配置后，单击确认按钮。