当前位置：首页 > news >正文

nginx-rtmp-module：从编译到推流成功，一篇就够

news 2026/8/21 21:29:04

【免费下载链接】nginx-rtmp-moduleNGINX-based Media Streaming Server项目地址: https://gitcode.com/gh_mirrors/ng/nginx-rtmp-module

nginx-rtmp-module 把 RTMP（实时流媒体传输协议）直播能力塞进 Nginx。这篇文章带你从零完成安装、配置到部署，终点是推出一路真流并拉下来验证。

读完你会完成三件事：把模块编进 Nginx 二进制、让最小 RTMP 配置跑起来、用三条命令确认推流真的通了。

Step 1 拿到模块代码

git clone https://gitcode.com/gh_mirrors/ng/nginx-rtmp-module

它是 Nginx 的扩展，单独跑不起来。源码都在仓库根目录，构建脚本是同目录下的 config 文件。

Step 2 拿 Nginx 源码和依赖

下载一份 Nginx 官方源码解压，模块必须跟着 Nginx 源码一起编。先装好 pcre、zlib、openssl 的开发包，这是编译机上最常缺的三个。

缺依赖，configure 当场报错。

Step 3 编译并安装

cd nginx-1.25.x ./configure --add-module=/path/to/nginx-rtmp-module make && sudo make install

加这个参数，模块才会编进二进制。老版本 nginx（1.3.14–1.5.0）还要再带上--with-http_ssl_module。

验证安装成功：跑nginx -V 2>&1 | grep rtmp，输出里能看到--add-module=...nginx-rtmp-module就说明编进去了。

打开主配置（一般在 conf/nginx.conf），总共加两个块，多的一行都不用写。

块 1：RTMP 监听

rtmp { server { listen 1935; application myapp { live on; } } }

这段让 nginx 在 1935（RTMP 默认端口）上接推流，application myapp表示地址形如 rtmp://主机/myapp/流名的流都归它管，live on打开直播转发。

必须核对两个值：1935 端口（被别的进程占了就换），以及 myapp（它会成为流地址的一部分，起名好记点）。

⚠️rtmp {}是顶层块，不能塞进http {}里面，这是最常见的配错姿势。

块 2：统计页

http { server { listen 8080; location /stat { rtmp_stat all; } } }

rtmp_stat all会把当前所有在线流和会话信息以 XML 吐到 /stat，不用 SSH 就能看有没有人在推。

8080 是随便选的，跟后面验证命令对上就行。

⚠️ 改完配置先nginx -t，看到 syntax ok 再sudo nginx -s reload。

先本地推一路测试流（随便找个视频文件）：ffmpeg -re -i input.mp4 -f flv rtmp://localhost/myapp/mystream

然后依次验证：

sudo ss -lnt | grep -E ':(1935|8080) ' curl -s localhost:8080/stat | head ffplay rtmp://localhost/myapp/mystream

ss 里 1935 和 8080 都应是 LISTEN 状态；推流时 /stat 返回的 XML 里能看到 mystream 这个流名；ffplay 弹出窗口开始播画面，说明整条链路通了。

仓库 test/www 下自带测试播放页，推流成功后打开就能看到画面：

两个高频报错：

bind() ... 1935 failed (98: Address already in use)：端口被占，用sudo ss -lntp | grep 1935找到占用者，或者换 listen 端口。
unknown directive "rtmp"：模块没编进二进制，回去检查 configure 是否带了 --add-module，重新编译安装。