nginx-rtmp-mudule RTMP 是一款優秀的Car-eye-http-flv-module 是在nginx-rtmp-mudule RTMP基礎上修改的流媒體伺服器，除了支援flash播放器外，還支援現在常見的播放器。完美實現了HTTP方式的FLV直播功能。

本文簡單介紹下該模組的主要功能和使用：

功能

• 基於HTTP協議的FLV直播流播放。

• GOP快取，降低播放延遲 (H.264視訊和AAC音訊)。

• 支援Transfer-Encoding: chunked方式的HTTP回覆。

• rtmp配置的server塊中可以省略listen配置項。

• 支援虛擬主機。

支援的系統

• Linux（推薦）/FreeBSD/MacOS/Windows（受限）。

支援的播放器

• VLC (RTMP & HTTP-FLV)/OBS (RTMP & HTTP-FLV)/JW Player (RTMP)/flv.js (HTTP-FLV).

依賴

• 在類Unix系統上，需要GNU make，用於呼叫編譯器來編譯軟體。

• 在類Unix系統上，需要GCC/在Windows上，需要MSVC，用於編譯軟體。

• 在類Unix系統上，需要GDB，用於除錯軟體（可選）。

• FFmpeg，用於釋出媒體流。

• VLC播放器（推薦），用於播放媒體流。

• 如果NGINX要支援正則表示式，需要PCRE庫。

• 如果NGINX要支援加密訪問，需要OpenSSL庫。

• 如果NGINX要支援壓縮，需要zlib庫。

建立

在Windows上

編譯步驟請參考Building nginx on the Win32 platform with Visual C，不要忘了在Run configure script步驟中新增--add-module=/path/to/nginx-http-flv-module。

在類Unix系統上

下載NGINX和nginx-http-flv-module。

將它們解壓到某一路徑。

開啟NGINX的原始碼路徑並執行：

將模組編譯進NGINX

./configure --add-module=/path/to/nginx-http-flv-module
make
make install

將模組編譯為動態模組

./configure --add-dynamic-module=/path/to/nginx-http-flv-module
make
make install
 

注意

如果將模組編譯為動態模組，那麼NGINX的版本號必須大於或者等於1.9.11。

釋出

ffmpeg -re -i example.mp4 -vcodec copy -acodec copy -f flv rtmp://example.com[:port]/appname/streamname

appname用於匹配rtmp配置塊中的application塊（更多詳情見下文）。

streamname可以隨意指定。

RTMP預設埠為1935，如果要使用其他埠，必須指定:port。

播放（HTTP）

http://example.com[:port]/dir?[port=xxx&]app=myapp&stream=mystream

引數dir用於匹配http配置塊中的location塊（更多詳情見下文）。

HTTP預設埠為80, 如果使用了其他埠，必須指定:port。

RTMP預設埠為1935，如果使用了其他埠，必須指定port=xxx。

引數app用來匹配application塊，但是如果請求的app出現在多個server塊中，並且這些server塊有相同的地址和埠配置，那麼還需要用匹配主機名的server_name配置項來區分請求的是哪個application塊，否則，將匹配第一個application塊。

引數stream用來匹配發布流的streamname。

例子

假設在http配置塊中的listen配置項是：

http {
    ...
    server {
        listen 8080; #不是預設的80埠
        ...

        location /live {
            flv_live on;
        }
    }
}

在rtmp配置塊中的listen配置項是：

rtmp {
    ...
    server {
        listen 1985; #不是預設的1935埠
        ...

        application myapp {
            live on;
        }
    }
}

那麼基於HTTP的播放url是：

http://example.com:8080/live?port=1985&app=myapp&stream=mystream

注意

如果使用的是HTTP版本1.1（HTTP/1.1），chunked_transfer_encoding配置項預設是開啟的。

由於一些播放器不支援HTTP塊傳輸，這種情況下最好在指定了flv_live on;的location中指定chunked_transfer_encoding off，否則播放會失敗。

nginx.conf例項

注意

配置項rtmp_auto_push，rtmp_auto_push_reconnect和rtmp_socket_dir在Windows上不起作用，除了Windows 10 17063以及後續版本之外，因為多程序模式的relay需要Unix domain socket的支援，詳情請參考Unix domain socket on Windows 10。

worker_processes  4; #執行在Windows上時，設定為1，因為Windows不支援Unix domain socket
worker_cpu_affinity  0001 0010 0100 1000; #執行在Windows上時，省略此配置項

error_log logs/error.log error;

#如果此模組被編譯為動態模組並且要使用與RTMP相關的功
#能時，必須指定下面的配置項並且它必須位於events配置
#項之前，否則NGINX啟動時不會載入此模組或者載入失敗
#load_module modules/ngx_rtmp_module.so;

events {
    worker_connections  1024;
}

http {
    include       mime.types;
    default_type  application/octet-stream;

    keepalive_timeout  65;

    server {
        listen       80;

        location / {
            root   /var/www;
            index  index.html index.htm;
        }

        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }

        location /live {
            flv_live on; #開啟HTTP播放FLV直播流功能
            chunked_transfer_encoding on; #支援'Transfer-Encoding: chunked'方式回覆

            add_header 'Access-Control-Allow-Origin' '*'; #新增額外的HTTP頭
            add_header 'Access-Control-Allow-Credentials' 'true'; #新增額外的HTTP頭
        }

        location /stat {
            #push和pull狀態的配置

            rtmp_stat all;
            rtmp_stat_stylesheet stat.xsl;
        }

        location /stat.xsl {
            root /var/www/rtmp; #指定stat.xsl的位置
        }
    }
}

rtmp_auto_push on;
rtmp_auto_push_reconnect 1s;
rtmp_socket_dir /tmp;

rtmp {
    out_queue   4096;
    out_cork    8;
    max_streams 64;

    server {
        listen 1935;
        server_name www.test.*; #用於虛擬主機名字尾通配

        application myapp {
            live on;
            gop_cache on; #開啟GOP快取，降低播放延遲
        }
    }

    server {
        listen 1935;
        server_name *.test.com; #用於虛擬主機名字首通配

        application myapp {
            live on;
            gop_cache on; #開啟GOP快取，降低播放延遲
        }
    }

    server {
        listen 1935;
        server_name www.test.com; #用於虛擬主機名完全匹配

        application myapp {
            live on;
            gop_cache on; #開啟GOP快取，降低播放延遲
        }
    }
}