Debug log

cd nginx-X.Y.Z./configure --add-module=/path/to/nginx-rtmp-module --with-debug ...

编译一套nginx的error.log中水平nginx.conf调试后

error_log logs/error.log debug;

这之后，你将有很多的error.log中调试信息。

Exec wrapper in bash

你可以用任何语言编写的exec包装。然而，你应该注意终止进程。当出版商关闭流的所有执行处理被终止。如果指定的exec指令，而不是真正的ffmpeg的包装，那么你最终可能会与你的ffmpeg还活着，孤儿，直到超时读取输入数据。

该解决办法是用信号陷阱。下面是在bash这种包装的一个例子。

#!/bin/bashon_die (){    # kill all children    pkill -KILL -P $$}trap 'on_die' TERMffmpeg -i rtmp://localhost/myapp/$1 -c copy -f flv rtmp://localhost/myapp2/$1 &wait

该脚本注册它终止子的ffmpeg SIGTERM处理器。 nginx的，RTMP发送默认的信号是SIGKILL不能被捕获。对于上面的脚本按预期的行为，你需要exec_kill_signal指令来改变EXEC终止信号。它接受数字或符号信号名称（POSIX.1-1990信号）。这里的示例应用程序。

application myapp {    live on;    exec /var/scripts/exec_wrapper.sh $name;    exec_kill_signal term;}application myapp2 {    live on;}

Examples 一些实例

简单的视频点播

rtmp {    server {        listen 1935;        application vod {            play /var/flvs;        }    }}

简单的直播服务

rtmp {    server {        listen 1935;        application live {            live on;        }    }}

重新翻译远程流

rtmp {    server {        listen 1935;        application tv {            live on;            pull rtmp://cdn.example.com:443/programs/main pageUrl=http://www.example.com/index.html name=maintv;        }    }}

重新翻译与HLS支持远程流

rtmp {    server {        listen 1935;        application tv {            live on;            hls on;            hls_path /tmp/tv2;            hls_fragment 15s;            pull rtmp://tv2.example.com:443/root/new name=tv2;        }    }}http {    server {        listen 80;        location /tv2 {            alias /tmp/tv2;        }    }}

物流通过RTMP你的X屏幕

ffmpeg -f x11grab -follow_mouse centered -r 25 -s cif -i :0.0 -f flv rtmp://localhost/myapp/screen

Set up live streaming

要建立RTMP支持，你需要添加RTMP{}部分nginx.conf（PREFIX/conf/nginx.conf)）。股票nginx.conf只包含HTTP{}部分。

使用此nginx.conf，而不是原始的配置：

#user  nobody;worker_processes  1;error_log  logs/error.log debug;events {    worker_connections  1024;}http {    include       mime.types;    default_type  application/octet-stream;    sendfile        on;    keepalive_timeout  65;    server {        listen       8080;        server_name  localhost;        # sample handlers        #location /on_play {
                #    if ($arg_pageUrl ~* localhost) {
                #        return 201;        #    }        #    return 202;        #}        #location /on_publish {
                #    return 201;        #}        #location /vod {
                #    alias /var/myvideos;        #}        # rtmp stat        location /stat {            rtmp_stat all;            rtmp_stat_stylesheet stat.xsl;        }        location /stat.xsl {            # you can move stat.xsl to a different location            root /usr/build/nginx-rtmp-module;        }        # rtmp control        location /control {            rtmp_control all;        }        error_page   500 502 503 504  /50x.html;        location = /50x.html {            root   html;        }    }}rtmp {    server {        listen 1935;        ping 30s;        notify_method get;        application myapp {            live on;            # sample play/publish handlers            #on_play http://localhost:8080/on_play;            #on_publish http://localhost:8080/on_publish;            # sample recorder            #recorder rec1 {
                    #    record all;            #    record_interval 30s;            #    record_path /tmp;            #    record_unique on;            #}            # sample HLS            #hls on;            #hls_path /tmp/hls;            #hls_sync 100ms;        }        # Video on demand        #application vod {
                #    play /var/Videos;        #}        # Video on demand over HTTP        #application vod_http {
                #    play http://localhost:8080/vod/;        #}    }}

Statistics (统计)

在浏览器中输入 http://localhost:8080/stat 看到目前的流媒体统计，连接的客户端，带宽等。

Publishing with ffmpeg

发布现场视频流最简单的方法是使用的ffmpeg（或avconv）。它已经安装在大多数系统中，也方便安装在其他的上面。

RTMP仅支持的编解码器的数量有限。最流行的RTMP视频编解码器是H264，索伦森-H263（又名FLV）和音频编解码器AAC，MP3，得到Nellymoser，Speex语音。

如果您的视频与这些编解码器编码（最常见的是对H264 / AAC），那么你不需要任何转换。否则，你需要将视频转换为支持的编解码之一。

我们将流测试文件 /var/videos/test.mp4 to server with ffmpeg.

Streaming without conversion (given test.mp4 codecs are compatible with RTMP)

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

Streaming and encoding audio (AAC) and video (H264), need libx264 and libfaac

ffmpeg -re -i /var/Videos/test.mp4 -c:v libx264 -c:a libfaac -ar 44100 -ac 1 -f flv rtmp://localhost/myapp/mystream

Streaming and encoding audio (MP3) and video (H264), need libx264 and libmp3lame

ffmpeg -re -i /var/Videos/test.mp4 -c:v libx264 -c:a libmp3lame -ar 44100 -ac 1 -f flv rtmp://localhost/myapp/mystream

Streaming and encoding audio (Nellymoser) and video (Sorenson H263)

ffmpeg -re -i /var/Videos/test.mp4 -c:v flv -c:a nellymoser -ar 44100 -ac 1 -f flv rtmp://localhost/myapp/mystream

Publishing video from webcam

ffmpeg -f video4linux2 -i /dev/video0 -c:v libx264 -an -f flv rtmp://localhost/myapp/mystream

Playing with ffplay

ffplay rtmp://localhost/myapp/mystream

Publishing and playing with flash

See test/rtmp-publisher directory for test flash applets and html.

核心

application

timeout 超时

ping

ping_timeout

max_streams 单一流数据最大限制

ack_window

chunk_size 数据块大小

max_queue 最大队列数

max_message

buflen 缓冲区

out_queue

out_cork

Access 访问控制

allow

deny

Exec

exec_push

env PATH;

exec_pull

exec

exec_options

exec_static

exec_kill_signal

respawn

respawn_timeout

exec_publish

exec_play

exec_play_done

exec_publish_done

exec_record_done

Live

live

meta

interleave

wait_key

wait_video

publish_notify

drop_idle_publisher

sync

play_restart

idle_streams

record

record_path

record_suffix

record_unique

record_append

record_lock

record_max_size

record_max_frames

record_interval

recorder

record_notify

Video on demand 视频点播

play

play_temp_path

play_local_path

Relay 中继

pull

push

push_reconnect

session_relay

Notify

on_connect

on_play

on_publish

on_done

on_play_done

on_publish_done

on_record_done

on_update

notify_update_timeout

notify_update_strict

notify_relay_redirect

notify_method

HLS

hls_path

hls_fragment

hls_playlist_length

hls_sync

`deny`

`exec_kill_signal`