mtg/contrib/sni-router/docker-compose.yml

# SNI-routing deployment: HAProxy (443) -> mtg + real web backend
#
# This setup puts an SNI-aware TCP router in front of mtg so that:
#   - Telegram clients (FakeTLS with the correct SNI) are routed to mtg
#   - All other TLS traffic (including DPI probes) reaches the real web
#     server, which responds with a genuine certificate
#
# The result: active probes see a real website; passive DPI sees matching
# SNI/IP because the domain resolves to this server's IP.
#
# Quick start:
#   1. Set DOMAIN in a .env file next to this one (or export it)
#   2. mtg generate-secret YOUR_DOMAIN   -> render mtg-config.toml:
#        export MTG_SECRET=...     # paste the hex secret
#        envsubst < mtg-config.toml.example > mtg-config.toml
#      (the rendered file is gitignored). See README.md for the cp+edit variant.
#   3. docker compose up -d
#
# DOMAIN is forwarded to both Caddy (TLS cert) and HAProxy (SNI ACL),
# so the SNI/cert/secret all line up from a single source.
#
# See BEST_PRACTICES.md and the project wiki for background.

x-domain-env: &domain-env
  DOMAIN: ${DOMAIN:-example.com}

services:
  haproxy:
    image: haproxy:lts-alpine
    # Host netns so HAProxy sees real client IPs (v4/v6) instead of the
    # bridge gateway address.  Linux host only; see README → "Why HAProxy
    # uses network_mode: host" for the rationale and trade-off.
    network_mode: host
    volumes:
      - ./haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro,Z
    environment:
      <<: *domain-env
    depends_on:
      - mtg
      - web
    restart: unless-stopped

  mtg:
    # FIXME: :master until #480 lands in a tagged release; switch back to :2/:3 after release
    image: nineseconds/mtg:master
    volumes:
      - ./mtg-config.toml:/config/config.toml:ro,Z
    # Published on host loopback only — HAProxy (host netns) reaches it via
    # 127.0.0.1.
    ports:
      - "127.0.0.1:3128:3128"
    restart: unless-stopped
    extra_hosts:
      - "host.containers.internal:host-gateway"

  web:
    image: caddy:alpine
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro,Z
      - caddy_data:/data
      - ./www:/srv:ro,Z
    # Published on host loopback only — HAProxy reaches Caddy on 127.0.0.1.
    # Port 8080 (not 80) on the host because HAProxy already owns host :80.
    ports:
      - "127.0.0.1:8080:80"
      - "127.0.0.1:8443:8443"
    environment:
      <<: *domain-env
    restart: unless-stopped

volumes:
  caddy_data: