如何通过 flv 模块实现流媒体视频的伪流发送与播放优化实战-Nginx-PHP中文网

nginx通过ngx_http_flv_module实现flv伪流，本质是按start=字节偏移参数返回文件对应位置后的数据；需编译启用该模块、flv文件注入关键帧metadata、前端用flv.js配置islive:false与accurateseek:true。

如何通过 flv 模块实现流媒体视频的伪流发送与播放优化实战

直接用 Nginx 的 ngx_http_flv_module 实现 FLV 伪流（即支持拖拽播放的 HTTP 分段下载），本质是让服务器按请求中的 start=秒数 参数，精准定位并返回 FLV 文件中对应时间点之后的数据。它不涉及实时推流或协议转换，而是对静态 FLV 文件做“字节偏移响应”。要真正跑通并优化体验，需同时满足服务端配置、文件准备、前端适配三个条件。

服务端：Nginx 启用 flv 模块并正确路由

Nginx 必须已编译包含 --with-http_flv_module（主流发行版如 Ubuntu 的 nginx-full 默认启用）。在 server 块中添加如下 location 配置：

匹配以 .flv 结尾的请求，并启用 flv 指令，这是开启伪流解析的核心
设置 expires 1h 或更长，避免浏览器反复请求头信息，提升缓存效率
确保该 location 不被其他 rewrite 或 proxy_pass 覆盖，否则 flv 指令失效

示例配置：

location ~ \.flv$ {
    flv;
    expires 1h;
    add_header Cache-Control "public";
}

视频文件：必须含关键帧索引（metadata）

原始转码生成的 FLV 文件通常不含时间戳索引，导致 start 参数无法准确定位——拖动后可能卡顿、黑屏或跳到错误位置。需用工具注入 metadata：

推荐使用 yamdi：速度快、兼容性好，命令为 yamdi -i input.flv -o output.flv
也可用 flvtool2，但处理大文件较慢
验证是否成功：用 ffprobe output.flv 查看输出中是否有 duration 和 metadata 字段

前端播放：用 flv.js 支持点播与拖拽

浏览器原生不支持 FLV，必须依赖 flv.js 解析并转封装为 MSE 可接受的 fMP4。针对伪流点播场景，关键配置如下：

isLive: false：明确告知播放器这是点播，启用 seek 行为
accurateSeek: true：开启精确寻址，配合服务端的 start 参数生效
enableStashBuffer: true：开启缓冲区，保障拖动后快速续播
URL 中直接带 ?start=120 参数（如 video.flv?start=120），flv.js 会自动识别并触发 Range 请求

代码片段示例：

const player = flvjs.createPlayer({
  type: 'flv',
  url: 'https://cdn.example.com/demo.flv?start=60',
  isLive: false,
  hasAudio: true,
  hasVideo: true,
  accurateSeek: true,
  enableStashBuffer: true,
});

常见问题与绕过技巧

若遇到拖动无效、加载缓慢或 404 错误，可逐项排查：

检查 Nginx error log，确认是否提示 flv module not found —— 说明模块未启用
用 curl 测试：curl -I "http://host/video.flv?start=30"，看响应头是否含 Content-Range 和状态码 206
浏览器 Network 面板中查看 .flv 请求的 Request URL 是否携带 start，Response 是否返回部分数据
旧版 IE 或 Safari 10 以下不支持 MSE，需降级为 Flash 或改用 MP4 + <video></video> 原生方案