Docker Hub: Pre-Build Image
Redirect to Url
Redirect all Requests to a given Url
The Docker Image use Port: 80
Features
- Redirect Request
- Nginx
- Docker
- Docker-Compose
- HA-Proxy Ready
- Rancher (Cattle) Ready
Environment variables
SERVER_REDIRECT
- server to redirect to, eg.www.example.com
SERVER_NAME
- optionally define the server name to listen on eg.~^www.(?<subdomain>.+).example.com
- useful for capturing variable to use in server_redirect.
SERVER_REDIRECT_PATH
- optionally define path to redirect all requests eg./landingpage
- if not set nginx var
$request_uri
is used
- if not set nginx var
SERVER_REDIRECT_SCHEME
- optionally define scheme to redirect to- if not set nginx var
$scheme
is used
- if not set nginx var
SERVER_REDIRECT_CODE
- optionally define the http status code to use for redirection- if not set or not in list of allowed codes 301 is used as default
- allowed Codes are: 301, 302, 303, 307, 308
SERVER_REDIRECT_POST_CODE
- optionally define the http code to use for POST redirection- useful if client should not change the request method from POST to GET
- if not set or not in allowed Codes
SERVER_REDIRECT_CODE
is used - so per default all requests will be redirected with the same status code
SERVER_ACCESS_LOG
- optionally define the location where nginx will write its access log- if not set /dev/stdout is used
SERVER_ERROR_LOG
- optionally define the location where nginx will write its error log- if not set /dev/stderr is used
See also docker-compose.yml
file.
Quickstart
Docker run
- Make Port 4242 Public (-p),
- Set Variables (-e)
docker run \
-p 4242:80 \
-e SERVER_REDIRECT_SCHEME=https \
-e SERVER_REDIRECT="www.example.com" \
a6b8/redirect-to-url-docker
Docker-Compose
version: '2'
services:
redirect-to-url:
image: a6b8/redirect-to-url-docker
ports:
- "4242:80"
environment:
- SERVER_REDIRECT_SCHEME=https
- SERVER_REDIRECT=www.example.com
HA-Proxy Snippet
version: '2'
services:
redirect-to-url:
image: a6b8/redirect-to-url-docker
environment:
- SERVER_REDIRECT_SCHEME=https
- SERVER_REDIRECT=www.example.com