快速搭建nginx-http-flv-module：低延迟流媒体服务器完整安装指南

2026-01-25 05:46:47作者：鲍丁臣Ursa

A media streaming server based on nginx-rtmp-module. In addtion to the features nginx-rtmp-module provides, HTTP-FLV, GOP cache, VHost (one IP for multi domain names) and JSON style statistics are supported now.

项目地址：https://gitcode.com/gh_mirrors/ng/nginx-http-flv-module

想要构建一个支持HTTP-FLV直播的流媒体服务器吗？nginx-http-flv-module是一个基于nginx-rtmp-module的强大扩展，专门为需要低延迟直播场景而设计。这个开源项目不仅保留了原版nginx-rtmp-module的所有功能，还新增了GOP缓存、虚拟主机支持等实用特性，让您的直播服务更加专业和高效。🎥

✨ 核心功能亮点

nginx-http-flv-module相比原版nginx-rtmp-module增加了多项实用功能：

HTTP-FLV播放支持：通过HTTP协议直接播放FLV格式的直播流
GOP缓存技术：大幅减少首屏等待时间，提升用户体验
虚拟主机功能：一个IP地址支持多个域名
JSON风格统计：直观的数据监控和统计分析
多协议兼容：同时支持RTMP、HTTP-FLV、HLS、DASH等多种流媒体协议

🛠️ 系统要求与环境准备

操作系统支持

推荐：Linux系统
可选：FreeBSD、MacOS
有限支持：Windows系统

必备依赖组件

在开始安装之前，请确保系统已安装以下组件：

编译工具：GCC/G++编译器、GNU make
流媒体工具：FFmpeg或OBS用于发布流
播放器：VLC或flv.js用于播放测试

📦 完整安装步骤

第一步：下载源码

首先需要下载NGINX官方源码和nginx-http-flv-module模块：

# 下载NGINX源码（以1.18.0版本为例）
wget http://nginx.org/download/nginx-1.18.0.tar.gz
tar -zxvf nginx-1.18.0.tar.gz

# 克隆nginx-http-flv-module仓库
git clone https://gitcode.com/gh_mirrors/ng/nginx-http-flv-module

第二步：编译安装

进入NGINX源码目录执行配置和编译：

cd nginx-1.18.0

# 配置编译选项
./configure --add-module=/path/to/nginx-http-flv-module

# 编译并安装
make
sudo make install

第三步：配置服务器

编辑NGINX配置文件，添加RTMP和HTTP-FLV支持：

配置文件位置通常在 /usr/local/nginx/conf/nginx.conf，您可以使用项目提供的测试配置作为参考：test/nginx.conf

第四步：启动服务

# 启动NGINX服务
sudo /usr/local/nginx/sbin/nginx

# 检查服务状态
ps aux | grep nginx

🎯 快速验证安装效果

安装完成后，可以通过以下步骤验证模块是否正常工作：

发布直播流：

ffmpeg -re -i input.mp4 -c copy -f flv rtmp://localhost/myapp/mystream


2. **播放测试**：
   - **HTTP-FLV方式**：`http://localhost/live?app=myapp&stream=mystream`
   - **RTMP方式**：`rtmp://localhost/myapp/mystream`

## 🔧 高级配置选项

### 多进程模式优化
对于生产环境，建议进行以下优化配置：

```nginx
worker_processes 1;  # 单进程模式更稳定
events {
    worker_connections 4096;
}

虚拟主机配置

支持一个IP地址服务多个域名：

rtmp {
    server {
        listen 1935;
        server_name www.test.*;
        
        application myapp {
            live on;
            gop_cache on;  # 开启GOP缓存
        }
    }
}