Nginx完美支持大视频分片请求需同步配置slice、proxy_cache_key含$slice_range、Range头透传三要素,并启用206缓存、cache_lock及Vary头隔离。

要让 Nginx 真正“完美”支持大视频文件的分片(Range)请求并高效缓存,核心不是堆配置,而是理清三个层次:客户端怎么发、Nginx 怎么转、后端怎么回。关键在于避免误解 slice 模块的作用——它不等于“按块缓存”,而是为分片回源服务的代理拆解工具。
先确认基础能力是否全部就位
缺一环,整个链路就会退化成全量回源或 416 错误:
- 检查 Nginx 是否已编译
http_slice_module:运行nginx -V 2>&1 | grep http_slice_module,无输出需重编译并添加--with-http_slice_module - 后端必须原生支持
206 Partial Content,返回带Content-Range: bytes 0-1048575/5242880和Accept-Ranges: bytes头;静态文件服务(如 Nginx 自身托管)、OSS、S3 通常默认支持;自研后端(PHP/Node.js)需手动实现 Range 解析逻辑 -
slice指令只能写在location块内,server或http级别无效 -
proxy_buffering on必须保持开启(注意:这和“大文件缓存要关 buffering”不冲突——slice 依赖 buffering 来组装子响应;而 proxy_cache 的流式透传优化是另一套逻辑)
核心配置三要素必须同步生效
只写 slice 1m 是无效的。以下三项必须同时配置,否则所有分片共用一个缓存项,或无法命中:
- 把 Nginx 生成的切片范围准确透传给后端:
proxy_set_header Range $slice_range; - 让每个分片拥有独立缓存 key:
proxy_cache_key "$uri$is_args$args$slice_range";(漏掉$slice_range就等于没开 slice) - 启用 HTTP/1.1 协议栈并清理连接干扰:
proxy_http_version 1.1;<br>proxy_set_header Connection "";
缓存策略决定实际效果上限
没有缓存,slice 只是把一次大压力变成多次小压力,反而增加延迟和后端负载:
- 显式允许缓存 200 和 206 响应:
proxy_cache_valid 200 206 2h;(必须同时写两个状态码) - 开启缓存锁防止并发穿透:
proxy_cache_lock on;(同一分片的多个请求,只放行一个回源) - 缩短 inactive 时间,避免冷数据长期占满磁盘:
proxy_cache_path /var/cache/nginx/video levels=1:2 keys_zone=video_cache:128m inactive=10m max_size=5g;
(10 分钟无访问即淘汰;128MB keys_zone 支持约 10 万视频分片 key) - 强制添加可缓存标识(绕过后端错误头):
proxy_ignore_headers Cache-Control Expires Set-Cookie;<br>add_header Cache-Control "public, max-age=7200" always;
规避常见陷阱与性能雷区
很多“看似正常”的配置,会在高并发或拖拽场景下引发流量雪崩:
- 禁用 Nginx 自主处理 Range:
proxy_force_ranges off;(否则 Nginx 会拉全量再截取,压垮源站) - 绕过缓存所有含 Range 请求(若你选择透传而非分片缓存):
proxy_cache_bypass $http_range;<br>proxy_no_cache $http_range;
- 务必加 Vary 头隔离缓存维度:
add_header Vary "Range, Origin";(防止不同 Range 请求复用同一缓存体) - 对视频路径做限流防恶意刷片:
limit_req_zone $binary_remote_addr$uri zone=video_slice:10m rate=3r/s;<br>location ~ \.mp4$ { limit_req zone=video_slice burst=5; }


















