thomaswoo/nginx-rtmp repository overview

⁠docker-nginx-rtmp

Docker build file for nginx with nginx-rtmp-module. Act as a rtmp & hls streaming server. Based on Alpine Linux.

Nginx 服务器 + nginx-rtmp-module 模块的 Dockerfile，用于搭建 rtmp + hls 流媒体服务器。基于 Alpine Linux。

中文文档⁠

• Nginx 1.20.2
• nginx-rtmp-module 1.2.2

⁠Usage

⁠Server

• Pull docker image and run a test flight :

docker pull thomaswoo/nginx-rtmp
docker run -it --rm -p 1935:1935 -p 8080:80 thomaswoo/nginx-rtmp

or build it by yourself and run:

docker build -t nginx-rtmp .
docker run -it --rm -p 1935:1935 -p 8080:80 nginx-rtmp

• If the test flight runs well, start a daemon :

docker run -d -p 1935:1935 -p 8080:80 --name nginx-rtmp-server --restart=always thomaswoo/nginx-rtmp

• Mount your own config file by :

docker run -d -p 1935:1935 -p 8080:80 -v /path/to/nginx.conf:/etc/nginx/nginx.conf.template --name nginx-rtmp-server --restart=always thomaswoo/nginx-rtmp

• Set autoindex on hls path :

docker run -d -p 1935:1935 -p 8080:80 -e HLS_AUTO_INDEX=on --name nginx-rtmp-server --restart=always thomaswoo/nginx-rtmp

⁠Start Stream

• Push an rtmp stream to :

rtmp://<server_ip>:1935/stream/<stream_name>

⁠Watch Stream

• Watch RTMP stream at :

rtmp://<server_ip>:1935/stream/<stream_name>

• Watch HLS/m3u8 stream at :

http://<server_ip>:8080/live/<stream_name>.m3u8

⁠Check Stream Status

• Open link in browser:

http://<server_ip>:8080/stat

The default username/password is admin/admin.

Change username/password by create a new htpasswd file and mount to : /etc/nginx/htpasswd_admin

⁠Reference

• https://alpinelinux.org/⁠
• https://nginx.org⁠
• https://github.com/arut/nginx-rtmp-module⁠
• https://obsproject.com/⁠