流媒体与实时通信 / 系统课时
分片缓存键和过期时间如何配置
分片缓存键和过期时间如何配置
直播 CDN 不能把所有请求按同一种缓存策略处理:播放列表需要短缓存,已完成媒体分片可以长缓存,低延迟部分分片则要更短且避免把不同会话混进同一个缓存键。本篇给出一套可直接落地的缓存键、查询参数和 TTL 配置方法。
学习目标
- 为播放列表、完整分片和低延迟部分分片分别设计缓存键与 TTL。
- 用查询参数白名单避免鉴权参数、追踪参数污染 CDN 缓存。
- 通过响应头和请求验证确认缓存命中、回源和过期行为符合预期。
先把三类对象分开
直播播放请求通常至少包含三种对象:Media Playlist、完整媒体分片,以及 Low-Latency HLS 中的 Partial Segment。它们的更新频率完全不同,TTL 也不能混用。
| 对象 | 示例 | 推荐 TTL | 原因 |
|---|---|---|---|
| 播放列表 | /live/room123/index.m3u8 |
1~3 秒 | 清单持续滑动,缓存过久会让观众看到旧窗口 |
| 完整分片 | /live/room123/seg126.ts |
30~120 秒 | 一旦分片完成,内容通常不再变化 |
| CMAF/fMP4 分片 | /live/room123/seg126.m4s |
30~120 秒 | 完成后的媒体对象可长期复用 |
| Partial Segment | .../seg126.part3.m4s |
0~1 秒 | 低延迟模式下对象可能快速产生,缓存过久会放大延迟 |
最容易出错的是把整个 /live/* 都设成 60 秒。这样 index.m3u8 可能在边缘节点停留 60 秒,观众看到的直播窗口就会明显落后于源站。

缓存键只保留真正影响内容的参数
缓存键的目标是让“内容相同”的请求尽可能复用同一个缓存对象。例如播放 URL 带有 token、utm_source 和 trace_id 时,若所有参数都进入缓存键,同一个分片会被拆成大量缓存副本,命中率迅速下降。
推荐把参数分成两类:真正改变媒体内容或权限结果的参数进入缓存键;只用于鉴权、观测和营销统计的参数不进入缓存键,但必须在边缘鉴权逻辑中单独处理。
常见规则可以直接按下面执行:
- 路径
/live/room123/seg126.ts作为核心键。 format、track、variant这类会改变响应内容的参数保留。utm_source、utm_campaign、trace_id不进入缓存键。- 带签名 URL 时,不能简单地删除签名参数后就允许公共缓存;应先完成鉴权,再依据业务规则决定是否共享缓存对象。
例如两次请求只有 trace_id 不同:
/live/room123/seg126.ts?trace_id=A1
/live/room123/seg126.ts?trace_id=B7
如果 trace_id 不影响媒体内容,它们应该映射到同一个缓存键。反过来,variant=1080p 与 variant=720p 必须使用不同缓存键,否则会把 1080p 内容错误返回给 720p 请求。
用反向代理验证 TTL 和缓存键
下面的 Nginx 配置可以作为 CDN 边缘缓存策略的本地验证模型。它把播放列表缓存 2 秒,把完整媒体分片缓存 60 秒,并只让 variant 进入缓存键;真实 CDN 控制台中应按相同原则配置对应的 Cache Key 和 TTL。
http {
proxy_cache_path /var/cache/nginx/live levels=1:2 keys_zone=live_cache:20m max_size=2g inactive=120s use_temp_path=off;
server {
listen 8080;
server_name _;
location ~ \\.m3u8$ {
proxy_pass http://origin;
proxy_cache live_cache;
proxy_cache_valid 200 2s;
proxy_cache_key "$scheme://$host$uri?variant=$arg_variant";
add_header X-Cache-TTL "playlist-2s" always;
add_header X-Cache-Status $upstream_cache_status always;
}
location ~ \\.(ts|m4s)$ {
proxy_pass http://origin;
proxy_cache live_cache;
proxy_cache_valid 200 60s;
proxy_cache_key "$scheme://$host$uri?variant=$arg_variant";
add_header X-Cache-TTL "segment-60s" always;
add_header X-Cache-Status $upstream_cache_status always;
}
}
}预期结果
nginx -t
syntax is ok
test is successful这里的关键不是照抄 60s,而是验证三个行为:相同路径加不同 trace_id 时仍可复用缓存;不同 variant 时必须分开;播放列表在约 2 秒后允许重新回源。Nginx 只是验证模型,生产 CDN 应将同样的规则落到其 Cache Policy、Cache Key 和 TTL 配置上。
低延迟分片要防止旧对象滞留
LL-HLS 的 Partial Segment 生命周期很短。假设目标端到端延迟约 2 秒、一个完整分片时长为 2 秒、一个分片再切成 4 个 Partial Segment,则每个 Partial Segment 理论上只覆盖约 0.5 秒媒体数据。此时把 Part 缓存 10 秒,就可能让边缘节点继续返回已经落后的 Part。
配置时可以采用以下起点:完整分片 30~60 秒,Partial Segment 0~1 秒,播放列表 1~2 秒。当播放器存在高并发、多个 CDN 节点和回源保护要求时,再通过 stale-while-revalidate 或厂商等价机制降低回源峰值,而不是简单提高主 TTL。
尤其要注意查询参数中的时间戳。若播放器每次请求都生成不同的 ?_HLS_msn=...、?_HLS_part=...,这些参数可能本身就是定位直播窗口所必需的;此时不能像 utm_* 一样全部忽略,否则请求会落到错误的媒体对象。
用响应头检查是否配置正确
验证时不要只看播放器“有没有画面”,要直接看 CDN 返回的缓存状态。准备同一个已完成分片,连续发起两次请求;第二次应出现命中或厂商等价状态,同时命中的对象必须与第一次内容一致。
curl -I "https://<CDN_HOST>/live/room123/seg126.ts?variant=720p&trace_id=A1"
curl -I "https://<CDN_HOST>/live/room123/seg126.ts?variant=720p&trace_id=B7"
curl -I "https://<CDN_HOST>/live/room123/index.m3u8?variant=720p"预期结果
HTTP/2 200
X-Cache-Status: MISS
X-Cache-TTL: segment-60s
HTTP/2 200
X-Cache-Status: HIT
X-Cache-TTL: segment-60s
HTTP/2 200
X-Cache-Status: MISS
X-Cache-TTL: playlist-2s实际 CDN 的命中头名称可能不同,例如使用 Age、X-Cache 或厂商自定义字段;判断标准不变:同一缓存键的第二次请求应复用已完成对象,而播放列表经过 TTL 后能够重新获取最新窗口。
最实用的一条配置原则是“让对象的 TTL 不超过它允许产生陈旧数据的时间尺度”:播放列表按秒级刷新,完整分片按几十秒缓存,Partial Segment 按接近实时的秒级甚至不缓存处理;同时只把真正影响内容的查询参数放进缓存键。这样既能提高 CDN 命中率,也不会因为缓存把直播时间轴拖旧。