docker-nginx-redirects

Generic redirect handler

Setup

Pull latest docker image

docker pull bowtie/nginx-redirects

Build it yourself (from this repo)

docker build -t bowtie/nginx-redirects .

Usage

All incoming servernames redirected to a single destination

docker run -it -p 8080:80 -e SERVER_REDIRECTS=https://google.com bowtie/nginx-redirects

• http://localhost:8080 should redirect to https://google.com

Different destination based on incoming servername

docker run -it -p 8080:80 -e SERVER_REDIRECTS=https://google.com%localhost,https://github.com%127.0.0.1 bowtie/nginx-redirects

• http://localhost:8080 should redirect to https://google.com
• http://127.0.0.1:8080 should redirect to https://github.com

Specify redirect code (defaults to 302, temporary)

docker run -it -p 8080:80 -e SERVER_REDIRECTS=https://google.com%localhost%301,https://github.com%127.0.0.1%302 bowtie/nginx-redirects

• http://localhost:8080 should 301 (permanent) redirect to https://google.com
• http://127.0.0.1:8080 should 302 (temporary) redirect to https://github.com

Configuration

Single ENV var expected: SERVER_REDIRECTS

A single redirect configuration group looks like

• DESTINATION%SOURCE%CODE
  • Config parts are separated by %
  • DESTINATION required
    • Where to redirect requests to
  • SOURCE optional
    • When to redirect to DESTINATION
    • Defaults to _ (all incoming server names)
    • Supports nginx server_name regex patterns
  • CODE optional
    • Redirect HTTP code to be used (must be 301 or 302)
    • Defaults to 302 (temporary redirect)

You can specify more than 1 configuration group as comma separated list

SERVER_REDIRECTS=D1%S1,D2%S2,D3%S3,...