SCDN 常用缓存文件后缀
参考常见资源扩展名设置缓存，并验证个性化内容排除、资源更新和实际缓存效果。
本文目录
后缀是识别资源的线索，不代表该类文件都能公开缓存。操作前先判断内容是否公开、是否随登录用户变化，以及多久更新一次。
常用静态文件
.css,.js,.txt,.iso,.img,.exe,.zip,.rar,.7z,.gz,.tar,.apk,.ipa,.dmg,.manifest,.conf,.xml,.cab,.bin,.msi
图片文件
.jpg,.jpeg,.gif,.ico,.png,.bmp,.webp,.psd,.tif,.tiff,.svg,.svgz
常用音视频
.mp3,.flv,.swf,.wma,.wav,.mp4,.mov,.mpeg,.rm,.avi,.wmv,.mkv,.vob,.rmvb,.asf,.mpg,.ogg,.m3u8,.ts,.mid,.midi,.3gp
常用文档与字体
.doc,.pdf,.csv,.ppt,.docx,.xlsx,.xls,.pptx,.ttf,.chm,.woff,.ps,.class,.jar,.woff2
这些是文件类型参考，不是建议全部启用的缓存白名单。配置文件、导出报表、付费下载和私有文档即使命中上述后缀，也可能包含私密信息或要求鉴权，不应被直接加入公共缓存。
网页与动态内容
以下网页文件可能返回动态内容，不宜统一设置公共缓存：
.html,.htm,.php,.json
公开且内容固定的 HTML 或 JSON，可以在明确更新策略后单独评估；登录状态、用户资料、订单、购物车和业务 API 等个性化响应，应明确排除公共缓存。
把类型参考变成实际规则
在 SCDN 控制台 中检查当前网站的缓存字段、匹配语法和规则优先级，再按以下项目配置。
| 需要核对 | 操作要点 |
|---|---|
| 匹配语法 | 先读当前字段提示，确认是否使用扩展名、路径或正则，以及分隔符和前导点要求；不要将上方逗号列表盲目粘贴进其他语法字段 |
| 缓存范围 | 只覆盖确认可公开共享的资源；鉴权下载、用户导出和动态接口单独排除 |
| 缓存时间 | 按发布频率与可接受的旧内容时长设置，记录资源更新后的刷新方式 |
| URL 参数 | 判断参数是否改变内容或权限；会改变内容的参数不能随意忽略 |
| 源站响应头 | 核对 Cache-Control、Vary、Set-Cookie 和实际响应，确认 CDN 规则未覆盖业务要求 |
| 规则优先级 | 检查排除规则是否会被更宽泛的缓存规则覆盖，保存后用真实请求确认 |
对于登录和敏感接口，不要只依赖 URL 后缀，也不要假定携带 Cookie 或 Authorization 就会自动绕过缓存。源站可按业务使用 private、no-store 等策略，CDN 侧也需确认生效。
音视频清单、分片、鉴权链接和分段请求有各自的更新与权限要求，不宜仅凭 .m3u8、.ts、.mp4 后缀套用相同时间。先用播放器验证完整播放、拖动和过期链接行为。
验证缓存是否正确
- 准备三类样本：一个公开静态资源、一个登录后页面或接口、一个使用参数区分内容的资源。
- 重复发起真实请求：对照内容、状态码和响应头；若平台提供缓存记录或命中标识，再结合它们与源站访问日志判断。单次访问更快不能单独证明缓存命中。
- 检查账号隔离：用两个测试账号访问同一路径，确认各自数据正确，再退出登录复测。不要使用真实客户的敏感数据做测试。
- 验证发布更新：更新一个测试资源，执行当前控制台提供的刷新操作或使用新的资源版本地址，再从不同网络检查新内容。
- 记录结果：保存测试时间、URL、规则和结果；如果刷新仍有旧内容，还应分别检查浏览器缓存与其他代理层。
若发现个性化内容被缓存，立即停止相关缓存并进行适当刷新，核查受影响范围，再调整规则重新测试。不要只等待缓存自然过期。
接入和 API 例外见 SCDN 完整接入与排错，日常配置见 CDN 网站管理。无法确认规则时，可携带脱敏后的 URL、响应头和当前实际配置，通过 在线技术支持 核对。