herzog31/docker-proxy repository overview

⁠Supported tags and respective Dockerfile links

• regular, latest (Dockerfile)⁠
• ios (Dockerfile)⁠
• ios-pers (Dockerfile)⁠

⁠docker-proxy

Nginx proxy that maps containers to subdomains.

Use the regular tagged version to map docker containers to subdomains by their name.

Example: Container solid is mapped to solid.example.org. The containers public port is mapped to the port specified via PROXY_PORT.

Use the ios tagged version for the setup used in the iOS Praktikum at TUM to map container compositions to the composition prefix.

Example: Containers from a docker composition liquid_node_1 and liquid_db_1 are mapped to liquid.example.org. The container's private ports are mapped to the new subdomain if a public mapping exists, respecting docker-proxy's published port range. So the first public port of liquid_node_1 is available at liquid.example.org:80, the second at liquid.example.org:81 etc.

The ios-pers tagged version makes port mappings persistent, so they stay the same after adding or removing containers.

Important: Make sure that your DNS is configured in a way that all subdomains of the given hostname point to your docker host.

⁠Usage

Run the docker-proxy container using the following command:

⁠Regular Version

docker run -it --rm --name docker-proxy -p 80:80 -v /var/run/docker.sock:/var/run/docker.sock -e PROXY_PORT=80 -e PROXY_BASE_URL=example.org herzog31/docker-proxy:regular

⁠iOS Version

docker run -it --rm --name docker-proxy -p 80-100:80-100 -v /var/run/docker.sock:/var/run/docker.sock -e PROXY_PORT_RANGE=80-100 -e PROXY_BASE_URL=example.org herzog31/docker-proxy:ios

Replace example.org with the desired hostname and configure your DNS accordingly.

To let the container run as a daemon, use the following command:

⁠Regular Version

docker run -d --name docker-proxy --restart=always -p 80:80 -v /var/run/docker.sock:/var/run/docker.sock -e PROXY_PORT=80 -e PROXY_BASE_URL=example.org herzog31/docker-proxy:regular

⁠iOS Version

docker run -d --name docker-proxy --restart=always -p 80-100:80-100 -v /var/run/docker.sock:/var/run/docker.sock -e PROXY_PORT_RANGE=80-100 -e PROXY_BASE_URL=example.org herzog31/docker-proxy:ios

⁠Port Mappings Overview

The proxy provides an overview table at example.org:80 that shows all port mappings.

⁠Variables

PROXY_BASE_URL: Hostname that will be used, e.g. example.org

PROXY_PORT: Public port that will be mapped to the ports from the containers. Only applicable for the regular version.

PROXY_PORT_RANGE: Public ports that will be mapped to the ports form the containers. Only applicable for the ios version.