nginx-http-flv-module是在nginx-rtmp-module基礎上開發的一個直播模塊。
感謝Arut創造了nginx-rtmp-module,它是Nginx的一個優秀的第三方模塊,能夠用來直播,支持RTMP,HLS和DASH方式直播,還支持調用第三方軟件進行轉碼,錄製視頻等功能,因爲依託Nginx,性能也比較高。可是美中不足的地方也很多,例如首屏時間長,不支持HTTP-FLV方式直播,不支持虛擬主機(vhost)功能,省略listen配置沒法接受鏈接,有不少很明顯的bug等問題。
nginx-http-flv-module解決了上述的問題。固然,還有些bug還有待修復。具體使用方法請參考說明文件:php
爲何選擇Nginx做爲支持HTTP-FLV方式直播的服務器呢?由於Nginx的Web服務器功能對HTTP協議的支持很是完善,Nginx的性能優秀,通過了不少場景的檢驗。另外,Nginx自己對第三方軟件的依賴較少,很是易於部署。這些都使得它成爲HTTP-FLV方式直播服務器不可多得的選擇。html
Github:nginx-http-flv-modulelinux
https://github.com/winshining/nginx-http-flv-modulenginx
查看英文介紹文檔 :English README。git
nginx-rtmp-module提供的全部功能。github
nginx-http-flv-module的其餘功能與nginx-rtmp-module的對比:正則表達式
功能 | nginx-http-flv-module | nginx-rtmp-module | 備註 |
---|---|---|---|
HTTP-FLV (播放) | √ | x | 支持HTTPS-FLV和chunked回覆 |
GOP緩存 | √ | x | |
虛擬主機 | √ | x | |
省略listen 配置 |
√ | 見備註 | 配置中必須有一個listen |
純音頻支持 | √ | 見備註 | wait_video 或wait_key 開啓後沒法工做 |
定時打印訪問記錄 | √ | x | |
JSON風格的stat | √ | x |
在類Unix系統上,須要GNU make,用於調用編譯器來編譯軟件。shell
在類Unix系統上,須要GCC。或者在Windows上,須要MSVC,用於編譯軟件。json
在類Unix系統上,須要GDB,用於調試軟件(可選)。windows
若是NGINX要支持正則表達式,須要PCRE庫。
若是NGINX要支持加密訪問,須要OpenSSL庫。
若是NGINX要支持壓縮,須要zlib庫。
在這些操做系統上,最新發布且適配最新穩定版NGINX的模塊能夠經過如下方式獲取:
yum install https://extras.getpagespeed.com/release-el$(rpm -E %{rhel})-latest.rpm yum install nginx-module-flv
dnf install https://extras.getpagespeed.com/release-el$(rpm -E %{rhel})-latest.rpm sudo dnf --disablerepo=rhel-8-for-x86_64-appstream-rpms install nginx-module-flv
安裝完畢後,HTTP-FLV功能的配置文件http-flv.conf
和RTMP功能的配置文件rtmp.conf
會被放在/etc/nginx/http-flv
目錄下,經過include
手工將它們添加到/etc/nginx/nginx.conf
,以開啓HTTP-FLV和RTMP功能:
http { ... include /etc/nginx/http-flv/http-flv.conf; } include /etc/nginx/http-flv/rtmp.conf;
添加如下配置到/etc/nginx/nginx.conf
,啓動或者重啓NGINX來啓用本模塊:
load_module modules/ngx_http_flv_live_module.so;
上述的配置必須位於events
配置項以前,不然NGINX不能啓動。
更新能夠經過yum update
來完成。關於其餘NGINX模塊的詳情見GetPageSpeed。
對於其餘操做系統,見下面源碼編譯安裝的說明。
nginx-http-flv-module包含了nginx-rtmp-module全部的功能,因此不要將nginx-http-flv-module和nginx-rtmp-module一塊兒編譯。
編譯步驟請參考Building nginx on the Win32 platform with Visual C,不要忘了在Run configure script
步驟中添加--add-module=/path/to/nginx-http-flv-module
。
下載NGINX和nginx-http-flv-module。
將它們解壓到某一路徑 /path/to/nginx-http-flv-module。
打開NGINX的源代碼路徑(/usr/local/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
操做日誌
[root@ip104 tengine-2.3.2]# ./configure --add-dynamic-module=/path/to/nginx-http-flv-module checking for OS + Linux 3.10.0-957.21.3.el7.x86_64 x86_64 checking for C compiler ... found 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" [root@ip104 tengine-2.3.2]#
關於nginx-rtmp-module用法的詳情,請參考README.md。
爲了簡單起見,不用轉碼:
ffmpeg -re -i MEDIA_FILE_NAME -c copy -f flv rtmp://example.com[:port]/appname/streamname
一些舊版本的FFmpeg不支持選項-c copy
,可使用選項-vcodec copy -acodec copy
替代。
appname
用於匹配rtmp配置塊中的application塊(更多詳情見下文)。
streamname
能夠隨意指定,可是不能省略。
RTMP默認端口爲1935,若是要使用其餘端口,必須指定:port
。
http://example.com[:port]/dir?[port=xxx&]app=appname&stream=streamname
若是使用ffplay命令行方式播放流,那麼必須爲上述的url加上引號,不然url中的參數會被丟棄(有些不太智能的shell會把"&"解釋爲"後臺運行")。
若是使用flv.js播放流,那麼請保證發佈的流被正確編碼,由於flv.js只支持H.264編碼的視頻和AAC/MP3編碼的音頻。
參數dir
用於匹配http配置塊中的location塊(更多詳情見下文)。
HTTP默認端口爲80, 若是使用了其餘端口,必須指定:port
。
RTMP默認端口爲1935,若是使用了其餘端口,必須指定port=xxx
。
參數app
的值(appname)用來匹配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; } } }
而且發佈的流的名稱是mystream
,那麼基於HTTP的播放url是:
http://example.com:8080/live?port=1985&app=myapp&stream=mystream
因爲一些播放器不支持HTTP塊傳輸, 這種狀況下最好在指定了flv_live on;
的location中指定chunked_transfer_encoding off
,不然播放會失敗。
rtmp://example.com[:port]/appname/streamname
http://example.com[:port]/dir/streamname.m3u8
http://example.com[:port]/dir/streamname.mpd
配置項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
設置爲1,由於在多進程模式下,ngx_rtmp_stat_module
可能不會從指定的worker進程獲取統計數據,由於HTTP請求是被隨機分配給worker進程的。ngx_rtmp_control_module
也有一樣的問題。這個問題能夠經過這個補丁per-worker-listener優化。
另外,vhost
功能在多進程模式下還不能徹底正確運行,等待修復。例如,無論向哪一個域名推流,下面的配置在多進程模式下是沒有問題的:
rtmp { ... server { listen 1935; server_name 1st_domain_name; application myapp { ... } } server { listen 1935; server_name 2nd_domain_name; application myapp { ... } } }
而使用下面的配置,當publisher在端口1945上發佈媒體流,播放請求在此端口上訪問非publisher的worker進程時是有問題的:
rtmp { ... server { listen 1935; server_name 1st_domain_name; application myapp { ... } } server { listen 1945; server_name 2nd_domain_name; application myapp { ... } } }
worker_processes 1; #運行在Windows上時,設置爲1,由於Windows不支持Unix domain socket #worker_processes auto; #1.3.8和1.2.5以及以後的版本 #worker_cpu_affinity 0001 0010 0100 1000; #只能用於FreeBSD和Linux #worker_cpu_affinity auto; #1.9.10以及以後的版本 error_log logs/error.log error; #若是此模塊被編譯爲動態模塊而且要使用與RTMP相關的功 #能時,必須指定下面的配置項而且它必須位於events配置 #項以前,不然NGINX啓動時不會加載此模塊或者加載失敗 #load_module modules/ngx_http_flv_live_module.so; events { worker_connections 4096; } 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 /hls { types { application/vnd.apple.mpegurl m3u8; video/mp2t ts; } root /tmp; add_header 'Cache-Control' 'no-cache'; } location /dash { root /tmp; add_header 'Cache-Control' 'no-cache'; } location /stat { #push和pull狀態的配置 rtmp_stat all; rtmp_stat_stylesheet stat.xsl; } location /stat.xsl { root /var/www/rtmp; #指定stat.xsl的位置 } #若是須要JSON風格的stat, 不用指定stat.xsl #可是須要指定一個新的配置項rtmp_stat_format #location /stat { # rtmp_stat all; # rtmp_stat_format json; #} location /control { rtmp_control all; #rtmp控制模塊的配置 } } } rtmp_auto_push on; rtmp_auto_push_reconnect 1s; rtmp_socket_dir /tmp; rtmp { out_queue 4096; out_cork 8; max_streams 128; timeout 15s; drop_idle_publisher 15s; log_interval 5s; #log模塊在access.log中記錄日誌的間隔時間,對調試很是有用 log_size 1m; #log模塊用來記錄日誌的緩衝區大小 server { listen 1935; server_name www.test.*; #用於虛擬主機名後綴通配 application myapp { live on; gop_cache on; #打開GOP緩存,減小首屏等待時間 } application hls { live on; hls on; hls_path /tmp/hls; } application dash { live on; dash on; dash_path /tmp/dash; } } 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緩存,減小首屏等待時間 } } }
events { worker_connections 1024; #Nginx處理的最大鏈接數 } http { include mime.types; default_type application/octet-stream; keepalive_timeout 65; server { listen 80; #Nginx監聽的HTTP請求端口 location / { root /var/www; #HTTP請求URL映射到服務器的位置 index index.html index.htm; #HTTP請求優先請求的文件,如http://localhost/,若是有index.html在/var/www目錄下,那麼請求的是/var/www/index.html } error_page 500 502 503 504 /50x.html; #若是遇到這些HTTP請求錯誤,Nginx返回50x.html的內容 location = /50x.html { root html; #由於/配置了root /var/www,因此這兒html對應的是/var/www/html,因此50x.html的路徑是/var/www/html/50x.html } location /live { flv_live on; #當HTTP請求以/live結尾,匹配這兒,這個選項表示開啓了flv直播播放功能 chunked on; #HTTP協議開啓Transfer-Encoding: chunked;方式回覆,已廢棄,使用標準的chunked_tranfer_encoding代替 } } } rtmp_auto_push on; #由於Nginx可能開啓多個子進程,這個選項表示推流時,媒體流會發布到多個子進程 rtmp_auto_push_reconnect 1s; rtmp_socket_dir /tmp; #多個子進程狀況下,推流時,最開始只有一個子進程在競爭中接收到數據,而後它再relay給其餘子進程,他們之間經過unix domain socket傳輸數據,這個選項表示unix domain socket的路徑 rtmp { out_queue 4096; out_cork 8; max_streams 64; #Nginx能接受的最大的推流數 server { listen 1935; #Nginx監聽的RTMP推流/拉流端口,能夠省略,默認監聽1935 application myapp { live on; #當推流時,RTMP路徑中的APP(RTMP中一個概念)匹配myapp時,開啓直播 gop_cache on; #開啓GOP(Group of Picture)緩存,播放器解碼時,收到一個完整的GOP纔會開始播放,這個是減小播放延遲的選項 pull rtmp://live.hkstv.hk.lxdns.com/live/hks; #若是懶得推流,那能夠用這個,香港衛視的直播推流 } #如下配置項已廢棄 application app1 { proxy_pass rtmp://host(ip or domain name)[:host]/app2; #將推流反向代理到上游服務器,並將app1自動轉化爲app2 #proxy_pass rtmp://backend; #將推流反向代理到上游服務器,見upstream配置 } } server { listen 1935; server_name *.test.com; #或者www.test.*/www.test.com application myapp { live on; gop_cache on; } } #如下配置項已廢棄,緣由在下文更新中 upstream backend { #開啓負載均衡 server host1:port1; server host2:port2; } }
#aaa #工做進程 worker_processes 2; #worker_processes auto; #1.3.8和1.2.5以及以後的版本 #worker_cpu_affinity 0001 0010 0100 1000; #只能用於FreeBSD和Linux #worker_cpu_affinity auto; #1.9.10以及以後的版本 #日誌功能 error_log logs/error.log error; #error_log logs/error.log; #error_log logs/error.log notice; #error_log logs/error.log info; #error_log "pipe:rollback logs/error_log interval=1d baknum=7 maxsize=2G"; #pid logs/nginx.pid; #若是此模塊被編譯爲動態模塊而且要使用與RTMP相關的功 #能時,必須指定下面的配置項而且它必須位於events配置 #項以前,不然NGINX啓動時不會加載此模塊或者加載失敗 #load_module modules/ngx_http_flv_live_module.so; #事件配置 events { worker_connections 1024; } # load modules compiled as Dynamic Shared Object (DSO) # #dso { # load ngx_http_fastcgi_module.so; # load ngx_http_rewrite_module.so; #} #RTMP配置 rtmp_auto_push on; rtmp_auto_push_reconnect 1s; rtmp_socket_dir /tmp; rtmp { out_queue 4096; out_cork 8; max_streams 128; timeout 15s; drop_idle_publisher 15s; log_interval 5s; #log模塊在access.log中記錄日誌的間隔時間,對調試很是有用 log_size 1m; #log模塊用來記錄日誌的緩衝區大小 # 用因而直播的服務 1935端口 推送地址:rtmp://39xxxxxxx.120:1935/hls 獲取地址:http://live.xxxxxxxx.com/hls/222.m3u8 server { listen 1935; server_name live.xxxxx.com; #server_name 1935.xxxxxx.com; #用於虛擬主機名後綴通配 #chunk_size 4000; #快大小 #電視模式 application mytv { live on; #enable live streaming #record first 1K of stream record all; record_path /tmp/av; record_max_size 1K; #append current timestamp to each flv record_unique on; #publish only from localhost allow publish 127.0.0.1; deny publish all; #allow play all; } application myapp { live on; gop_cache on; #打開GOP緩存,減小首屏等待時間 } #hls配置 application hls { live on; hls on; hls_path /tmp/hls; } application dash { live on; dash on; dash_path /tmp/dash; } } #能夠多個server的 } # HTTP 相關網絡請求配置 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; #access_log "pipe:rollback logs/access_log interval=1d baknum=7 maxsize=2G" main; sendfile on; #tcp_nopush on; #keepalive_timeout 0; keepalive_timeout 65; #gzip on; # 用於,net core 相關網站的服務 server { listen 80; server_name www.xxxxxxxx.com #server_name xxxxxx.com *.xxxxxxx.com; #charset koi8-r; #access_log logs/host.access.log main; #access_log "pipe:rollback logs/host.access_log interval=1d baknum=7 maxsize=2G" main; location / { root html; index index.html index.htm; #proxy_pass http://localhost:5000; #proxy_http_version 1.1; #proxy_set_header Upgrade $http_upgrade; #proxy_set_header Connection keep-alive; #proxy_set_header Host $host; # proxy_cache_bypass $http_upgrade; #proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; #proxy_set_header X-Forwarded-Proto $scheme; } #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; } # 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; #} } #用於視頻直播服務先關的http 解析服務 add 2019-7-8 server { listen 80; server_name live.xxxxxxxxxx.com; location / { #index /stat; proxy_pass http://localhost:1936; } 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 /hls { types { application/vnd.apple.mpegurl m3u8; video/mp2t ts; } root /tmp; add_header 'Cache-Control' 'no-cache'; } location /dash { root /tmp; add_header 'Cache-Control' 'no-cache'; } location /stat { #push和pull狀態的配置 rtmp_stat all; rtmp_stat_stylesheet stat.xsl; } location /stat.xsl { root /usr/local/nginx-http-flv-module; #指定stat.xsl的位置 } #若是須要JSON風格的stat, 不用指定stat.xsl #可是須要指定一個新的配置項rtmp_stat_format #location /stat { # rtmp_stat all; # rtmp_stat_format json; #} location /control { rtmp_control all; #rtmp控制模塊的配置 } } #測試服務器使用 server { listen 80; server_name 8056.xxxxxxxxxxx.com; #server_name 1123.xxxxxxxx.com; #charset koi8-r; #access_log logs/host.access.log main; #access_log "pipe:rollback logs/host.access_log interval=1d baknum=7 maxsize=2G" main; location / { root html; index 404.html 404.htm; proxy_pass http://localhost:8056; #proxy_http_version 1.1; #proxy_set_header Upgrade $http_upgrade; #proxy_set_header Connection keep-alive; #proxy_set_header Host $host; # proxy_cache_bypass $http_upgrade; #proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; #proxy_set_header X-Forwarded-Proto $scheme; } #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; } # 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; # } #} }