Nginx RTMP 模块安装与配置指南

Nginx RTMP 模块安装与配置指南

nginx-rtmp-module 项目地址: https://gitcode.com/gh_mirrors/nginx/nginx-rtmp-module

本指南基于 flying1314/nginx-rtmp-module 开源项目，旨在帮助用户了解并搭建一个具备RTMP及多种流媒体处理能力的Nginx服务器。

1. 项目目录结构及介绍

flying1314/nginx-rtmp-module 的目录结构包含了Nginx RTMP模块的核心代码和相关配置模板。以下是一些关键目录和文件：

• src: 包含了模块的源代码，如 ngx_rtmp_core_module.c, ngx_rtmp_live_module.c 等，负责实现RTMP服务的核心逻辑。
• config: 包含编译时所需的配置脚本，用于指导如何将模块集成到Nginx中。
• AUTHORS, LICENSE: 分别记录作者信息和许可证详情，该项目遵循 BSD-2-Clause 许�可证。
• README.md: 主要的项目说明文件，提供了快速入门指南和主要特性的概述。
• stat.xsl: 用于配合Nginx RTMP模块生成流监控界面的样式表。

2. 项目的启动文件介绍

Nginx的启动实际是由其可执行文件nginx来完成的，通常位于安装路径的sbin目录下，例如 /usr/local/nginx/sbin/nginx。但是，在进行RTMP服务之前，需先通过特定的配置构建Nginx以包含RTMP模块。因此，并不存在直接归属于RTMP模块的“启动文件”，而是通过Nginx的主配置文件(nginx.conf)间接配置启动RTMP服务。

3. 项目的配置文件介绍

主配置文件 (nginx.conf)

主配置文件是Nginx工作的核心，对于RTMP服务，你需要在其中至少添加以下几个部分：

• 全局设置：定义工作进程数量、错误日志等基础配置。
• 事件模块：配置连接参数，比如worker_connections。
• HTTP服务：尽管关注的是RTMP，但部分配置如流媒体访问路径也需要在此设定。
• Stream模块：配置RTMP服务的关键所在，包括监听端口、应用实例(app)及其相关的RTMP指令如live, hls, record等。

示例配置段落如下：

worker_processes 1;

events {
    worker_connections 1024;
}

stream {
    server {
        listen 1935;
        application live {
            live on;
            hls on;
            hls_path /tmp/hls;
        }
    }
}

http {
    include mime.types;
    server {
        listen 80;
        location /hls {
            types { application/vnd.apple.mpegurl m3u8; video/mp2t ts; }
            root /tmp;
            add_header Cache-Control no-cache;
        }
        # 其他HTTP相关配置...
    }
}

请注意，这只是一个简化版的配置示例，实际使用时应根据需求扩展更多配置项，如流监控、安全性设置等。

完成配置后，通过如下命令启动Nginx（假设Nginx已正确安装且包含RTMP模块）:

sudo /usr/local/nginx/sbin/nginx

若需重启或重载配置，分别使用：

sudo /usr/local/nginx/sbin/nginx -s reload

通过本文档，您应能成功搭建并基本配置一个支持RTMP服务的Nginx环境。记住，深入理解每个配置项的具体作用对于优化您的流媒体服务至关重要。

nginx-rtmp-module 项目地址: https://gitcode.com/gh_mirrors/nginx/nginx-rtmp-module