在 nginx 源码中启用 mp4 伪流媒体支持，需要在编译时通过 --with-http_mp4_module 参数加载该模块。默认情况下，nginx 不包含此模块，必须显式指定。配置完成后，需在 nginx.conf 中使用 mp4 指令开启功能，并配合 mp4_buffer_size 等参数调整缓冲行为，即可实现基于 http get 请求的 mp4 视频片段传输。
如何编译安装带 MP4 模块的 Nginx
要获得支持 MP4 伪流媒体的 Nginx，必须在源码配置阶段添加 --with-http_mp4_module。这一步是基础，没有它后续的配置均无效。执行 ./configure 后，使用 make 和 make install 完成安装。安装后的二进制文件将包含处理 MP4 文件的逻辑。
cd /path/to/nginx-source ./configure --prefix=/usr/local/nginx --with-http_mp4_module make make install
上述命令序列展示了标准的编译流程。关键点是 --with-http_mp4_module 参数。如果省略该参数，编译出的 Nginx 将无法识别 mp4 指令，导致配置文件加载失败或请求被当作普通静态文件处理。编译成功后，生成的 nginx 二进制文件即具备解析 MP4 元数据的能力。
MP4 模块的核心配置与工作原理
启用模块后，需在服务器块或位置块中配置 mp4 指令。该指令告诉 Nginx 对匹配的文件进行特殊处理：解析 MP4 的 moov 原子（atom），并根据客户端请求的字节范围（Range Header）返回相应的视频片段。这种机制允许播放器在不下载完整文件的情况下开始播放，即“伪流”。
server {
listen 80;
server_name example.com;
location /videos/ {
root /var/www/html;
mp4;
mp4_buffer_size 1m;
mp4_max_buffer_size 5m;
}
}
配置示例中，location /videos/ 指定了视频文件的路径。mp4; 指令激活处理逻辑。mp4_buffer_size 设置初始缓冲大小，默认为 1MB。mp4_max_buffer_size 限制最大缓冲，防止内存占用过高。当客户端发送带有 Range: bytes=0-1023 的请求时，Nginx 会定位到对应的 mdat 原子并返回数据，而非整个文件。若未配置 mp4 指令，Nginx 将直接返回完整的 MP4 文件，无法实现流式播放。
MP4 文件结构对伪流的支持要求
Nginx 的 MP4 模块依赖于 MP4 文件的内部结构。MP4 文件由多个原子（atoms）组成，其中 moov 原子包含索引信息，mdat 原子包含实际媒体数据。为了实现伪流，moov 原子必须位于文件头部附近。如果 moov 原子位于文件末尾（常见于某些录制设备生成的文件），Nginx 无法快速建立索引，导致播放延迟或失败。
# 检查 MP4 文件结构 mp4dump video.mp4 | grep -E "moov|mdat"
上述命令可用于验证 MP4 文件的结构。输出应显示 moov 原子在 mdat 之前。如果 moov 在后，需使用工具如 qt-faststart 或 MP4Box 重新排列原子顺序。例如：MP4Box -ft mov video.mp4 可将 moov 移至头部。未经优化的 MP4 文件在 Nginx 下可能表现为无法播放或卡顿，因为 Nginx 需要读取 moov 才能计算字节范围对应的数据偏移。因此，确保文件结构正确是伪流功能生效的前提条件。
