Docker-Web-Redirect

This docker container listens on port 80 (default) and redirects all web traffic to the given target domain/URL.

• forked from MorbZ/docker-web-redirect
  • Differences
    • Add HTTP Redirect (drop URL Path)
    • Code refactoring

To Do

• GitHub Actions CI/CD Workflow (Publish to Docker Hub)

Usage

(Common)Environment

• (Required) The redirection type is set by the REDIRECT_TYPE environment variable.
  • Available types
    • REWRITE : Performs URL Rewrite
    • REDIRECT : Performs HTTP Redirect
• (Required) The target domain/URL is set by the REDIRECT_TARGET environment variable.
  • Ex. https://kftc.or.kr

(URL Rewrite) Environment

• (Optional) The rewrite flag is set by the REWRITE_FLAG environment variable. (Only used when REDIRECT_TYPE is REWRITE.)
  • Available flags
    • permanent : Permanent rewrites. (Similar from HTTP 301 redirect)
    • redirect : Temporary rewrites. (Similar from HTTP 302 redirect)
  • Default flag is redirect.

(HTTP Redirect) Environment

• (Optional) The redirection type is set by the REDIRECT_CODE environment variable. (Only used when REDIRECT_TYPE is REDIRECT.)
  • Available codes
    • 301 : Permanent redirects. Using GET method to redirected location.
    • 308 : Permanent redirects. Using same method to redirected location. (Not supported by IE)
    • 303 : Temporary redirects. Using GET method to redirected location.
    • 307 : Temporary redirects. Using same method to redirected location. (Not supported by IE)
    • 302 : Temporary redirects. Originally same as 307, but most browsers do like 303.
  • Default code is 302.

Example

# URL Rewrite
$ docker run --rm -d -e REDIRECT_TYPE=REWRITE REDIRECT_TARGET=https://kftc.or.kr -p 80:80 yoobato/docker-web-redirect

# HTTP Redirect
$ docker run --rm -d -e REDIRECT_TYPE=REDIRECT REDIRECT_TARGET=https://kftc.or.kr -p 80:80 yoobato/docker-web-redirect

Docker Compose

This image can be combined with the nginxproxy/nginx-proxy. A sample docker-compose file that redirects kftcold.net to kftcnew.net could look like this:

version: '3.8'

services:
  redirect:
    image: yoobato/docker-web-redirect
    restart: always
    environment:
      - VIRTUAL_HOST=kftcold.net
      - REDIRECT_TYPE=REDIRECT
      - REDIRECT_TARGET=https://kftcnew.net
      - REDIRECT_CODE=301

Docker Build

Build multi-platform images (https://docs.docker.com/build/building/multi-platform/)

docker buildx build --platform linux/arm64,linux/amd64,linux/arm/v7 -t yoobato/docker-web-redirect:{version_tag} --push .

Authors

• Daeyeol Ryu

LICENSE

• MIT License