Linux & Software2 Min. Lesezeit

Traefik als Reverse Proxy für Docker mit automatischem HTTPS

Traefik v3 mit Docker Compose aufsetzen: Container per Label unter eigener Domain veröffentlichen, Let's-Encrypt-Zertifikate automatisch holen und das Dashboard absichern.

Traefik ist ein Reverse Proxy, der für Container gebaut wurde. Er liest die Labels deiner Docker-Container und richtet die Weiterleitung selbst ein: Container starten, Domain steht, Zertifikat ist da. Ideal, wenn auf einem Server mehrere Docker-Anwendungen laufen.

Voraussetzungen

  • Docker und Docker Compose, siehe Docker installieren
  • Ports 80 und 443 sind frei (kein Nginx oder Apache darauf) und von außen erreichbar
  • A-Einträge deiner Domains zeigen auf den Server

Gemeinsames Netzwerk anlegen

Traefik und deine Anwendungen hängen an einem gemeinsamen Docker-Netzwerk:

docker network create proxy

Traefik starten

mkdir -p ~/traefik && cd ~/traefik
touch acme.json && chmod 600 acme.json
nano compose.yaml
services:
  traefik:
    image: traefik:v3.1
    restart: unless-stopped
    command:
      - --providers.docker=true
      - --providers.docker.exposedbydefault=false
      - --providers.docker.network=proxy
      - --entrypoints.web.address=:80
      - --entrypoints.web.http.redirections.entrypoint.to=websecure
      - --entrypoints.web.http.redirections.entrypoint.scheme=https
      - --entrypoints.websecure.address=:443
      - --certificatesresolvers.le.acme.email=admin@example.com
      - --certificatesresolvers.le.acme.storage=/acme.json
      - --certificatesresolvers.le.acme.httpchallenge.entrypoint=web
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ./acme.json:/acme.json
    networks:
      - proxy

networks:
  proxy:
    external: true

Trage bei acme.email deine Adresse ein und starte:

docker compose up -d
docker compose logs -f

exposedbydefault=false bedeutet: Traefik veröffentlicht nur Container, die du ausdrücklich freigibst.

Eine Anwendung veröffentlichen

Als Beispiel der kleine Testdienst whoami unter whoami.example.com:

services:
  whoami:
    image: traefik/whoami
    restart: unless-stopped
    labels:
      - traefik.enable=true
      - traefik.http.routers.whoami.rule=Host(`whoami.example.com`)
      - traefik.http.routers.whoami.entrypoints=websecure
      - traefik.http.routers.whoami.tls.certresolver=le
    networks:
      - proxy

networks:
  proxy:
    external: true

Nach docker compose up -d ist der Dienst unter https://whoami.example.com mit gültigem Zertifikat erreichbar. Der Container braucht keinen eigenen ports-Eintrag, Traefik spricht ihn über das Netzwerk proxy an.

Lauscht die Anwendung im Container nicht auf Port 80, sag Traefik den Port:

- traefik.http.services.whoami.loadbalancer.server.port=3000

Das Dashboard

Traefik hat ein Dashboard, das alle Router und Dienste zeigt. Gib es nie ungeschützt frei. Mit Passwort geht es so. Erzeuge zuerst den Eintrag:

sudo apt install apache2-utils
htpasswd -nB admin

In der Ausgabe musst du jedes $ als $$ schreiben, damit Compose es nicht als Variable liest. Dann in die Traefik-Datei ergänzen:

    labels:
      - traefik.enable=true
      - traefik.http.routers.dash.rule=Host(`traefik.example.com`)
      - traefik.http.routers.dash.entrypoints=websecure
      - traefik.http.routers.dash.tls.certresolver=le
      - traefik.http.routers.dash.service=api@internal
      - traefik.http.routers.dash.middlewares=dash-auth
      - traefik.http.middlewares.dash-auth.basicauth.users=admin:$$2y$$05$$...

und bei command die Zeile - --api.dashboard=true.

Der Docker-Socket

Traefik liest über /var/run/docker.sock die Container aus. Wer diesen Socket kontrolliert, kontrolliert den Server. Deshalb wird er hier nur lesend eingebunden, und das Traefik-Image solltest du regelmäßig aktualisieren:

docker compose pull && docker compose up -d

Fehler finden

  • Kein Zertifikat, Browser warnt: docker compose logs traefik zeigt die Antwort von Let's Encrypt. Meist ist Port 80 zu oder der A-Eintrag zeigt woanders hin.
  • 404 page not found: Der Container hängt nicht am Netzwerk proxy, traefik.enable=true fehlt, oder die Host-Regel passt nicht.
  • Bad Gateway: Falscher interner Port, loadbalancer.server.port setzen.

Geschrieben von TryNxt-Team

Wir bauen und betreiben TryNxt selbst und schreiben hier auf, was wir dabei lernen.