/docker-nginx-vod-module

A Dockerized NGINX build of the nginx-vod-module

Primary LanguagePython

Docker NGINX VOD Module

Build Status Docker Automated build

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
λ 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

Test Players

HTML5 Players for testing.

TODO

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

References