macbre / docker-traefik

Dockerized traefik v3 with auto-discovery of other containers on the same Docker network

docker-traefik

Dockerized traefik v3 with auto-discovery of other containers on the same Docker network.

The traefik container runs as nobody and uses proxy to get restricted and limited access to the Docker socket.

Installing

1. Clone this repo.
2. Then run:

sudo chown nobody:nogroup letsencrypt/
docker network create public-network
docker-compose pull
docker-compose up -d

Making Docker containers auto-discoverable

1. This Traefik instance runs on public-network network. Your containers should also use it:

# make your ... container discoverable by traefik
# https://docs.docker.com/compose/networking/#configure-the-default-network
#
# docker network create public-network
networks:
  default:
    name: public-network
    external: true

2. Add labels to your container.

    # https://doc.traefik.io/traefik/user-guides/docker-compose/basic-example/
    labels:
      traefik.enable: true
      traefik.http.routers.<your app name>.tls.certresolver: letsencrypt
      traefik.http.routers.<your app name>.rule: Host(`<your domain, e.g. myservice.foo.net>`)
      traefik.http.services.<your app name>.loadbalancer.server.port: "< port where your service is bound too >"  # or rely on ports defined via EXPOSE

3. Make sure that your container own healthcheck also passes. Traefik filters out containers that do not pass Docker healthchecks.

Notes

This container exposes both http (80) and https (443) ports. It supports both http/2 and http/3.

There's also the dashboard exposed on a local 58888 port (this port is bound to the local interface only!).

You can use the 5888 port to get some information from the API about your running services and routers:

$ curl -s 127.0.0.1:58888/api/http/routers | jq -r '.[] | .service' | sort
acme-http@internal
api@internal
dashboard@internal
noop@internal
ping@internal
prometheus@internal
<your app name>

$ curl -s 127.0.0.1:58888/api/http/services | jq '.[] | .serverStatus'
{
  "http://172.x.x.x:8080": "UP"
}