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

Ubuntu/Debian 搭建 Nginx RTMP 服务器全攻略

news 2025/8/2 7:16:53

Ubuntu/Debian 搭建 Nginx RTMP 服务器全攻略

    • 一. 安装依赖 （Ubuntu/Debian 系统）
    • 二. 配置安装Nginx 安装 nginx-rtmp-module 模块
    • 三. 实现 RTMP 推流的关键步骤：
      • 配置文件结构解析
    • 四. 启动Nginx时的权限问题
    • 五. 安装配置 FFmpeg
    • 六. 推流-拉流测试
      • 使用 OBS Studio、FFmpeg 等工具推流到 Nginx 服务器：
      • 使用 VLC 或其他 RTMP 客户端拉流：
    • 七. 自启动Nginx

Nginx 本身并不原生支持 RTMP 推流功能。Nginx 是一个高性能的 HTTP 和反向代理服务器，默认情况下主要用于处理 HTTP请求。要实现 RTMP（实时消息传输协议）的推流和拉流功能，需要通过 第三方模块 扩展 Nginx 的能力。

RTMP 是一种用于低延迟实时音视频传输的协议，其处理逻辑与 HTTP 不同。Nginx 本身并未内置 RTMP 协议的支持，因此需要通过nginx-rtmp-module 这样的第三方模块来实现 RTMP 功能。

一. 安装依赖 （Ubuntu/Debian 系统）

  1. 安装 C 编译器和依赖库
# 安装 GCC、G++ 和编译 Nginx 所需的依赖库
sudo apt update
sudo apt install -y build-essential gcc g++ make
  1. 验证编译器是否安装成功
    安装完成后，检查 GCC 和 G++ 是否可用：
gcc --version
g++ --version
  1. 安装 PCRE 依赖库
    Nginx 的 HTTP 重写模块（–with-http_rewrite_module）需要 PCRE 库支持。
sudo apt install -y libpcre3 libpcre3-dev
  1. 安装 OpenSSL 依赖
sudo apt install -y openssl libssl-dev
  1. 安装 zlib 依赖
sudo apt install -y zlib1g zlib1g-dev

二. 配置安装Nginx 安装 nginx-rtmp-module 模块

  1. 安装 nginx与nginx-rtmp-module 模块
    源码编译安装（推荐）：
# 下载 Nginx 源码和模块源码
wget https://nginx.org/download/nginx-1.26.0.tar.gz
wget https://github.com/arut/nginx-rtmp-module/archive/refs/tags/v1.2.2.tar.gz# 解压源码
tar -zxvf nginx-1.26.0.tar.gz
tar -zxvf v1.2.2.tar.gz# 进入 Nginx 源码目录，配置编译选项
cd nginx-1.26.0
./configure --add-module=../nginx-rtmp-module-1.2.2 --with-http_ssl_module# 编译并安装 Nginx
# 在配置成功后，需要执行以下命令完成编译和安装：
make
sudo make install
  1. 提示：安装成功
Configuration summary+ using system PCRE library+ using system OpenSSL library+ using system zlib librarynginx path prefix: "/usr/local/nginx"nginx binary file: "/usr/local/nginx/sbin/nginx"nginx modules path: "/usr/local/nginx/modules"nginx configuration prefix: "/usr/local/nginx/conf"nginx configuration file: "/usr/local/nginx/conf/nginx.conf"nginx pid file: "/usr/local/nginx/logs/nginx.pid"nginx error log file: "/usr/local/nginx/logs/error.log"nginx http access log file: "/usr/local/nginx/logs/access.log"nginx http client request body temporary files: "client_body_temp"nginx http proxy temporary files: "proxy_temp"nginx http fastcgi temporary files: "fastcgi_temp"nginx http uwsgi temporary files: "uwsgi_temp"nginx http scgi temporary files: "scgi_temp"

依赖库已正确使用：
PCRE、OpenSSL、zlib 三个依赖库均使用系统自带版本（using system）。
Nginx 安装路径：
安装目录为 /usr/local/nginx，包含二进制文件、配置文件、日志目录等。

  1. 查看 Nginx 版本和模块信息是否生效
/usr/local/nginx/sbin/nginx -V

# 输出信息
wlj@wlj-virtual:~$ /usr/local/nginx/sbin/nginx -V
nginx version: nginx/1.26.0
built by gcc 11.4.0 (Ubuntu 11.4.0-1ubuntu1~22.04) 
built with OpenSSL 3.0.2 15 Mar 2022
TLS SNI support enabled
configure arguments: --add-module=../nginx-rtmp-module-1.2.2

三. 实现 RTMP 推流的关键步骤：

  1. 配置 Nginx 的 RTMP 模块 / 配置RTMP服务
    编辑 Nginx 配置文件 /usr/local/nginx/conf/nginx.conf，添加 RTMP 配置段（完整）：
#user  nobody;
worker_processes  1;#error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;#pid        logs/nginx.pid;events {worker_connections  1024;
}
rtmp {server {listen 1935;  # RTMP 默认端口chunk_size 4096;application live {live on;          # 开启直播模式hls on;           # 启用 HLS 切片hls_path /usr/local/nginx/html/hls;  # HLS 文件存储路径hls_fragment 4s;  # HLS 分片时长}}
}http {include       mime.types;default_type  application/octet-stream;#log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '#                  '$status $body_bytes_sent "$http_referer" '#                  '"$http_user_agent" "$http_x_forwarded_for"';#access_log  logs/access.log  main;sendfile        on;#tcp_nopush     on;#keepalive_timeout  0;keepalive_timeout  65;#gzip  on;server {listen       80;server_name  localhost;#charset koi8-r;#access_log  logs/host.access.log  main;location / {root   html;index  index.html index.htm;}#error_page  404              /404.html;# redirect server error pages to the static page /50x.html#error_page   500 502 503 504  /50x.html;location = /50x.html {root   html;}location /hls {types { # HLS 文件类型映射application/vnd.apple.mpegurl m3u8;video/mp2t ts;}add_header Cache-Control no-cache;add_header Access-Control-Allow-Origin *;root /usr/local/nginx/html;  # HLS 文件访问路径}# proxy the PHP scripts to Apache listening on 127.0.0.1:80##location ~ \.php$ {#    proxy_pass   http://127.0.0.1;#}# pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000##location ~ \.php$ {#    root           html;#    fastcgi_pass   127.0.0.1:9000;#    fastcgi_index  index.php;#    fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;#    include        fastcgi_params;#}# deny access to .htaccess files, if Apache's document root# concurs with nginx's one##location ~ /\.ht {#    deny  all;#}}# another virtual host using mix of IP-, name-, and port-based configuration##server {#    listen       8000;#    listen       somename:8080;#    server_name  somename  alias  another.alias;#    location / {#        root   html;#        index  index.html index.htm;#    }#}# HTTPS server##server {#    listen       443 ssl;#    server_name  localhost;#    ssl_certificate      cert.pem;#    ssl_certificate_key  cert.key;#    ssl_session_cache    shared:SSL:1m;#    ssl_session_timeout  5m;#    ssl_ciphers  HIGH:!aNULL:!MD5;#    ssl_prefer_server_ciphers  on;#    location / {#        root   html;#        index  index.html index.htm;#    }#}}

配置文件结构解析

RTMP 模块配置

rtmp {server {listen 1935;  # 监听 RTMP 默认端口chunk_size 4096;application live {live on;          # 开启直播模式hls on;           # 启用 HLS 切片hls_path /usr/local/nginx/html/hls;  # HLS 文件存储路径hls_fragment 4s;  # HLS 分片时长}}
}

作用：该模块配置 RTMP 服务器，监听 1935 端口，并支持：

  • 推流地址：rtmp://<服务器IP>/live/<stream_key>
  • HLS 拉流地址：http://<服务器IP>/hls/<stream_key>.m3u8

HTTP 模块配置

http {...server {listen 80;...location /hls {types {application/vnd.apple.mpegurl m3u8;video/mp2t ts;}add_header Cache-Control no-cache;add_header Access-Control-Allow-Origin *;root /usr/local/nginx/html;  # HLS 文件访问路径}}
}

作用：该模块配置 HTTP 服务器，支持通过 HTTP 提供 HLS 流媒体文件（.m3u8 和 .ts 文件）。

  1. 使用管理员权限，启动 Nginx 服务：
sudo /usr/local/nginx/sbin/nginx
  1. 启动或重启 Nginx
sudo /usr/local/nginx/sbin/nginx -s reload  # 如果已运行# 进入 Nginx 安装目录（默认路径）
# 启动 Nginx
sudo /usr/local/nginx/sbin/nginx # 直接启动

请添加图片描述
4. 检查进程是否启动

ps -elf | grep nginxwlj@wlj-virtual:/usr/local/nginx/conf$ ps -elf | grep nginx
1 S root        4192    1486  0  80   0 -  4372 -      13:51 ?        00:00:00 nginx: master process /usr/local/nginx/sbin/nginx
5 S nobody     35561    4192  0  80   0 -  4622 -      17:06 ?        00:00:00 nginx: worker process
5 S nobody     35562    4192  0  80   0 -  4495 -      17:06 ?        00:00:00 nginx: cache manager process
0 S wlj        36211   35420  0  80   0 -  3075 pipe_r 17:15 pts/3    00:00:00 grep --color=auto nginx

四. 启动Nginx时的权限问题

权限问题（open() “/usr/local/nginx/logs/error.log” failed (13: Permission denied)）

需要配置权限问题，否则将导致Nginx无法访问HLS文件，调整logs文件目录的权限或所有权，因此需要解决权限问题：

  1. 路径确认：检查实际安装路径
whereis nginx
  1. 检查 PID 文件路径
sudo /usr/local/nginx/sbin/nginx -t
输出：
nginx: the configuration file /usr/local/nginx/conf/nginx.conf syntax is ok
nginx: configuration file /usr/local/nginx/conf/nginx.conf test is successful

PID 文件配置：
确保 nginx.conf 中有 pid 指令：

pid /usr/local/nginx/logs/nginx.pid;

如无则添加，并创建目录：

sudo mkdir -p /usr/local/nginx/logs

ps -elf | grep nginxwlj@wlj-virtual:/usr/local/nginx/conf$ ps -elf | grep nginx
1 S root        4192    1486  0  80   0 -  4372 -      13:51 ?        00:00:00 nginx: master process /usr/local/nginx/sbin/nginx
5 S nobody     35561    4192  0  80   0 -  4622 -      17:06 ?        00:00:00 nginx: worker process
5 S nobody     35562    4192  0  80   0 -  4495 -      17:06 ?        00:00:00 nginx: cache manager process
0 S wlj        36211   35420  0  80   0 -  3075 pipe_r 17:15 pts/3    00:00:00 grep --color=auto nginx

sudo chown -R nobody:nogroup /usr/local/nginx/html/hls
sudo chmod -R 755 /usr/local/nginx/html/hls
sudo chmod -R 755 /usr/local/nginx/logs

五. 安装配置 FFmpeg

  1. 安装 NASM 或 YASM
  • 推荐使用nasm，因为FFmpeg的新特性可能依赖新指令集，且nasm有更好的维护。
  • 如果系统非常旧，yasm可能更容易安装到旧版本，但新系统建议nasm。
sudo apt install nasm # 推荐
sudo apt install yasm 

nasm --version   # 应输出类似 "NASM version 2.15.05"
yasm --version   # 可选，应输出类似 "yasm 1.3.0"
  1. 安装 pkg-config 工具
    pkg-config 工具需要安装，可能导致后续依赖库的检测和编译失败。
sudo apt install pkg-config
  1. 配置 FFmpeg
    下载地址
/* Download ffmpeg */
tar -zxvf ffmpeg-4.3.2.tar.gz
./configure --enable-shared
make -j4
sudo make install
  1. 查询 FFmpeg 的版本信息
ffmpeg -version
  1. 更新系统的动态链接器缓存
    即使库文件被复制到了 /usr/local/lib，Linux 的动态链接器（ld.so）可能还不知道这个路径，所以需要此命令。
sudo ldconfig

wlj@wlj-virtual:~/Desktop/FFmpeg-n4.3.2$ ffmpeg -version
ffmpeg version 4.3.2 Copyright (c) 2000-2021 the FFmpeg developers
built with gcc 11 (Ubuntu 11.4.0-1ubuntu1~22.04)
configuration: --enable-shared
libavutil      56. 51.100 / 56. 51.100
libavcodec     58. 91.100 / 58. 91.100
libavformat    58. 45.100 / 58. 45.100
libavdevice    58. 10.100 / 58. 10.100
libavfilter     7. 85.100 /  7. 85.100
libswscale      5.  7.100 /  5.  7.100
libswresample   3.  7.100 /  3.  7.100

六. 推流-拉流测试

  • 启动 Nginx：
sudo /usr/local/nginx/sbin/nginx
  • 检查防火墙：
sudo ufw status
sudo ufw allow 1935

验证 RTMP 服务是否正常
检查端口监听：

netstat -tuln | grep 1935

查看 Nginx 日志：

tail -f /var/log/nginx/error.log

请添加图片描述

使用 OBS Studio、FFmpeg 等工具推流到 Nginx 服务器：

  1. OBS 推流地址：
rtmp://127.0.0.1:1935/live/test
  1. FFmpeg 推流命令：
ffmpeg -re -i input.mp4 -c copy -f flv rtmp://127.0.0.1:1935/live/test
ffmpeg -re -f h264 -i input.h264 -c:v copy -an -f flv rtmp://127.0.0.1:1935/live/test
  • -re 按照原始帧率读取输入文件（模拟实时流速度），直播推流必须添加
  • -c copy 直接复制视频和音频流，不重新编码（要求MP4内的编码是RTMP兼容的H.264+AAC）
  • -c:v copy: 直接复制视频流，不重新编码。
  • -f flv 强制输出为FLV格式（RTMP协议的标准容器格式）
  • -f h264: 强制指定输入格式为原始H.264流（关键参数）。
  • -an: 禁用音频（输入文件无音频）。

循环推流（持续直播）：

ffmpeg -re -stream_loop -1 -i input.mp4 -c copy -f flv rtmp://127.0.0.1:1935/live/test

待 5-10 秒，让 Nginx 生成 .m3u8 和 .ts 文件。
访问 HLS 文件：
浏览器或 VLC 播放：

  • 本地测试：使用 127.0.0.1 或局域网 IP。
  • 远程服务器：使用公网 IP。
  • 推流地址格式：rtmp://:<端口>/live/<流名>

使用 VLC 或其他 RTMP 客户端拉流：

rtmp://127.0.0.1:1935/live/test
http://127.0.0.1/hls/test.m3u8

请添加图片描述
在这里插入图片描述

  • 关键点：确保 Nginx 正确加载 RTMP 模块，配置路径和权限正确，防火墙开放必要端口。
  • 验证步骤：推流 → 检查 HLS 文件 → 拉流测试 → 查看统计页面。
  • 扩展功能：可通过添加 HTTPS、限制连接数、配置负载均衡等进一步优化。

七. 自启动Nginx

要实现 Nginx 自动启动，可以根据您的操作系统选择不同的方法。以下是 Linux（基于 Systemd）的详细步骤：

  1. Linux 系统（基于 Systemd）创建 Systemd 服务文件

  2. 创建一个 Nginx 的 Systemd 服务配置文件：

sudo vim /etc/systemd/systm/nginx.service
  1. 添加以下内容（根据实际路径修改）：
[Unit]
Description=Nginx Web Server
After=network.target[Service]
Type=forking
PIDFile=/usr/local/nginx/logs/nginx.pidExecStartPre=/usr/local/nginx/sbin/nginx -t
ExecStart=/usr/local/nginx/sbin/nginx
ExecReload=/usr/local/nginx/sbin/nginx -s reload
ExecStop=/usr/local/nginx/sbin/nginx -s quit
PrivateTmp=true[Install]
WantedBy=multi-user.target
  1. 加载 Systemd 配置
# 重新加载 Systemd 配置
sudo systemctl daemon-reload# 启动并启用 Nginx 自启动
sudo systemctl start nginx
sudo systemctl enable nginx# 验证自启动状态
sudo systemctl is-enabled nginx  # 应返回 "enabled"检查 Nginx 状态
sudo systemctl status nginx

扩展功能建议

  1. 配置 HTTPS
    安装 OpenSSL 依赖（已通过 ./configure 集成）。
    生成 SSL 证书（测试可用自签名证书）：
    bash
    深色版本
    openssl req -x509 -nodes -days 365 -newkey 2048 -keyout /usr/local/nginx/conf/server.key -out /usr/local/nginx/conf/server.crt
    修改 nginx.conf：
    nginx
    深色版本
    server {
    listen 443 ssl;
    server_name example.com;
    ssl_certificate /usr/local/nginx/conf/server.crt;
    ssl_certificate_key /usr/local/nginx/conf/server.key;
    …
    }
  2. 启用 RTMP 推流
http://www.lryc.cn/news/605499.html

相关文章：

  • [Broken IOS] 配置CLI | 终端用户界面TUI
  • 分布式ID方案(标记)
  • 【Linux】linux基础开发工具(二) 编译器gcc/g++、动静态库感性认识、自动化构建-make/Makefile
  • BasicAuthenticationFilter处理 HTTP 基本认证（Basic Authentication）的核心过滤器详解
  • 打破数据质量瓶颈：用n8n实现30秒专业数据质量报告自动化
  • 50天50个小项目 (Vue3 + Tailwindcss V4) ✨ | LiveUserFilter（实时用户过滤组件）
  • ensp安全策略实验
  • 【工具】NVM完全指南：Node.js版本管理工具的安装与使用详解
  • 嵌入式仿真教学的革新力量：深圳航天科技创新研究院引领高效学习新时代
  • 【n8n】如何跟着AI学习n8n【03】：HTTPRequest节点、Webhook节点、SMTP节点、mysql节点
  • 从“碎片化”到“完美重组”：IP报文的分片艺术
  • mysql笔记02：DML插入、更新、删除数据
  • 【读书笔记】Design Patterns (1994)✅
  • 微软发布Microsoft Sentinel数据湖国际版
  • JVM之【Java虚拟机概述】
  • Python实现调整矩阵维度： view
  • 【13】大恒相机SDK C#开发 —— Fom1中实时处理的8个图像 实时显示在Form2界面的 pictureBox中
  • 磁盘坏道检测工具在美国服务器硬件维护中的使用规范
  • MVS相机+YOLO检测方法
  • 【03】大恒相机SDK C#开发 —— 回调采集图像，关闭相机
  • Java WEB技术-序列化和反序列化认识（SpringBoot的Jackson序列化行为？如何打破序列化过程的驼峰规则？如何解决学序列化循环引用问题？）
  • 学习笔记《区块链技术与应用》第三天 网络 难度
  • 详解分布式数据库缓存技术：高性能数据访问的基石
  • 如何在 macOS 上使用 dnsmasq 搭建本地 DNS 缓存/转发
  • 深度解析：基于Python构建的闲鱼自动化营销与信息发送机器人
  • IO流专题
  • linux运维学习第十三周
  • Linux 服务器性能优化：性能监控，系统性能调优，进程优先级，内核升级全解析
  • 前端框架Vue3（二）——Vue3核心语法之OptionsAPI与CompositionAPI与setup
  • AWS云安全审计终极实战指南：构建自动化安全防线