├── .dockerignore
├── .gitignore
├── .travis.yml
├── Dockerfile
├── README.md
└── run.sh


/.dockerignore:
--------------------------------------------------------------------------------
1 | .travis.yml
2 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | .*.swp
2 | 


--------------------------------------------------------------------------------
/.travis.yml:
--------------------------------------------------------------------------------
 1 | sudo:
 2 |   - required
 3 | language:
 4 |   - bash
 5 | services:
 6 |   - docker
 7 | 
 8 | install:
 9 |   - git clone https://github.com/JasonRivers/Docker-nginx-rtmp.git ~/Docker-nginx-rtmp
10 | 
11 | script:
12 |   - docker build -t nginx-rtmp .
13 | 
14 | 


--------------------------------------------------------------------------------
/Dockerfile:
--------------------------------------------------------------------------------
 1 | FROM alpine:latest as builder
 2 | 
 3 | ARG NGINX_VERSION=1.21.1
 4 | ARG NGINX_RTMP_VERSION=1.2.2
 5 | 
 6 | 
 7 | RUN	apk update		&&	\
 8 | 	apk add				\
 9 | 		git			\
10 | 		gcc			\
11 | 		binutils		\
12 | 		gmp			\
13 | 		isl			\
14 | 		libgomp			\
15 | 		libatomic		\
16 | 		libgcc			\
17 | 		openssl			\
18 | 		pkgconf			\
19 | 		pkgconfig		\
20 | 		mpc1			\
21 | 		libstdc++		\
22 | 		ca-certificates		\
23 | 		libssh2			\
24 | 		curl			\
25 | 		expat			\
26 | 		pcre			\
27 | 		musl-dev		\
28 | 		libc-dev		\
29 | 		pcre-dev		\
30 | 		zlib-dev		\
31 | 		openssl-dev		\
32 | 		curl			\
33 | 		make
34 | 
35 | 
36 | RUN	cd /tmp/									&&	\
37 | 	curl --remote-name http://nginx.org/download/nginx-${NGINX_VERSION}.tar.gz			&&	\
38 | 	git clone https://github.com/arut/nginx-rtmp-module.git -b v${NGINX_RTMP_VERSION}
39 | 
40 | RUN	cd /tmp										&&	\
41 | 	tar xzf nginx-${NGINX_VERSION}.tar.gz						&&	\
42 | 	cd nginx-${NGINX_VERSION}							&&	\
43 | 	./configure										\
44 | 		--prefix=/opt/nginx								\
45 | 		--with-http_ssl_module								\
46 | 		--add-module=../nginx-rtmp-module					&&	\
47 | 	make										&&	\
48 | 	make install
49 | 
50 | FROM alpine:latest
51 | LABEL org.opencontainers.image.authors="jason@jasonrivers.co.uk"
52 | RUN apk update		&& \
53 | 	apk add			   \
54 | 		openssl		   \
55 | 		libstdc++	   \
56 | 		ca-certificates	   \
57 | 		pcre
58 | 
59 | COPY --from=0 /opt/nginx /opt/nginx
60 | COPY --from=0 /tmp/nginx-rtmp-module/stat.xsl /opt/nginx/conf/stat.xsl
61 | RUN rm /opt/nginx/conf/nginx.conf
62 | ADD run.sh /
63 | 
64 | EXPOSE 1935
65 | EXPOSE 8080
66 | 
67 | CMD /run.sh
68 | 
69 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # Docker-nginx-rtmp
 2 | Docker image for an RTMP/HLS server running on nginx
 3 | 
 4 | * NGINX Version 1.21.1
 5 | * nginx-rtmp-module Version 1.2.2
 6 | 
 7 | ## Configurations
 8 | This image exposes port 1935 for RTMP Steams and has 2 default channels open "live" and "testing".
 9 | 
10 | live (or your first stream name) is also accessable via HLS on port 8080
11 | 
12 | It also exposes 8080 so you can access http://<your server ip>:8080/stat to see the streaming statistics.
13 | 
14 | The configuration file is in /opt/nginx/conf/
15 | 
16 | ## Running
17 | 
18 | To run the container and bind the port 1935 to the host machine; run the following:
19 | ```
20 | docker run -p 1935:1935 -p 8080:8080 jasonrivers/nginx-rtmp
21 | ```
22 | 
23 | ### Multiple Streams:
24 | You can enable multiple streams on the container by setting RTMP_STREAM_NAMES when launching, This is a comma seperated list of names, E.G.
25 | ```
26 | docker run      \
27 |     -p 1935:1935        \
28 |     -p 8080:8080        \
29 |     -e RTMP_STREAM_NAMES=live,teststream1,teststream2   \
30 |     jasonrivers/nginx-rtmp
31 | ```
32 | 
33 | ### Pushing streams
34 | You can ush your main stream out to other RTMP servers, Currently this is limited to only the first stream in RTMP_STREAM_NAMES (default is live) by setting RTMP_PUSH_URLS when launching, This is a comma seperated list of URLS, EG:
35 | ```
36 | docker run      \
37 |     -p 1935:1935        \
38 |     -p 8080:8080        \
39 |     -e RTMP_PUSH_URLS=rtmp://live.youtube.com/myname/streamkey,rtmp://live.twitch.tv/app/streamkey
40 |     jasonrivers/nginx-rtmp
41 | ```
42 | 
43 | ## OBS Configuration
44 | Under broadcast settings, set the follwing parameters:
45 | ```
46 | Streaming Service: Custom
47 | Server: rtmp://<your server ip>/live
48 | Play Path/Stream Key: mystream
49 | ```
50 | 
51 | ## Watching the steam
52 | 
53 | In your favorite RTMP video player connect to the stream using the URL:
54 | rtmp://&lt;your server ip&gt;/live/mystream
55 | http://&lt;your server ip&gt;/hls/mystream.m3u8
56 | 
57 | ## Tested players
58 |  * VLC
59 |  * omxplayer (Raspberry Pi)
60 | 


--------------------------------------------------------------------------------
/run.sh:
--------------------------------------------------------------------------------
  1 | #!/bin/sh
  2 | 
  3 | NGINX_CONFIG_FILE=/opt/nginx/conf/nginx.conf
  4 | 
  5 | 
  6 | RTMP_CONNECTIONS=${RTMP_CONNECTIONS-1024}
  7 | RTMP_STREAM_NAMES=${RTMP_STREAM_NAMES-live,testing}
  8 | RTMP_STREAMS=$(echo ${RTMP_STREAM_NAMES} | sed "s/,/\n/g")
  9 | RTMP_PUSH_URLS=$(echo ${RTMP_PUSH_URLS} | sed "s/,/\n/g")
 10 | 
 11 | apply_config() {
 12 | 
 13 |     echo "Creating config"
 14 | ## Standard config:
 15 | 
 16 | cat >${NGINX_CONFIG_FILE} <<!EOF
 17 | worker_processes 1;
 18 | 
 19 | events {
 20 |     worker_connections ${RTMP_CONNECTIONS};
 21 | }
 22 | !EOF
 23 | 
 24 | ## HTTP / HLS Config
 25 | cat >>${NGINX_CONFIG_FILE} <<!EOF
 26 | http {
 27 |     include             mime.types;
 28 |     default_type        application/octet-stream;
 29 |     sendfile            on;
 30 |     keepalive_timeout   65;
 31 | 
 32 |     server {
 33 |         listen          8080;
 34 |         server_name     localhost;
 35 | 
 36 |         location /hls {
 37 |             types {
 38 |                 application/vnd.apple.mpegurl m3u8;
 39 |                 video/mp2ts ts;
 40 |             }
 41 |             root /tmp;
 42 |             add_header  Cache-Control no-cache;
 43 |             add_header  Access-Control-Allow-Origin *;
 44 |         }
 45 | 
 46 |         location /on_publish {
 47 |             return  201;
 48 |         }
 49 |         location /stat {
 50 |             rtmp_stat all;
 51 |             rtmp_stat_stylesheet stat.xsl;
 52 |         }
 53 |         location /stat.xsl {
 54 |             alias /opt/nginx/conf/stat.xsl;
 55 |         }
 56 |         location /control {
 57 |             rtmp_control all;
 58 |         }
 59 |         
 60 |         error_page  500 502 503 504 /50x.html;
 61 |         location = /50x.html {
 62 |             root html;
 63 |         }
 64 |     }
 65 | }
 66 |         
 67 | !EOF
 68 | 
 69 | 
 70 | ## RTMP Config
 71 | cat >>${NGINX_CONFIG_FILE} <<!EOF
 72 | rtmp {
 73 |     server {
 74 |         listen 1935;
 75 |         chunk_size 4096;
 76 | !EOF
 77 | 
 78 | if [ "x${RTMP_PUSH_URLS}" = "x" ]; then
 79 |     PUSH="false"
 80 | else
 81 |     PUSH="true"
 82 | fi
 83 | 
 84 | HLS="true"
 85 | 
 86 | for STREAM_NAME in $(echo ${RTMP_STREAMS}) 
 87 | do
 88 | 
 89 | echo Creating stream $STREAM_NAME
 90 | cat >>${NGINX_CONFIG_FILE} <<!EOF
 91 |         application ${STREAM_NAME} {
 92 |             live on;
 93 |             record off;
 94 |             on_publish http://localhost:8080/on_publish;
 95 | !EOF
 96 | if [ "${HLS}" = "true" ]; then
 97 | cat >>${NGINX_CONFIG_FILE} <<!EOF
 98 |             hls on;
 99 |             hls_path /tmp/hls;
100 |             hls_fragment    1;
101 |             hls_playlist_length     20;
102 | !EOF
103 |     HLS="false"
104 | fi
105 |     if [ "$PUSH" = "true" ]; then
106 |         for PUSH_URL in $(echo ${RTMP_PUSH_URLS}); do
107 |             echo "Pushing stream to ${PUSH_URL}"
108 |             cat >>${NGINX_CONFIG_FILE} <<!EOF
109 |             push ${PUSH_URL};
110 | !EOF
111 |             PUSH=false
112 |         done
113 |     fi
114 | cat >>${NGINX_CONFIG_FILE} <<!EOF
115 |         }
116 | !EOF
117 | done
118 | 
119 | cat >>${NGINX_CONFIG_FILE} <<!EOF
120 |     }
121 | }
122 | !EOF
123 | }
124 | 
125 | if ! [ -f ${NGINX_CONFIG_FILE} ]; then
126 |     apply_config
127 | else
128 |     echo "CONFIG EXISTS - Not creating!"
129 | fi
130 | 
131 | echo "Starting server
132 | /opt/nginx/sbin/nginx -g "daemon off;"
133 | 
134 | 


--------------------------------------------------------------------------------