本文档为您介绍 veImageX 的共享缓存与状态码缓存的配置说明。

共享缓存

共享缓存允许同账号下多个加速域名共享同一份节点上的缓存。在 veImageX 中，您可以通过设置共享缓存配置，使各个子站点之间可共享相同的公共资源，以减少带宽的使用，提高资源命中率。

适用场景

• 您的多个域名下的文件完全相同。为了降低 veImageX 向源站请求文件的次数，您可以对这些域名配置共享缓存。
• 您的站点有多个面向不同用户分发渠道的域名。这些域名所分发的内容是相同的。

当您添加、修改或删除一个共享缓存配置后，配置域名请求的缓存命中率可能会下降。具体原因参见共享缓存的工作方式。请谨慎操作。

共享缓存的工作方式

在您创建了一个共享缓存配置后，如果收到某个配置域名的一个请求，veImageX 按以下流程处理该请求：

1. 根据配置域名下的缓存规则，确定请求的文件是否需要被缓存以及缓存的时长。如果文件不需要被缓存，veImageX 向配置域名的源站请求该文件，然后使用该文件响应这个请求。流程结束。
2. 如果文件需要被缓存，veImageX 会将请求的文件 URL 中的域名替换成目标域名，然后在缓存中查找请求的文件。如果在缓存中没有找到该文件，转到第 4 步。
3. 如果在缓存中找到了该文件，veImageX 会使用步骤 1 中获取的缓存时长来判断缓存的文件是否已经过期。如果文件没有过期，veImageX 使用该文件响应这个请求。流程结束。
4. 如果文件已经过期或者 veImageX 没有在缓存中找到该文件，veImageX 会向配置域名的源站请求该文件。
5. 从源站获取文件后，veImageX 将该文件作为目标域名的文件进行缓存。流程结束。

共享缓存配置会对边缘节点的缓存造成影响，请谨慎进行创建，删除和修改操作。在操作前，请务必阅读注意事项。

使用限制

• 只能选择同账号下的加速域名进行缓存共享，且该域名的状态必须为正常。
• 如果某个域名已被设置为其他域名的共享域名，您无法在任何的共享缓存配置中将该域名设置为配置域名。
• 共享域名不能是泛域名。

操作步骤

1. 登录 veImageX 控制台。

2. 选择 服务管理 > 基础配置 > 配置 > 缓存配置，进入缓存配置页面。

3. 选择共享缓存配置，单击编辑按钮，参考下表修改配置。

   

   配置项	说明
   状态	默认关闭，开启后可配置共享域名。
   共享域名	选择一个或多个域名作为共享域名。

注意事项

在您创建和修改一个共享缓存配置前，建议将配置域名与共享域名设置成使用相同的源站配置以及缓存键值配置。在共享缓存配置生效后，缓存命中率可以得到提升，也避免出现不正确的缓存文件的情况。

• 对于配置域名的请求，veImageX 在缓存中查找文件时，查找的是目标域名下的文件，而非配置域名下的文件。短期内，对于配置域名的请求，缓存命中率可能会下降。
• 在您创建一个共享缓存配置后，配置域名的缓存就失效了。在您删除一个共享缓存配置后，配置域名的缓存需要重建。
• 建议共享缓存配置中的域名使用相同的源站配置。如果不相同，可能会出现以下情况：
  • 不同源站下存在路径相同，文件名相同，但是更新时间或者内容不相同的文件。基于共享缓存的工作方式，实际被缓存的文件可能会是来自任意的源站，出现用户获得不正确的文件的情况。
• 建议配置域名的缓存键值配置与目标域名的相同，以提升缓存命中率。

状态码缓存规则

如果源站的响应状态码不是 2xx，veImageX 默认不缓存请求的内容。如果另一个用户请求相同的内容时，veImageX 还是会向源站请求改内容。如果您希望在短时间内避免这些回源请求，可以配置状态码缓存，降低源站压力。在配置了状态码缓存后，在您指定的时间内，这些内容的用户请求不会触发回源请求，veImageX 会直接返回相应的状态码。

当前，您只能对 400-599 区间内的状态码配置状态码缓存。

操作步骤

1. 登录 veImageX 控制台。

2. 选择 服务管理 > 基础配置 > 配置 > 缓存配置，进入缓存配置页面。

3. 选择状态码缓存规则配置，单击编辑按钮，参考下表完成缓存规则配置。

   

   配置项	说明
   优先级	表示规则的优先级。如果有多条规则，则按优先级来执行规则。您可以通过拖拽调整规则的优先级。
   规则类型	选择一个缓存规则的类型。 文件后缀：规则应用于特定后缀名的所有文件。 目录匹配：规则应用于特定目录下的所有文件。 文件全路径匹配：规则应用于特定文件。
   规则	根据指定的 规则类型，输入规则的内容。长度不能超过 1024 个字符，同时不能包含以下字符： 连续斜杠（//）、空格、美元符号（$）、问号（?）、Delete（ASCII code 127）。 同时， 如果规则类型是 文件后缀，规则内容必须是一个或者多个以分号（;）分隔的文件后缀。文件后缀无需以句点（.）开头。例如：png;txt。 如果规则类型是 目录，规则内容必须是一个或者多个以分号（;）分隔的目录路径。目录路径必须以斜杠（/）开头和结尾。例如：/chs/foods/;/us/birds/。 如果规则类型是 文件全路径，规则内容必须是一个或者多个以分号（;）分隔的文件路径。文件路径必须以斜杠（/）开头，可以包含星号（*）用来表示一个或者多个字符。例如：/chs/foods/local*sets;/us/birds/chickadee。
   忽略大小写	设置 veImageX 在使用规则匹配用户请求的文件时是否区分大小写。请求 URL 的其余部分不受该配置影响。默认为关闭，表示区分大小写。 示例：对于文件后缀规则，您设置 忽略大小写 为关闭。您输入的规则内容是 png;txt。此时，该规则可以匹配 HTTPS://www.EXAMPLE.com/volcano.png，但是不能匹配 https://www.example.com/volcano.PNG。
   状态码	输入一个状态码。您可以输入的状态码的范围是 400-599。您可以输入 4xx 或者 5xx。4xx 表示 400 到 499 之间的所有状态码。5xx 表示 500 到 599 之间的所有状态码。
   缓存时间	表示缓存的时间。您可以指定的最长缓存时间是 10 年，即 315360000 秒。该配置的说明如下： 如果您指定的时间单位是 秒，您可以输入的最大缓存时间是 315360000。 如果您指定的时间单位是 分，您可以输入的最大缓存时间是 5256000。 如果您指定的时间单位是 小时，您可以输入的最大缓存时间是 87600。 如果您指定的时间单位是 天，您可以输入的最大缓存时间是 3650。