nginx-rtmp 配置詳解

譯序:截至 Jul 8th,2013 官方公布的最新 Nginx RTMP 模塊 nginx-rtmp-module 指令詳解。
原文地址:https://www.cnblogs.com/lidabo/p/7099501.html
指令
Core
rtmp
語法:rtmp { ... }
上下文:根
描述:保存所有 RTMP 配置的塊。
server
語法:server { ... }
上下文:rtmp
描述:聲明一個 RTMP 實例。
rtmp {
server {
}
}

listen
語法:listen (addr[:port]|port|unix:path) [bind] [ipv6only=on|off] [so_keepalive=on|off|keepidle:keepintvl:keepcnt]
上下文:server
描述:給 NGINX 添加一個監聽端口以接收 RTMP 連接。
server {
listen 1935;
}

application
語法:application name { ... }
上下文:server
描述:創建一個 RTMP 應用。application 名的模式并不類似于 http location。
server {
listen 1935;
application myapp {
}
}

timeout
語法:timeout value
上下文:rtmp, server
描述:Socket 超時。這個值主要用于寫數據時。大多數情況下,RTMP 模塊并不期望除 publisher 端口之外的其他端口處于活動狀態。如果你想要快速關掉 socket 可以用 keepalive 或者 RTMP ping 等。timeout 默認值為 1 分鐘。
timeout 60s;
ping
語法:ping value
上下文:rtmp, server
描述:RTMP ping 間隔。零值的話將 ping 關掉。RTMP ping 是一個用于檢查活動連接的協議功能。發送一個特殊的包到遠程連接,然后在 ping_timeout 指令指定的時間內期待一個回復。如果在這個時間里沒有收到 ping 回復,連接斷開。ping 默認值為一分鐘。ping_timeout 默認值為 30 秒。
ping 3m;
ping_timeout 30s;

ping_timeout
語法:ping_timeout value
上下文:rtmp, server
描述:請參考上文 ping 描述。
max_streams
語法:max_streams value
上下文:rtmp, server
描述:設置 RTMP 流的最大數目。數據流被整合到一個單一的數據流里。不同的頻道用于發送命令、音頻、視頻等。默認值為 32,適用于大多數情況。
max_streams 32;
ack_window
語法:ack_window value
上下文:rtmp, server
描述:設置 RTMP 確認視窗大小。這是對端發送確認包到遠端后應該收到的字節數量。默認值為 5000000。
ack_window 5000000;
chunk_size
語法:chunk_size value
上下文:rtmp, server
描述:流整合的最大的塊大小。默認值為 4096。這個值設置的越大 CPU 負載就越小。這個值不能低于 128。
chunk_size 4096;
max_queue
語法:max_queue value
上下文:rtmp, server
描述:輸入數據報文最大尺寸。所有輸入數據會被分割成報文(然后進一步分割為塊)。報文在處理結束之前會放在內存里。理論上講,接收到的報文很大的話對于服務器的穩定性可能會有影響。默認值 1M 對于大多數情況就足夠了。
max_message 1M;
out_queue
out_cork
Access
allow
語法:allow [play|publish] address|subnet|all
上下文:rtmp, server, application
允許來自指定地址或者所有地址發布/播放。allow 和 deny 指令的先后順序可選。
allow publish 127.0.0.1;
deny publish all;
allow play 192.168.0.0/24;
deny play all;

deny
語法:deny [play|publish] address|subnet|all
上下文:rtmp, server, application
描述:參考 allow 的描述。
Exec
exec
語法:exec command arg*
上下文:rtmp, server, application
描述:定義每個流發布時要執行的帶有參數的外部命令。發布結束時進程終止。第一個參數應該是二進制可執行文件的完整路徑。關于這個進程將會做些什么事沒有任何假定。但這一特點在使用 ffmpeg 進行流轉換時是很有用的。FFmpeg 被假定作為客戶端連接到 nginx-rtmp 然后作為發布者輸出轉換流到 nginx-rtmp。類似于 var/{var} 形式的替換可以在命令行使用:

  • $name - 流的名字。
  • $app - 應用名。
  • $addr - 客戶端地址。
  • $flashver - 客戶端 flash 版本。
  • $swfurl - 客戶端 swf url。
  • $tcurl - 客戶端 tc url。
  • $pageurl - 客戶端頁面 url。
    可以在 exec 指令中定義 Shell 格式的轉向符用于寫輸出和接收輸入。支持如下
  • 截斷輸出 >file。
  • 附加輸出 >>file。
  • 重定向描述符類似于 1>&2。
  • 輸入 <file。
    以下 ffmpeg 調用將輸入流轉碼為 HLS-ready 流(H264/AAC)。運行這個示例,FFmpeg 須編譯為支持 libx264 & libfaac。
    **application src {
    live on;
    exec ffmpeg -i rtmp://localhost/src/name -vcodec libx264 -vprofile baseline -g 10 -s 300x200 -acodec libfaac -ar 44100 -ac 1 -f flv rtmp://localhost/hls/name 2>>/var/log/ffmpeg-$name.log;
    }

application hls {
live on;
hls on;
hls_path /tmp/hls;
hls_fragment 15s;
}**
exec_static
語法:exec_static command arg*
上下文:rtmp, server, application
描述:類似于 exec 指令,但在 nginx 啟動時將運行定義的命令。因為(啟動時)尚無會話上下文,不支持替換。
exec_static ffmpeg -i http://example.com/video.ts -c copy -f flv rtmp://localhost/myapp/mystream;
exec_kill_signal
語法:exec_kill_signal signal
上下文:rtmp, server, application
描述:設置進程終止信號。默認為 kill(SIGKILL)。你可以定義為數字或者符號名(POSIX.1-1990 信號)。
exec_kill_signal term;
exec_kill_signal usr1;
exec_kill_signal 3;

respawn
語法:respawn on|off
上下文:rtmp, server, application
描述:如果打開 respawn 子進程,進程終止時發布會仍然繼續。默認為打開。
respawn off;
respawn_timeout
語法:respawn_timeout timeout
上下文:rtmp, server, application
描述:啟動新的子實例之前,設置 respawn 超時時間。默認為五秒。
respawn_timeout 10s;
exec_publish
語法:exec_publish command arg*
上下文:rtmp, server, application
描述:指定發布事件觸發的帶有參數的外部命令。返回碼是未解析的。這里可以用 exec 替換。另外,args 變量支持持有查詢字符串參數。
exec_play
語法:exec_play command arg*
上下文:rtmp, server, application
描述:指定播放事件觸發的帶有參數的外部命令。返回碼是未解析的。替換列表同 exec_publish。
exec_play_done
語法:exec_play_done command arg*
上下文:rtmp, server, application
描述:指定播放結束事件觸發的帶有參數的外部命令。返回碼是未解析的。替換列表同 exec_publish。
exec_publish_done
語法:exec_publish_done command arg*
上下文:rtmp, server, application
描述:指定發布結束事件觸發的帶有參數的外部命令。返回碼是未解析的。替換列表同 exec_publish。
exec_record_done
語法:exec_record_done command arg*
上下文:rtmp, server, application, recorder
描述:指定錄制結束時觸發的帶有參數的外部命令。這里支持 exec_publish 的替代以及額外的變量 path 和 recorder。
**# track client info
exec_play bash -c "echo addrpageurl >> /tmp/clients";
exec_publish bash -c "echo addrflashver >> /tmp/publishers";

convert recorded file to mp4 format

exec_record_done ffmpeg -y -i path -acodec libmp3lame -ar 44100 -ac 1 -vcodec libx264path.mp4;**
Live
live
語法:live on|off
上下文:rtmp, server, application
描述:切換直播模式,即一對多廣播。
live on;
meta
語法:meta on|off
上下文:rtmp, server, application
描述:切換發送元數據到客戶端。默認為 on。
meta off;
interleave
語法:interleave on|off
上下文:rtmp, server, application
描述:切換交叉模式。在這個模式下,音頻和視頻數據會在同一個 RTMP chunk 流中傳輸。默認為 off。
interleave on;
wait_key
語法:wait_key on|off
上下文:rtmp, server, application
描述:使視頻流從一個關鍵幀開始。默認為 off。
wait_key on;
wait_video
語法:wait_video on|off
上下文:rtmp, server, application
描述:在第一個視頻幀發送之前禁用音頻。默認為 off。可以和 wait_key 進行組合以使客戶端可以收到具有所有其他數據的視頻關鍵幀。然而這通常增加連接延遲。您可以通過在編碼器中調整關鍵幀間隔來減少延遲。
wait_video on;
publish_notify
語法:publish_notify on|off
上下文:rtmp, server, application
描述:發送 NetStream.Publish.Start 和 NetStream.Publish.Stop 給用戶。默認為 off。
publish_notify on;
drop_idle_publisher
語法:drop_idle_publisher timeout
上下文:rtmp, server, application
描述:終止指定時間內閑置(沒有音頻/視頻數據)的發布連接。默認為 off。注意這個僅僅對于發布模式的連接起作用(發送 publish 命令之后)。
drop_idle_publisher 10s;
sync
語法:sync timeout
上下文:rtmp, server, application
描述:同步音頻和視頻流。如果用戶帶寬不足以接收發布率,服務器會丟棄一些幀。這將導致同步問題。當時間戳差超過 sync 指定的值,將會發送一個絕對幀來解決這個問題。默認為 300 ms。
sync 10ms;
play_restart
語法:play_restart on|off
上下文:rtmp, server, application
描述:使 nginx-rtmp 能夠在發布啟動或停止時發送 NetStream.Play.Start 和 NetStream.Play.Stop 到每個用戶。如果關閉的話,那么每個用戶就只能在回放的開始和結束時收到這些通知了。默認為 on。
play_restart off;
Record
record
語法:record [off|all|audio|video|keyframes|manual]*
上下文:rtmp, server, application, recorder
描述:切換錄制模式。流可以被記錄到 flv 文件。本指令指定應該被記錄的:

  • off - 什么也不錄制
  • all - 音頻和視頻(所有)
  • audio - 音頻
  • video - 視頻
  • keyframes - 只錄制關鍵視頻幀
  • manual - 用不自動啟動錄制,使用控制接口來啟動/停止
    在單個記錄指令中可以有任何兼容的組合鍵。
    **record all;

record audio keyframes;**
record_path
語法:record_path path
上下文:rtmp, server, application, recorder
描述:指定錄制的 flv 文件存放目錄。
record_path /tmp/rec;
record_suffix
語法:record_suffix value
上下文:rtmp, server, application, recorder
描述:設置錄制文件后綴名。默認為 '.flv'。
record_suffix _recorded.flv;
錄制后綴可以匹配 strftime 格式。以下指令
record_suffix -%d-%b-%y-%T.flv
將會產生形如 mystream-24-Apr-13-18:23:38.flv 的文件。所有支持 strftime 格式的選項可以在 strftime man page 里進行查找。
record_unique
語法:record_unique on|off
上下文:rtmp, server, application, recorder
描述:是否添加時間戳到錄制文件。否則的話同樣的文件在每一次新的錄制發生時將被重寫。默認為 off。
record_unique on;
record_append
語法:record_append on|off
上下文:rtmp, server, application, recorder
描述:切換文件附加模式。當這一指令為開啟是,錄制時將把新數據附加到老文件,如果老文件丟失的話將重新創建一個。文件中的老數據和新數據沒有時間差。默認為 off。
record_append on;
record_lock
語法:record_lock on|off
上下文:rtmp, server, application, recorder
描述:當這一指令開啟時,當前錄制文件將被 fcntl 調用鎖定。那樣可以在其他地方來核實哪個文件正在進行錄制。默認為 off。
record_lock on;
在 FreeBSD 上你可以使用 flock 工具檢查。在 Linux 上 flock 和 fcntl 無關,因此你需要去寫一個簡單的腳本來檢查文件的鎖定狀態。以下 isunlocked.py 是一個這樣的腳本的示例。

[python] view plain copy

  1. !/usr/bin/python

  2. import fcntl, sys

  3. sys.stderr.close()

  4. fcntl.lockf(open(sys.argv[1], "a"), fcntl.LOCK_EX|fcntl.LOCK_NB)

record_max_size
語法:record_max_size size
上下文:rtmp, server, application, recorder
描述:設置錄制文件的最大值。
record_max_size 128K;
record_max_frames
語法:record_max_frames nframes
上下文:rtmp, server, application, recorder
描述:設置每個錄制文件的視頻幀的最大數量。
record_max_frames 2;
record_interval
語法:record_interval time
上下文:rtmp, server, application, recorder
描述:在這個指令指定數量的(毫秒)秒之后重啟錄制。默認為 off。設置為 0 的話意味著錄制中無延遲。如果 record_unique 為 off 的話所有記錄片段會被寫到同一個文件。否則(文件名)將附以時間戳以區分不同文件(給定的 record_interval 要大于 1 秒)。
**record_interval 1s;

record_interval 15m;**
recorder
語法:recorder name {...}
上下文:application
描述:創建錄制塊。可以在單個 application 中創建多個記錄。上文提到的所有錄制相關的指令都可以在 recorder{} 塊中進行定義。繼承高層次中的所有設置。
**application {
live on;

# default recorder
record all;
record_path /var/rec;

recorder audio {
    record audio;
    record_suffix .audio.flv;
}

recorder chunked {
    record all;
    record_interval 15s;
    record_path /var/rec/chunked;
}

}**
record_notify
語法:record_notify on|off
上下文:rtmp, server, application, recorder
描述:切換當定義錄制啟動或停止文件時發送 NetStream.Record.Start 和 NetStream.Record.Stop 狀態信息(onStatus)到發布者。狀態描述字段保存錄制的名字(默認錄制的話為空)。默認為 off。
recorder myrec {
record all manual;
record_path /var/rec;
record_notify on;
}

VOD
play
語法:lay dir|http://loc [dir|http://loc]*
上下文:rtmp, server, application
描述:播放指定目錄或者 HTTP 地址的 flv 或者 mp4 文件。如果此參數前綴是 http:// 那么就認為文件可以在播放前從遠程 http 地址下載下來。注意播放是在整個文件下載完畢之后才開始。你可以使用本地 nginx 在本地機器緩存文件。
同一個 play 指令可以定義多個播放地址。當多個 play 指令定義時,地址列表將被合并,并進行從更高域中繼承。嘗試播放每一個地址,直到發現一個成功的地址。如果沒有找到成功地址,將發送錯誤狀態到客戶端。
索引的 FLV 播放具有隨機查找能力。沒有索引的 FLV 則不具備查找/暫停能力(重播模式)。使用 FLV 索引器(比如 yamdi)來編索引。
mp4 文件只有在音頻和視頻編碼都被 RTMP 支持時才可以播放。最常見的情況是 H264/AAC。
**application vod {
play /var/flvs;
}

application vod_http {
play http://myserver.com/vod;
}

application vod_mirror {
# try local location first, then access remote location
play /var/local_mirror http://myserver.com/vod;
}**
播放 /var/flvs/dir/file.flv:

[plain] view plain copy

  1. ffplay rtmp://localhost/vod/dir/file.flv

play_temp_path
語法:play_temp_path dir
上下文:rtmp, server, application
描述:在播放之前設置遠程存儲的 VOD 文件路徑。默認為 /tmp。
play_temp_path /www;
play http://example.com/videos;

play_local_path
語法:play_local_path dir
上下文:rtmp, server, application
描述:設置遠程 VOD 文件完全下載之后復制于 play_temp_path 之后的路徑。空值的話禁用此功能。默認為控制。這個功能可以用于緩存遠程文件在本地。
這一路徑應該和 play_temp_path 處于同一設備。
**# search file in /tmp/videos.

if not found play from remote location

and store in /tmp/videos

play_local_path /tmp/videos;
play /tmp/videos http://example.com/videos;**
Relay
pull
語法:pull url [key=value]*
上下文:application
描述:創建 pull 中繼。流將從遠程服務器上拉下來,成為本地可用的。僅當至少有一個播放器正在播放本地流時發生。
Url 語法:[rtmp://]host[:port][/app[/playpath]]。如果 application 找不著那么將會使用本地 application 名。如果找不著 playpath 那么就是用當前流的名字。
支持以下參數:

  • app - 明確 application 名。
  • name - 捆綁到 relay 的本地流名字。如果為空或者沒有定義,那么將會使用 application 中的所有本地流。
  • tcUrl - 如果為空的話自動構建。
  • pageUrl - 模擬頁面 url。
  • swfUrl - 模擬 swf url。
  • flashVer - 模擬 flash 版本,默認為 'LNX.11,1,102,55'。
  • playPath - 遠程播放地址。
  • live - 切換直播特殊行為,值:0,1。
  • start - 開始時間。
  • stop - 結束時間。
  • static - 創建靜態 pull,這樣的 pull 在 nginx 啟動時創建。
    如果某參數的值包含空格,那么你應該在整個 key=value 對周圍使用引號,比如:'pageUrl=FAKE PAGE URL'。
    **pull rtmp://cdn.example.com/main/ch?id=12563 name=channel_a;

pull rtmp://cdn2.example.com/another/a?b=1&c=d pageUrl=http://www.example.com/video.html swfUrl=http://www.example.com/player.swf live=1;

pull rtmp://cdn.example.com/main/ch?id=12563 name=channel_a static;**
push
語法:push url [key=value]*
上下文:application
描述:push 的語法和 pull 一樣。不同于 pull 指令的是 push 推送發布流到遠程服務器。
push_reconnect
語法:push_reconnect time
上下文:rtmp, server, application
描述:在斷開連接后,在 push 重新連接前等待的時間。默認為 3 秒。
push_reconnect 1s;
session_relay
語法:session_relay on|off
上下文:rtmp, server, application
描述:切換會話 relay 模式。在這種模式下連接關閉時 relay 銷毀。當設置為 off 時,流關閉,relay 銷毀,這樣子以后另一個 relay 可以被創建。默認為 off。
session_relay on;
Notify
on_connect
語法:on_connect url
上下文:rtmp, server
描述:設置 HTTP 連接回調。當客戶分發連接命令一個連接命令時,一個 HTTP 請求異步發送,命令處理將被暫停,直到它返回結果代碼。當 HTTP 2XX 碼(成功狀態碼)返回時,RTMP 會話繼續。返回碼 3XX (重定向狀態碼)會使 RTMP 重定向到另一個從 HTTP 返回頭里獲取到的 application。否則(其他狀態碼)連接丟棄。
注意這一指令在 application 域是不允許的,因為 application 在連接階段還是未知的。
HTTP 請求接收到一些參數。在 application/x-www-form-urlencoded MIME 類型下使用 POST 方法。以下參數將被傳給調用者:

  • call=connect。
  • addr - 客戶端 IP 地址。
  • app - application 名。
  • flashVer - 客戶端 flash 版本。
  • swfUrl - 客戶端 swf url。
  • tcUrl - tcUrl。
  • pageUrl - 客戶端頁面 url。
    除了上述參數以外,所有顯式傳遞給連接命令的參數也由回調發送。你應該將連接參數和 play/publish 參數區分開。播放器常常有獨特的方式設置連接字符串不同于 play/publish 流名字。這里是 JWPayer 是如何設置這些參數的一個示例:

[plain] view plain copy

  1. ...
  2. streamer: "rtmp://localhost/myapp?connarg1=a&connarg2=b",
  3. file: "mystream?strarg1=c&strarg2=d",
  4. ...

Ffplay(帶有 librtmp)示例:

[plain] view plain copy

  1. ffplay "rtmp://localhost app=myapp?connarg1=a&connarg2=b playpath=mystream?strarg1=c&strarg2=d"

使用例子:
on_connect http://example.com/my_auth;
重定向例子:
location /on_connect {
if (arg_flashver != "my_secret_flashver") { rewrite ^.* fallback? permanent;
}
return 200;
}

on_play
語法:on_play url
上下文:rtmp, server, application
描述:設置 HTTP 播放回調。每次一個客戶分發播放命令時,一個 HTTP 請求異步發送,命令處理會掛起 - 直到它返回結果碼。之后再解析 HTTP 結果碼。

  • HTTP 2XX 返回碼的話繼續 RTMP 會話。
  • HTTP 3XX 返回碼的話 重定向 RTMP 到另一個流,這個流的名字在 HTTP 返回頭的 Location 獲取。如果新流的名字起始于 rtmp:// 然后遠程 relay 會被創建。relay 要求 IP 地址是指定的而不是域名,并且只工作在 1.3.10 版本以上的 nginx。另請參考 notify_relay_redirect。
  • 其他返回碼的話 RTMP 連接丟棄。
    重定向例子:
    *http {
    ...
    location /local_redirect {
    rewrite ^.
    newname? permanent; } location /remote_redirect { # no domain name here, only ip rewrite ^.* rtmp://192.168.1.123/someapp/somename? permanent;
    }
    ...
    }

rtmp {
...
application myapp1 {
live on;
# stream will be redirected to 'newname'
on_play http://localhost:8080/local_redirect;
}
application myapp2 {
live on;
# stream will be pulled from remote location
# requires nginx >= 1.3.10
on_play http://localhost:8080/remote_redirect;
}
...
}**
HTTP 請求接收到一些個參數。在 application/x-www-form-urlencoded MIME 類型下使用 POST 方法。以下參數會被傳送給調用者:

  • call=play。
  • addr - 客戶端 IP 地址。
  • app - application 名。
  • flashVer - 客戶端 flash 版本。
  • swfUrl - 客戶端 swf url。
  • tcUrl - tcUrl。
  • pageUrl - 客戶端頁面 url。
  • name - 流名。
    出了上述參數之外其他所有播放命令參數顯式地發送回調。例如如果一個流由 url rtmp://localhost/app/movie?a=100&b=face&foo=bar 訪問,然后呢 a,b 和 foo 發送回調。
    on_play http://example.com/my_callback;
    on_publish
    語法:on_publish url
    上下文:rtmp, server, application
    描述:同上面提到的 on_play 一樣,唯一的不同點在于這個指令在發布命令設置回調。不同于遠程 pull,push 在這里是可以的。
    on_done
    語法:on_done url
    上下文:rtmp, server, application
    描述:設置播放/發布禁止回調。上述所有適用于此。但這個回調并不檢查 HTTP 狀態碼。
    on_play_done
    語法:on_publish_done url
    上下文:rtmp, server, application
    描述:等同于 on_done 的表現,但只適用于播放結束事件。
    on_publish_done
    語法:on_publish_done url
    上下文:rtmp, server, application
    描述:等同于 on_done 的表現,但只適用于發布結束事件。
    on_record_done
    語法:on_record_done url
    上下文:rtmp, server, application, recorder
    描述:設置 record_done 回調。除了普通 HTTP 回調參數它接受錄制文件路徑。
    on_record_done http://example.com/recorded;
    on_update
    語法:on_update url
    上下文:rtmp, server, application
    描述:設置 update 回調。這個回調會在 notify_update_timeout 期間調用。如果一個請求返回結果不是 2XX,連接禁止。這可以用來同步過期的會話。追加 time 參數即播放/發布調用后的秒數會被發送給處理程序。
    on_update http://example.com/update;
    notify_update_timeout
    語法:notify_update_timeout timeout
    上下文:rtmp, server, application
    描述:在 on_update 回調之間的超時設置。默認為 30 秒。
    notify_update_timeout 10s;
    on_update http://example.com/update;

    notify_update_strict
    語法:notify_update_strict on|off
    上下文:rtmp, server, application
    描述:切換 on_update 回調嚴格模式。默認為 off。當設置為 on 時,所有連接錯誤,超時以及 HTTP 解析錯誤和空返回會被視為更新失敗并導致連接終止。當設置為 off 時只有 HTTP 返回碼不同于 2XX 時導致失敗。
    notify_update_strict on;
    on_update http://example.com/update;

    notify_relay_redirect
    語法:notify_relay_redirect on|off
    上下文:rtmp, server, application
    描述:使本地流可以重定向為 on_play 和 on_publish 遠程重定向。新的流名字是 RTMP URL 用于遠程重定向。默認為 off。
    notify_relay_redirect on;
    notify_method
    語法:notify_method get|post
    上下文:rtmp, server, application, recorder
    描述:設置 HTTP 方法通知。默認是帶有 application/x-www-form-urlencoded 的 POST 內容類型。在一些情況下 GET 更好,例如如果你打算在 nginx 的 http{} 部分處理調用。在這種情況下你可以使用 arg_* 變量去訪問參數。
    notify_method get;
    在 http{} 部分使用 GET 方法處理通知可以使用這種方法:
    location /on_play {
    if (arg_pageUrl ~* localhost) { return 200; } return 500; }** **HLS** hls 語法:hls on|off 上下文:rtmp, server, application 描述:在 application 切換 HLS。 **hls on; hls_path /tmp/hls; hls_fragment 15s;** 在 http{} 段為客戶端播放 HLS 設置在以下位置設置: **http { ... server { ... location /hls { types { application/vnd.apple.mpegurl m3u8; } alias /tmp/hls; } } }** hls_path 語法:hls_path path 上下文:rtmp, server, application 描述:設置 HLS 播放列表和分段目錄。這一目錄必須在 NGINX 啟動前就已存在。 hls_fragment 語法:hls_fragment time 上下文:rtmp, server, application 描述:設置 HLS 分段長度。默認為 5 秒鐘。 hls_playlist_length 語法:hls_playlist_length time 上下文:rtmp, server, application 描述:設置 HLS 播放列表長度。默認為 30 秒鐘。 **hls_playlist_length 10m;** hls_sync 語法:hls_sync time 上下文:rtmp, server, application 描述:設置 HLS 時間戳同步閾值。默認為 2 ms。這一功能可以防止由低分辨率 RTMP (1KHz) 轉換到高分辨率 MPEG-TS (90KHz) 之后出現噪音。 **hls_sync 100ms;** hls_continuous 語法:hls_continuous on|off 上下文:rtmp, server, application 描述:切換 HLS 連續模式。這一模式下 HLS 序列號由其上次停止的最后時間開始。老的分段保留下來。默認為 off。 **hls_continuous on;** hls_nested 語法:hls_nested on|off 上下文:rtmp, server, application 描述:切換 HLS 嵌套模式。這一模式下為每個流創建了一個 hls_path 的子目錄。播放列表和分段在那個子目錄中創建。默認為 off。 **hls_nested on;** hls_cleanup 語法:hls_cleanup on|off 上下文:rtmp, server, application 描述:切換 HLS 清理。這一功能默認為開啟的。在這一模式下 nginx 緩存管理進程將老的 HLS 片段和播放列表由 HLS 清理掉。 **hls_cleanup off;** **Access log** access_log 語法:access_log off|path [format_name] 上下文:rtmp, server, application 描述:設置訪問日志參數。日志默認是開啟的。關閉日志可以使用 access_log off 指令。默認情況下訪問日志和 HTTP 訪問日志 logs/access.log 放到同一文件。你也可以使用 access_log 指令將其定義到其他日志文件。第二個參數是可選的。可以根據名字來定義日志格式。請參考 log_format 指令來獲取更多關于格式的詳細信息。 **log_format new 'remote_addr';
    access_log logs/rtmp_access.log new;
    access_log logs/rtmp_access.log;
    access_log off;

    log_format
    語法:log_format format_name format
    上下文:rtmp
    描述:創建指定的日志格式。日志格式看起來很像 nginx HTTP 日志格式。日志格式里支持的幾個變量有:
  • connection - 連接數。
  • remote_addr - 客戶端地址。
  • app - application 名。
  • name - 上一個流名。
  • args - 上一個流播放/發布參數。
  • flashver - 客戶端 flash 版本。
  • swfurl - 客戶端 swf url。
  • tcurl - 客戶端 tcUrl。
  • pageurl - 客戶端頁面 url。
  • command - 客戶端發送的播放/發布命令:NONE、PLAY、PUBLISH、PLAY+PUBLISH。
  • bytes_sent - 發送到客戶端的字節數。
  • bytes_received - 從客戶端接收到的字節數。
  • time_local - 客戶端連接結束的本地時間。
  • session_time - 持續連接的秒數。
  • session_readable_time - 在可讀格式下的持續時間。
    默認的日志格式叫做 combined。這里是這一格式的定義:
    remote_addr [time_local] command "app" "name" "args" -
    bytes_receivedbytes_sent "pageurl" "flashver" ($session_readable_time)

    Limits
    max_connections
    語法:max_connections number
    上下文:rtmp, server, application
    描述:為 rtmp 引擎設置最大連接數。默認為 off。
    max_connections 100;
    Statistics
    statistics 模塊不同于本文列舉的其他模塊,它是 NGINX HTTP 模塊。因此 statistics 指令應該位于 http{} 塊內部。
    rtmp_stat
    語法:rtmp_stat all
    上下文:http, server, location
    描述:為當前 HTTP location 設置 RTMP statistics 處理程序。RTMP statistics 是一個靜態的 XML 文檔。可以使用 rtmp_stat_stylesheet 指令在瀏覽器中作為 XHTML 頁面查看這個文檔。
    http {
    server {
    location /stat {
    rtmp_stat all;
    rtmp_stat_stylesheet stat.xsl;
    }
    location /stat.xsl {
    root /path/to/stat/xsl/file;
    }
    }
    }

    rtmp_stat_stylesheet
    語法:rtmp_stat_stylesheet path
    上下文:http, server, location
    描述:添加 XML 樣式表引用到 statistics XML 使其可以在瀏覽器中可視。更多信息請參考 rtmp_stat 描述和例子。
    Multi-worker live streaming
    多 worker 直播流是通過推送流到剩余的 nginx worker 實現的。
    rtmp_auto_push
    語法:rtmp_auto_push on|off
    上下文:root
    描述:切換自動推送(多 worker 直播流)模式。默認為 off。
    rtmp_auto_push_reconnect
    語法:rtmp_auto_push_reconnect timeout
    上下文:root
    描述:當 worker 被干掉時設置自動推送連接超時時間。默認為 100 毫秒。
    rtmp_socket_dir
    語法:rtmp_socket_dir dir
    上下文:root
    描述:設置用于流推送的 UNIX 域套接字目錄。默認為 /tmp。
    **rtmp_auto_push on;
    rtmp_auto_push_reconnect 1s;
    rtmp_socket_dir /var/sock;

rtmp {
server {
listen 1935;
application myapp {
live on;
}
}
}**
Control
control 模塊是 NGINX HTTP 模塊,應該放在 http{} 塊之內。
rtmp_control
語法:rtmp_control all
上下文:http, server, location
描述:為當前 HTTP location 設置 RTMP 控制程序。
http {
server {
location /control {
rtmp_control all;
}
}
}

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,983評論 6 537
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,772評論 3 422
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,947評論 0 381
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,201評論 1 315
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,960評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,350評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,406評論 3 444
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,549評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,104評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,914評論 3 356
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,089評論 1 371
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,647評論 5 362
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,340評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,753評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,007評論 1 289
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,834評論 3 395
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,106評論 2 375

推薦閱讀更多精彩內容