边缘安全加速：按标签刷新缓存

功能特点

按标签刷新缓存特别适用于批量清除相互关联的缓存资源，能大幅简化管理并提升效率。其优点包含以下几个方面：

• 高效批量操作：当业务中存在大量相互关联的资源（如一个新闻专题页包含数百张图片、多个JS/CSS文件），只需为它们打上相同标签，即可一键刷新整个集合。

• 提升运维效率：运维或开发人员无需精确知道每个资源的完整URL，只需关注逻辑分组（标签），可以大幅减少操作复杂度，还能避免漏刷某个URL。

• 增强业务灵活性：同一个应用内，可以给不同的业务场景设置不同的标签，按标签刷新缓存仅刷新指定业务场景的缓存（例如某个促销活动页面），不影响其他业务场景的内容。

• 提升用户体验一致性：确保高度依赖的资源（如前端页面+配套静态资源）能够同步更新，避免出现“新页面+旧样式”或“部分数据过期”的不一致状态。

适用场景

常见的使用场景包括：

• 电商大促活动页面及关联素材更新

• 新闻/媒体网站的专题内容下线

• 多语言或多版本站点的内容切换

• 微前端架构中子应用资源的统一刷新。

功能原理

ESA使用HTTP协议的标头作为缓存标签。缓存标签包含冒号:分隔的标头名和标头值，例如Cache-Tag:tag1,tag2,tag3。当您提交按标签刷新缓存任务后：

1. ESA首先会判断节点上的缓存文件是否被标记了缓存标签（默认为Cache-Tag），若不存在则不会执行刷新操作，若存在则对缓存标签值进行匹配；

2. 判断缓存文件上标记的缓存标签值是否与您提交的刷新内容匹配，如不匹配则不会执行刷新操作，若匹配则会执行缓存刷新操作（默认为标记过期）。

前提条件

ESA的按标签刷新缓存功能是通过判断ESA节点上的缓存内容中是否包含特定缓存标签进行实现的，因此在使用该功能时您必须在源站给资源设置缓存标签对应的响应标头，可以参考以下配置方法：

# /etc/nginx/nginx.conf

server {
    listen 80;
    server_name your-origin-domain.com;
    # 为 /images/ 目录下的所有资源添加标签
    location /images/ {
        add_header Cache-Tag "images";
        # ... 其他配置
    }
    # ... 其他 location 配置
}

操作步骤

1. 在ESA控制台选择站点管理，在站点列单击目标站点。

2. 在左侧导航栏，选择缓存 > 刷新缓存。

3. 选择刷新缓存页签，配置刷新规则后提交：

   • 刷新类型：选择标签。

   • 刷新方法：支持标记过期和直接删除两种方法。

     刷新方法	说明
     标记过期	如果用户请求的内容匹配到了待刷新的资源，ESA节点将会先回源获取资源的Last-Modified信息。若与当前缓存资源一致，则直接返回已缓存资源；若不一致，则回源拉取新资源返回给用户，并重新缓存该资源。
     直接删除	如果用户请求的内容匹配到了待刷新的资源，ESA节点将会直接回源拉取新资源返回给用户，并重新缓存该资源。

   • 刷新内容：在输入框中输入待刷新的标签值（支持多个值，可用,分隔），如images。

   

4. 提交刷新任务后，您可以在刷新记录页签中查看资源刷新的详细记录和进度。刷新进度为100%，表示刷新任务执行完成。刷新数量多会影响刷新进度，请您耐心等待。

   

缓存刷新示例

电商网站在更新图片或者页面文件的时候，需要删除图片/文件并且清除对应的ESA缓存。由于电商网站图片的裁切图尺寸很多，删除图片的时候枚举所有裁切图尺寸是一件很不方便的事情，因此可以按图片名称批量删除图片文件以及ESA缓存；另外，在电商网站准备促销活动的时候，在开发活动页面的时候，需要持续迭代活动页面，在发布新版活动页面的同时，可以按指定的版本删除活动页面相关的所有文件及ESA缓存。通过按标签刷新缓存，可以显著提升缓存管理效率：

缓存标签说明

不同套餐的支持情况