veImageX
veImageX
- 文档首页
veImageX控制台指南服务管理分发配置域名配置缓存配置共享缓存和状态码缓存规则
复制全文
下载 pdf
文档反馈
问问助手本文为您介绍 veImageX 的共享缓存与状态码缓存的配置说明。
说明
若您的缓存配置项由于某些原因（如启用了非标配置）被锁定，锁定后界面将展示锁定图标。您可提交工单联系技术支持修改配置。
共享缓存
注意
- 共享缓存为白名单功能，请提交工单联系技术支持为您的账号开启配置能力。
- 配置共享缓存时，可能导致共享域名已有的缓存副本失效，进而引发大量的回源请求，可能会遇到 429 错误（请求过多），请谨慎操作。
共享缓存允许同账号下多个加速域名共享同一份节点上的缓存。在 veImageX 中，您可以通过设置共享缓存配置，使各个子站点之间可共享相同的公共资源，以减少带宽的使用，提高资源命中率。
适用场景
- 您的多个域名下的文件完全相同。为了降低 veImageX 向源站请求文件的次数，您可以对这些域名配置共享缓存。
- 您的站点有多个面向不同用户分发渠道的域名。这些域名所分发的内容是相同的。
当您添加、修改或删除一个共享缓存配置后，共享域名请求的缓存命中率可能会下降。具体原因参见共享缓存的工作方式。请谨慎操作。
共享缓存的工作方式
在您创建了一个共享缓存配置后，如果收到某个共享域名的一个请求，veImageX 按以下流程处理该请求：
- 根据共享域名下的缓存规则，确定请求的文件是否需要被缓存以及缓存的时长。如果文件不需要被缓存，veImageX 向共享域名的源站请求该文件，然后使用该文件响应这个请求。流程结束。
- 如果文件需要被缓存，veImageX 会将请求的文件 URL 中的域名替换成当前域名，然后在缓存中查找请求的文件。如果在缓存中没有找到该文件，转到第 4 步。
- 如果在缓存中找到了该文件，veImageX 会使用步骤 1 中获取的缓存时长来判断缓存的文件是否已经过期。如果文件没有过期，veImageX 使用该文件响应这个请求。流程结束。
- 如果文件已经过期或者 veImageX 没有在缓存中找到该文件，veImageX 会向共享域名的源站请求该文件。
- 从源站获取文件后，veImageX 将该文件作为当前域名的文件进行缓存。流程结束。
共享缓存配置会对边缘节点的缓存造成影响，请谨慎进行创建，删除和修改操作。在操作前，请务必阅读注意事项。
使用限制
- 只能选择同账号下的加速域名进行缓存共享，且该域名的状态必须为正常。
- 如果某个域名已被设置为其他域名的共享域名，您无法在任何的共享缓存配置中将该域名设置为共享域名。
- 共享域名不能是泛域名。
操作步骤
- 登录 veImageX 控制台。
- 选择服务管理 > 基础配置 > 域名 > 配置 > 缓存配置，进入缓存配置页面。
- 单击共享缓存右侧的编辑。
- 打开或关闭状态开关，并单击确认。
打开开关后，可选择一个或多个域名作为共享域名。
注意事项
- 共享域名的旧缓存都将失效，来自这些共享域名的访问，将按当前域名来匹配缓存内容并响应。
- 对于共享域名的请求，veImageX 在缓存中查找文件时，查找的是当前域名下的文件，而非共享域名下的文件。短期内，对于共享域名的请求，缓存命中率可能会下降。
- 在您创建一个共享缓存配置后，共享域名的缓存就失效了。在您删除一个共享缓存配置后，共享域名的缓存需要重建。
- 建议共享域名的源站配置与当前域名相同。如果不相同，可能会出现以下情况：不同源站下存在路径相同，文件名相同，但是更新时间或者内容不相同的文件。基于共享缓存的工作方式，实际被缓存的文件可能会是来自任意的源站，出现用户获得不正确的文件的情况。
- 建议共享域名的缓存键值配置与当前域名相同，以提升缓存命中率。
状态码缓存规则
注意
状态码缓存为白名单功能，请提交工单联系技术支持为您的账号开启配置能力。
如果源站的响应状态码不是 2xx，veImageX 默认不缓存请求的内容。如果另一个用户请求相同的内容时，veImageX 还是会向源站请求改内容。如果您希望在短时间内避免这些回源请求，可以配置状态码缓存，降低源站压力。在配置了状态码缓存后，在您指定的时间内，这些内容的用户请求不会触发回源请求，veImageX 会直接返回相应的状态码。
当前，您只能对 400-599 区间内的状态码配置状态码缓存。
操作步骤
登录 veImageX 控制台。
选择 服务管理 > 基础配置 > 配置 > 缓存配置，进入缓存配置页面。
选择状态码缓存规则配置，单击编辑按钮，参考下表完成缓存规则配置。
配置项
说明
优先级
表示规则的优先级。如果有多条规则，则按优先级来执行规则。您可以通过拖拽调整规则的优先级。
规则类型
选择一个缓存规则的类型。
- 文件后缀：规则应用于特定后缀名的所有文件。
- 目录匹配：规则应用于特定目录下的所有文件。
- 文件全路径匹配：规则应用于特定文件。
规则
根据指定的 规则类型，输入规则的内容。长度不能超过 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。