nginx源码安装流媒体或分片传输模块需在编译时显式添加第三方模块（如nginx-rtmp-module支持rtmp/hls直播，nginx-vod-module支持mp4/flv点播切片），官方主线版不内置相关功能；商业版nginx plus则自带ngx_http_hls_module。
Nginx 源码安装时启用流媒体或文件分片传输优化模块，核心在于编译阶段显式添加对应模块，而不是靠默认配置或二进制包。官方 Nginx 主线版本不内置 RTMP、HLS 或点播分片（如 VOD）功能，必须通过第三方模块（如 nginx-rtmp-module、nginx-vod-module）或商业版模块（如 ngx_http_hls_module）扩展。
启用 RTMP 流媒体支持（直播/转封装）
RTMP 是最常用的低延迟推流协议，需依赖开源模块 nginx-rtmp-module：
- 下载 Nginx 源码（例如 1.24.x 或 1.26.x 稳定版）
- 同步下载
nginx-rtmp-module（推荐使用 arut/nginx-rtmp-module 的稳定 tag，避免 master 分支不稳定）
编译命令示例：
./configure \ --add-module=/path/to/nginx-rtmp-module \ --with-http_ssl_module \ --with-http_stub_status_module \ --user=www-data --group=www-data make && make install
✅ 关键点：
-
--add-module必须指向解压后的模块目录（含config文件） - 不要遗漏
--with-http_ssl_module（HTTPS 拉流必需） - 若系统为 CentOS 8+/Ubuntu 22.04+，可能需加
CFLAGS='-Wno-implicit-fallthrough'避免编译报错
配置片段（nginx.conf）：
rtmp {
server {
listen 1935;
application live {
live on;
hls on;
hls_path /var/www/hls;
hls_fragment 5s;
hls_playlist_length 60s;
}
}
}
启用 HLS/DASH 分片点播（VOD）
若需支持 MP4/FLV 文件的 HLS 或 DASH 自动切片（非实时流，而是点播内容），用 nginx-vod-module：
- 该模块需单独下载（nginx-vod-module GitHub）
- 它不依赖 RTMP，而是基于 HTTP 请求动态生成
.m3u8和.ts片段
编译时追加：
./configure \ --add-module=/path/to/nginx-vod-module \ --with-http_ssl_module \ --with-http_realip_module make && make install
配置示例（提供 /vod/ 路径点播）：
location /vod/ {
alias /data/videos/;
vod on;
vod_mode segmented;
vod_segment_duration 4000; # 单位毫秒
vod_hls_playlist_length 3600;
add_header Access-Control-Allow-Origin *;
}
访问 http://your-domain/vod/test.mp4/index.m3u8 即可获得 HLS 清单。
⚠️ 注意：vod 模块要求视频文件为标准 MP4（含 moov 在前）或 FLV；否则切片失败。
启用商业版 HLS 模块（仅限 NGINX Plus）
NGINX Plus 订阅用户可直接使用官方 ngx_http_hls_module：
- 无需手动编译模块，安装 Plus 包后自动启用
- 配置更简洁，支持 DRM 集成、动态加密、多码率自适应等企业级特性
- 对应指令如
hls on、hls_fragment可直接在location块中使用
示例：
location /hls/ {
alias /var/lib/nginx/hls/;
hls on;
hls_fragment 6s;
hls_playlist_length 60s;
}
该路径下需存放已切好的 .ts 文件和 .m3u8 清单（由外部工具如 FFmpeg 生成），模块负责 HTTP 服务与范围请求优化。
通用注意事项
- 所有模块都不能动态加载，必须静态编译进 Nginx 二进制文件
- 编译前务必
make clean清理旧构建产物，避免冲突 -
nginx -V可验证是否成功包含目标模块（输出中应含--add-module=...） - 权限与路径需严格匹配：
hls_path目录需 Nginx worker 进程可写；alias路径需可读 - 防火墙需放行对应端口（RTMP 默认 1935，HTTP 默认 80/443）
不复杂但容易忽略
