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

Test Players

HTML5 Players for testing.

• https://shaka-player-demo.appspot.com
• http://video-dev.github.io/hls.js/demo/
• http://orange-opensource.github.io/hasplayer.js/

TODO

• DRM Example
• Test with S3-compatible APIs (Digital Ocean Spaces)

References

• https://www.nginx.com
• https://github.com/kaltura/nginx-vod-module
• https://github.com/anomalizer/ngx_aws_auth