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 traefikzeigt 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=truefehlt, oder dieHost-Regel passt nicht. - Bad Gateway: Falscher interner Port,
loadbalancer.server.portsetzen.
Für die Community
Du kennst dich aus? Schreib eine Anleitung.
Teile, was du weißt: Wir prüfen jede eingereichte Anleitung, veröffentlichen sie mit deinem Namen und bedanken uns mit Guthaben für deine Dienste.