Traefik - reverzní proxy pro Docker s HTTPS

Správa subdomén a automatické SSL certifikáty pro Docker. Konfigurace Traefik s Let's Encrypt. Praktické use cases a příklady.

, Infrastruktura a provoz, 5 min čtení
Seriál Vlastní digitální svět, díl 5

Úvod: Proč potřebujeme reverzní proxy?

Když provozujeme více služeb v Dockeru, může být správa IP adres a portů složitá.
Reverzní proxy Traefik tento problém elegantně řeší tím, že:

  • Umožňuje přístup přes domény místo IP adres.
  • Automaticky nastavuje HTTPS certifikáty.
  • Směruje provoz na správné služby podle pravidel.

V tomto článku si ukážeme jednoduchou konfiguraci Traefiku, která vám umožní:

  • Přístup k Portaineru a Traefiku přes subdomény.
  • Automatickou správu HTTPS certifikátů.
  • Logování a ladění s pomocí AI.

traefik


Licence a cena

AspektDetail
LicenceMIT (plně open-source)
Self-hostingAno, zdarma bez omezení
Enterprise verzeTraefik Enterprise (placená)
Cloud verzeTraefik Hub (free tier + placené plány)
Zdrojový kódgithub.com/traefik/traefik

Traefik je 100% open-source pod MIT licencí. Můžete ho používat v produkci bez jakýchkoliv omezení. Traefik Enterprise přidává dashboard, podporu a pokročilé funkce pro velké organizace.

Traefik vs Traefik Enterprise

FunkceTraefik (zdarma)Enterprise
Reverse proxyanoano
Let’s Encryptanoano
Docker/K8s provideranoano
Middlewaresanoano
Distributed tracingneano
API Gateway featuresneano
Enterprise supportneano

Nastavení DNS pro subdomény

Pro správné fungování musíme v DNS záznamech nastavit směřování domény na náš server:

Vytvořte A záznam:

  • traefik.moje-domena.cz → IP adresa serveru
  • portainer.moje-domena.cz → IP adresa serveru

Použití ENV proměnných pro bezpečnější konfiguraci

Místo přímého zápisu citlivých údajů do docker-compose.yml budeme používat .env soubor.
Vytvořte soubor .env ve stejném adresáři jako docker-compose.yml:

DOMAIN=moje-domena.cz
EMAIL=admin@moje-domena.cz

Upravíme docker-compose.yml, aby načítal tyto proměnné pomocí syntaxe ${env_hodnota}:

version: '3.8'
services:
  traefik:
    image: "traefik:v2.10"
    container_name: "traefik"
    restart: always
    networks:
      - selfhosted_network
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - "/var/run/docker.sock:/var/run/docker.sock"
      - "./traefik.yml:/etc/traefik/traefik.yml"
      - "./acme.json:/acme.json"
    env_file:
      - .env
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.api.rule=Host(`traefik.${DOMAIN}`)"
      - "traefik.http.routers.api.service=api@internal"
      - "traefik.http.routers.api.entrypoints=websecure"
      - "traefik.http.routers.api.tls.certresolver=myresolver"

networks:
  selfhosted_network:
    external: true

Vytvoření souboru traefik.yml

traefik.yml je konfigurační soubor pro Traefik jako takový, nezaměňujte s konfigurací pro docker kontejner (docker-compose.yml)

api:
  dashboard: true

entryPoints:
  web:
    address: ":80"
  websecure:
    address: ":443"

certificatesResolvers:
  myresolver:
    acme:
      email: "${EMAIL}"
      storage: "/acme.json"
      httpChallenge:
        entryPoint: "web"

providers:
  docker:
    watch: true
    exposedByDefault: false

Spuštění kontejneru

Nezapomeňte, že .env soubor nesmí být součástí veřejného repozitáře.
Přidejte ho do .gitignore, pokud používáte Git:

.env

Nyní spusťte kontejner:

docker-compose up -d
  • Traefik nyní běží a můžeme přidávat služby!

Přidání pravidel směrování (subdomény)

Portainer dostupný na portainer.moje-domena.cz

services:
  portainer:
    image: portainer/portainer-ce:latest
    container_name: portainer
    restart: always
    networks:
      - selfhosted_network
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.portainer.rule=Host(`portainer.${DOMAIN}`)"
      - "traefik.http.routers.portainer.entrypoints=websecure"
      - "traefik.http.routers.portainer.tls.certresolver=myresolver"
  • Portainer je nyní dostupný přes HTTPS na portainer.moje-domena.cz!

Automatické generování SSL certifikátů s Let’s Encrypt

Traefik automaticky vygeneruje bezpečné certifikáty, pokud:

  1. Máme platnou doménu (např. moje-domena.cz).
  2. Doména směřuje na náš server pomocí DNS A záznamu.
  3. Máme správně nastavený ACME cert resolver v traefik.yml.

Traefik se postará o automatickou obnovu certifikátů!


Debugging a logování v Traefiku

Pokud něco nefunguje:
Zkontrolujte logy příkazem:

docker logs traefik --follow

Jak použít AI k řešení chyb?

  • Zkopírujte chybovou hlášku z logů.

  • Vložte ji do ChatGPT/Gemini a zeptejte se: “Co způsobuje tuto chybu a jak ji opravit?”

  • AI vám navrhne řešení.

  • Toto vám ušetří hodiny hledání řešení!


Kam dál? – Pokud chcete jít do hloubky

Oficiální dokumentace Traefiku: https://doc.traefik.io/traefik/ Existuje spousta tutoriálů, ale tento článek ukazuje funkční minimum. V dalším díle: Jak za Traefikem nasadit první reálnou aplikaci!


Praktické použití

Use case 1: Multi-tenant SaaS aplikace

Situace: Provozujete SaaS produkt, kde každý zákazník má vlastní subdoménu (zakaznik1.app.cz, zakaznik2.app.cz). Ručně spravovat nginx konfigurace je noční můra.

Řešení s Traefik:

  • Wildcard certifikát: Jeden certifikát pro *.app.cz
  • Dynamic config: Nový kontejner = automaticky nová subdoména
  • Labels: Stačí přidat traefik.http.routers.app.rule=Host(\zakaznik1.app.cz`)`
  • Zero downtime: Rolling updates bez výpadku
  • Load balancing: Automatické rozdělení zátěže mezi repliky

Výsledek: Nový tenant za minuty, ne hodiny konfigurace.

Use case 2: Homelab s desítkami služeb

Situace: Máte doma server s 15+ self-hosted aplikacemi. Pamatovat si porty (Plex:32400, Nextcloud:8080, Home Assistant:8123…) je nemožné.

Řešení s Traefik:

  • Subdomény: plex.home.lan, cloud.home.lan, ha.home.lan
  • Lokální DNS: Pi-hole nebo AdGuard směruje *.home.lan na server
  • HTTPS: Self-signed nebo Let’s Encrypt s DNS challenge
  • Dashboard: Přehled všech služeb na jednom místě
  • Middleware: Základní auth pro nezabezpečené aplikace

Výsledek: Profesionální homelab jako v enterprise prostředí.

Use case 3: Blue-green deployment

Situace: Nasazujete novou verzi aplikace, ale nechcete riskovat výpadek. Potřebujete možnost okamžitého rollbacku.

Řešení s Traefik:

  • Dva kontejnery: app-blue (stávající), app-green (nová verze)
  • Weighted routing: 100% na blue, 0% na green
  • Postupné přepínání: 90/10 → 50/50 → 0/100
  • Health checks: Automatický rollback při selhání
  • Canary: Část uživatelů na nové verzi pro testování

Výsledek: Bezpečné nasazení bez stresu a nočních výpadků.

Use case 4: API Gateway pro microservices

Situace: Máte 10 microservices, každá na jiném portu. Frontend potřebuje jednotný endpoint.

Řešení s Traefik:

  • Path routing: /api/users → users-service, /api/orders → orders-service
  • Strip prefix: Služba nemusí znát svůj prefix
  • Rate limiting: Middleware pro ochranu před DDoS
  • CORS: Centrální konfigurace pro všechny služby
  • Headers: Přidání auth headerů, request ID

Výsledek: Jeden endpoint api.app.cz pro všechny služby.

Use case 5: Automatické HTTPS pro WordPress multisite

Situace: Provozujete WordPress multisite s 50+ weby. Každý web má vlastní doménu. Ruční správa certifikátů je neúnosná.

Řešení s Traefik:

  • Let’s Encrypt: Automatické vystavení certifikátu při prvním requestu
  • HTTP → HTTPS redirect: Middleware pro všechny weby
  • Renewal: Automatická obnova před expirací
  • Wildcard + individual: Kombinace pro subdomény i vlastní domény
  • Rate limits: Ochrana před Let’s Encrypt limity

Výsledek: HTTPS pro všechny weby bez jediného manuálního kroku.


Traefik vs alternativy

NástrojLicenceDocker nativeLet’s EncryptUI
TraefikMITanoanoDashboard
nginxBSD(ruční)certbotne
CaddyApache 2.0anone
HAProxyGPLneneStats
nginx-proxyMITano(companion)ne

Traefik je nejlepší volba pro Docker prostředí díky native integraci. Caddy je jednodušší pro statické weby, nginx pro maximální výkon a kontrolu.


Závěr a další kroky

  • Máme reverzní proxy, subdomény a HTTPS!
  • MIT licence – plně open-source, bez omezení pro produkci.
  • Portainer a Traefik jsou dostupné přes subdomény.
  • Používáme .env pro bezpečnější správu proměnných.