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/bash

on_die ()
{
    # kill all children
    pkill -KILL -P $$
}

trap 'on_die' TERM
ffmpeg -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.

视频直播点播nginx-rtmp开发手册中文版

核心

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

`deny`

`exec_kill_signal`