tencent cloud

文档反馈

缓存键(Cache Key)介绍

最后更新时间:2023-08-07 16:30:42

    什么是缓存键(Cache Key)

    缓存键(Cache Key)用于决定用户访问的文件资源是否命中 EdgeOne 边缘缓存内容,是节点内缓存资源的唯一标识。缓存命中可以帮助您的站点:
    减少回源请求量,降低源站带宽消耗。
    提高用户的访问请求速度。
    缓存键的工作原理如下所示:
    当文件被缓存到 EdgeOne 边缘节点中时,节点将根据缓存键规则来为文件生成一个对应的缓存键标识,默认情况下,缓存键通过客户端请求 URL 和查询字符串计算得出。当有其它客户端向该边缘节点发起 HTTP 请求时,节点将根据 Cache Key 的计算规则,来比对该 HTTP 请求与节点内所有缓存资源的缓存键(Cache Key)是否一致,如果一致时,则将对应的缓存资源直接响应给该客户端,即缓存命中。
    

    缓存键(Cache Key)的作用场景

    缓存键(Cache Key)用于 EdgeOne 节点为不同版本的文件建立多版本缓存内容,即使客户端通过同一路径请求,也可以通过缓存键(Cache Key)的计算规则来正确响应用户文件。
    
    您可以通过以下场景示例来了解如何正确配置 Cache Key 来帮助您正确匹配请求的缓存文件,同时降低请求的回源率。
    例如:用户 A 和用户 B 分别有以下请求:
    请求 A:https://www.example.com/Image/test.jpg?version=1&time=1651752743
    请求 B:https://www.example.com/Image/test.jpg?version=2&time=1651758319
    场景一:用户访问的文件路径完全相同,但是根据查询字符串内携带的version参数不同,将会有版本的区分,以上请求分别为两张不同的图片,此时应在 Cache Key 中保留会影响文件版本的参数version,来保证节点能正确缓存并响应对应的文件内容。
    场景二:用户访问的 URL 中查询字符串的内容完全不影响文件内容,以上请求所对应的文件一致,不影响文件版本,此时应该在 Cache Key 计算中忽略所有查询字符串,来提高文件在节点内的命中率,减少请求回源。

    允许自定义的 Cache Key 内容及生效规则

    EdgeOne 允许用户自定义 Cache Key 规则,支持配置查询字符串、HTTP 请求头或者 cookie 进行区分缓存。您可以通过 自定义 Cache Key 来了解如何配置自定义的 Cache Key 规则。
    注意:
    1. 缓存键计算以客户端向节点发起的 HTTP 请求内容为准,回源 URL 改写、回源跟随重定向、回源 HTTP 请求头、访问 URL 重写均不影响缓存键的计算。
    2. 当在 EdgeOne 内配置了 Token 鉴权时,鉴权内容不会参与至缓存键计算中。
    3. 当在 EdgeOne 内开启了图片处理参数,请求中携带的图片处理参数将默认参与 Cache Key 计算。

    查询字符串

    查询字符串是指请求 URL 中 ? 之后的字符串参数(包含一个或多个参数,用 &分隔),例如:https://www.example.com/images/example.jpg?color=blue&size=large 中的 color=blue&size=large
    
    EdgeOne 支持自定义保留指定查询字符串的内容来区分缓存。
    注意:
    当保留查询字符串作为缓存键时,如果参数的位置顺序发生变化,缓存键也会变化。
    例如:当客户端分别发起以下请求:
    请求 A:https://www.example.com/Image/test.jpg?version=1&type=a
    请求 B:https://www.example.com/Image/test.jpg?version=2&type=a
    请求 C:https://www.example.com/Image/test.jpg?type=a&version=1
    配置
    缓存行为
    查询字符串配置为全部保留
    请求 A 和请求 B 所携带参数内容不同,对应不同的缓存版本,请求 A 和请求 C 参数内容一致,但是顺序不同,也对应不同的缓存版本。
    查询字符串配置为全部忽略
    请求 A、B、C 均对应同一份缓存版本。
    查询字符串配置为保留指定参数 Type
    请求 A、B 的参数顺序及内容完全一致,对应同一份缓存版本;请求 B 和请求 C 的 参数内容相同,但是顺序不同,对应不同的缓存版本。
    查询字符串配置为忽略指定参数 Type
    请求 A 和请求 B 剩余参数的内容不一致,对应不同的缓存版本;请求 A 和请求 C 剩余参数的内容一致,但是顺序不一致,对应不同的缓存版本。

    HTTP 请求头

    EdgeOne 支持将指定的 HTTP 请求头加入缓存键 Cache Key 的计算中,EdgeOne 边缘节点将根据请求头内容来建立不同的缓存版本。请求头的顺序变化,不影响 Cache Key的计算。
    例如:指定HTTP请求头 User-Agent 加入缓存键计算中,以下请求 A 与请求 B 的 URL 及参数内容一致,但是 User-Agent 头内容不一致,将对应不同的缓存版本。
    请求 A:https://www.example.com/Image/test.jpg?version=1&type=a,携带 User-Agent:chrome
    请求 B:https://www.example.com/Image/test.jpg?version=1&type=a,携带 User-Agent:ios

    Cookie

    EdgeOne 支持将指定的 Cookie 内参数加入到缓存键的计算中,根据 Cookie 参数及内容区分缓存版本。Cookie 内多个参数参与 Cache Key 计算时,参数的顺序变化不影响 Cache Key 的计算。
    例如:指定 Cookie 内参数 User 加入缓存键计算中,以下请求 A 和请求 B 参数内容相同,对应同一份缓存,请求 A 与请求 C 参数内容不同,对应不同版本的缓存。
    请求 A:https://www.example.com/Image/test.jpg?version=1&type=a,携带 Cookie:User=A;ID=1
    请求 B:https://www.example.com/Image/test.jpg?version=1&type=a,携带 Cookie:User=A;ID=2
    请求 C:https://www.example.com/Image/test.jpg?version=1&type=a,携带 Cookie:User=B;ID=1

    了解更多

    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持