tencent cloud

内容分发网络 CDN

动态与公告
产品动态
公告
新手指引
产品简介
产品概述
产品优势
应用场景
基本概念
使用限制
CDN性能说明(抽样)
购买指南
CDN 购买指南
ECDN 购买指南
快速入门
从零开始配置 CDN
接入域名
配置 CNAME
域名归属权验证
域名接入常见问题
配置指南
域名管理
域名配置
统计分析
刷新预热
日志服务
安全加速
服务查询
离线缓存
权限管理
权限配置
控制台权限说明
子账号或协作者开通实时日志的方法
场景教学
CDN 加速 COS 资源
实践教程
CDN 迁移至 EdgeOne 工具使用指南
CDN - CVM
CDN - COS
DNSPod 一键配置 CNAME
CDN日志定时存储
API 文档
History
Introduction
API Category
Content Management APIs
Real-time Log APIs
Service Query APIs
Data Query APIs
Making API Requests
Log Query APIs
StopCdnDomain
Configuration Management APIs
Obsoleted APIs
Other APIs
Data Types
Error Codes
常见问题
功能特性问题
计费相关问题
域名接入问题
缓存配置问题
刷新预热问题
统计分析问题
HTTPS 相关问题
访问相关问题
故障相关问题
故障处理
状态码说明及处理建议
不同节点缓存内容不一致
接入 CDN 后,网页访问速度慢
流量命中率偏低
CDN 域名突然出现404状态
页面展示异常-访问跨域报错
资源缓存未生效
CDN Service Level Agreement
词汇表

缓存键规则配置

PDF
聚焦模式
字号
最后更新时间: 2024-12-31 11:29:35

配置场景

腾讯云 CDN 在进行缓存时使用的是 Key-Value 格式进行资源映射,其中的 Key 即缓存键,是缓存资源的唯一标识。您可通过缓存键规则配置,对不同文件类型的内容配置过滤参数和忽略大小写来进行缓存键优化。

过滤参数

用户通过 URL 进行资源访问时,可能会携带一些具有特殊作用的参数,如使用以下链接来表示两张不同的图片: http://cloud.tencent.com/1.jpg?version=1http://cloud.tencent.com/1.jpg?version=2 这种场景下需要关闭过滤参数,由完整的 URL 作为缓存键,分别进行图片内容的缓存,来进行资源区分。
在音视频场景下,若使用时间戳签名参数来进行访问认证: http://cloud.tencent.com/1.mp4?sign=XXXXXX 这种场景下需要开启过滤参数,由“?”之前的链接http://cloud.tencent.com/1.mp4作为缓存键。节点仅缓存一份资源,即使时间戳签名不断变化,通过签名校验后可直接命中缓存。

忽略大小写

若在您的业务场景下,资源 URL 路径中大小写差异与资源内容有关,则可关闭忽略大小写配置; 若在您的业务场景下,资源 URL 路径中大小写差异与资源内容无关,则可开启忽略大小写配置,提升命中率。
注意:
平台升级中,暂不支持开启忽略大小写。

配置指南

查看配置

登录 CDN 控制台,在左侧菜单栏选择【域名管理】,单击域名操作列的【管理】,进入域名配置页面,切换Tab至【缓存配置】,即可找到【缓存键规则配置】。
添加加速域名时,根据不同的业务类型,过滤参数默认关闭或开启:
若加速域名选择静态加速业务类型,默认不开启过滤参数。缓存键规则配置中,全部文件规则的【过滤参数】同步为“不过滤”。
若加速域名选择下载、流媒体点播业务类型,默认开启过滤参数。缓存键规则配置中,全部文件规则的【过滤参数】同步为“全部过滤”。




新增规则

您可按需添加缓存键规则。



配置约束

单个域名至多可添加20条缓存键规则(包含默认规则)。
多条规则支持调整优先级:底部优先级大于顶部(默认规则不可调整优先级)。
单条文件类型/文件夹/全路径文件规则中,至多可输入100组内容,不同内容之间用“;”分隔。例如:文件类型 - jpg;png。
过滤参数 - 保留指定参数
全部文件:至多可填6个参数名,每个参数名不可超过20个字符。
文件类型/文件夹/全路径文件:至多可填5个参数名,每个参数名不可超过20个字符。 多个参数名之间用“;”分隔,例如:key1;key2;key3。

修改规则

对已添加的缓存键规则,可进行修改。单击缓存键规则操作列的【修改】即可。
注意:
默认规则仅支持修改过滤参数和忽略大小写配置,不支持修改类型和内容。

删除规则

可删除已添加的缓存键规则。单击缓存键规则操作列的【删除】即可。(默认规则不可删除)

配置示例

若加速域名www.test.com的【缓存键规则配置】如下:


则实际访问情况如下:
客户端请求资源www.test.com/abc.jpg?version=1&colour=redwww.test.com/abc.JPG?version=1&colour=red,假设请求均访问到 CDN 节点 X,节点 X 无上述两个资源的缓存:
请求回源站获取abc.jpg图片资源,并缓存在 CDN 节点 X 上,因已开启过滤参数:全部过滤,则由“?”之前的链接www.test.com/abc.jpg作为缓存键。
当客户端请求www.test.com/abc.JPG?version=1&colour=red时,因忽略大小写未开启,则无法命中之前缓存的www.test.com/abc.jpg资源,请求回源站获取abc.JPG图片资源,并缓存在 CDN 节点 X 上,其对应的缓存键为www.test.com/abc.JPG

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈