Docker NGINX VOD Module

A Dockerized NGINX build with the nginx-vod-module and ngx_aws_auth for serving VOD content to DASH, HLS, and MSS.

nginx-vod-module is configured in remote-mode with ngx_aws_auth to securely serve content stored in a private S3 bucket.

Setup

Requirements

Docker
AWS Account for S3
Python 2.7

Setup AWS Credentials

Create an AWS account and S3 Bucket (private)
Create a user via IAM with Programmatic Access and read access to the S3 Bucket
Run python scripts/generate_signing_key.py -k <aws secret access key> -r <aws region> to generate a signing_key and key_scope.

Setup Server

Configure docker-compose.yml with the following environment variables:

- AWS_ACCESS_KEY=<aws access key>
- AWS_S3_BUCKET=<aws s3 bucket>
- AWS_SIGNING_KEY=<aws signing key from script>
- AWS_KEY_SCOPE=<aws key scope from script>

Start server:

docker-compose up

Test Upload an MP4 to your S3 bucket and load the manifest to test different outputs:
DASH - http://localhost:8080/dash/video.mp4/manifest.mpd
HLS - http://localhost:8080/hls/video.mp4/master.m3u8
MSS - http://localhost:8080/mss/video.mp4/manifest

λ curl -I http://localhost:8080/dash/video.mp4/manifest.mpd
HTTP/1.1 200 OK

Use one of the players below to test playback.

Setup CDN

TODO

Demo

Type	Source	URL
DASH	Origin	Shaka Player
HLS	Origin	HLS.js PLayer
MSS	Origin	HASPlayer.js
DASH	CDN	Shaka Player
HLS	CDN	HLS.js Player
MSS	CDN	HASPlayer.js

hataiit9x/docker-nginx-vod-module