静态 MP4 和 WebM 的基础 Nginx 配置

如果视频可以播放但无法拖动进度，通常是 Range 响应或 MP4 文件结构存在问题；如果首次打开缓慢，常见原因是源站磁盘、网络带宽、视频编码参数或缓存未命中，而不是单独增加某一条 Nginx 指令。下面的配置以静态视频分发为主，改动前应确认 Nginx 版本、编译模块和当前 server 配置。

视频缓存时间应与文件命名方式一起设计。文件名带版本号或内容指纹时，可以设置较长的 max-age；文件内容会被原地覆盖时，不宜设置过长的公共缓存，否则用户可能持续拿到旧视频。受权限保护的视频不应直接套用 public 缓存，应改为私有缓存、短时签名或由应用层完成鉴权后再分发。

HLS视频分发应把播放列表和媒体分片分开处理，因为 m3u8 反映实时播放状态，ts 或 fMP4 分片通常生成后不再变化。播放列表适合短缓存或不缓存，已经发布完成的分片可以设置较长缓存，但直播场景必🎆须根据分片更新周期调整策略。

HLS 分发与普通 MP4 不应使用同一套缓存规则

稳定的视频分发配置通常是“正确响应头、可用 Range、合适缓存、可靠文件结构和明确权限”的组合，而不是把所有性能指令全部打开。完成每项调整后，应通过真实浏览器拖动、暂停后继续播放、切换网络和并发下载测试验证结果；当源站带宽或磁盘已经饱和时，应先扩容存储与分发能力，再继续微调 Nginx 参数。

上线前的性能与安全检查

Nginx视频快进故障需要区分静态文件、反向代理和媒体本身三个层面，不能只修改 sendfile。播放器拖动到视频中段后，可以重点观察以下现象：

MP4 文件结构和视频编码同样影响首播速度

MP4 点播速度不只取决于 Nginx，moov 元数据的位置、视频码率、关键帧间隔和音视频编码参数都会影响首帧加载与拖动定位。若 moov 位于文件末尾，播放器往往需要读取较多内容后才能开始播放，服务器开启 sendfile 也不能改变文件内部结构。

Range 快进失败时，按响应结果定位问题

视频服务是否真正支持快进，应在🔍浏览器开发者工具的 Network 面板中查看请求状态、Accept-Ranges、Content-Range 和 Content-Length。只看到 200 并不一定代表错误，但当播放器发起带 Range 的请求后仍始终返回完整文件，快进和断点续🍀传通常会受到影响。

视频文件被替换时，发布流程应采用临时文件写入、校验完成后原子改名的方式。直接覆盖正在被读取的大文件，可能让客户端拿到前后内容长度不一致的文件，从而引发 416、解码失败或缓存污染。

Nginx视频上线检查应同时覆盖速度、稳定性和权限，单纯看到播放按钮能启▶️动并不能证明配置合格。