Traefik: Docker와 Let's Encrypt로 HTTPS 자동화 완전 정복

# 작업 디렉토리 생성 및 이동
mkdir traefik
cd traefik

# Traefik의 기본 설정을 담을 파일 생성
touch traefik.yml

# Docker Compose 실행을 위한 파일 생성
touch docker-compose.yml

# traefik.yml

# API 및 대시보드 활성화
# 개발 환경에서는 insecure: true로 간단히 열 수 있습니다.
api:
  insecure: true
  dashboard: true

# Traefik이 외부 요청을 받아들일 통로(엔트리포인트)를 정의합니다.
entryPoints:
  web:
    address: ":80"      # HTTP 요청을 위한 80번 포트
  websecure:
    address: ":443"     # HTTPS 요청을 위한 443번 포트

# 어떤 환경의 설정을 동적으로 읽어올지 정의합니다.
providers:
  docker:
    exposedByDefault: false # ※보안상 매우 중요한 설정입니다.
    network: traefik-proxy    # Traefik이 연결될 Docker 네트워크를 지정합니다.

# docker-compose.yml

version: '3.8'

services:
  # 1. Traefik 서비스 정의
  traefik:
    image: "traefik:v3.0"
    container_name: "traefik"
    command:
      - "--configFile=/etc/traefik/traefik.yml" # 시작 시 읽을 정적 설정 파일 지정
    ports:
      - "80:80"        # HTTP
      - "443:443"      # HTTPS
      - "8080:8080"    # Traefik 대시보드 접속 포트
    volumes:
      # Docker 소켓을 읽기 전용으로 마운트하여 컨테이너의 생성/삭제를 감지 (핵심!)
      - "/var/run/docker.sock:/var/run/docker.sock:ro"
      # 위에서 작성한 설정 파일을 컨테이너 내부로 마운트
      - "./traefik.yml:/etc/traefik/traefik.yml:ro"
    networks:
      - traefik-proxy
    restart: unless-stopped

  # 2. 라우팅 테스트를 위한 whoami 서비스
  whoami:
    image: "traefik/whoami"
    container_name: "whoami"
    networks:
      - traefik-proxy
    # --- Traefik 동적 설정 (레이블) ---
    labels:
      # 이 컨테이너를 Traefik이 관리하도록 활성화
      - "traefik.enable=true"
      # 'whoami' 라우터 정의 및 규칙 설정: 'whoami.localhost' 호스트로 오는 요청을 처리
      - "traefik.http.routers.whoami.rule=Host(`whoami.localhost`)"
      # 이 라우터가 사용할 엔트리포인트(통로)는 'web'(80 포트)으로 지정
      - "traefik.http.routers.whoami.entrypoints=web"
      # 이 서비스가 실제로 응답하는 포트는 80번이라고 Traefik에 알려줌
      - "traefik.http.services.whoami.loadbalancer.server.port=80"

# Traefik과 서비스들이 함께 사용할 외부 네트워크 정의
networks:
  traefik-proxy:
    external: true

# 1. Docker Compose에서 사용할 공용 네트워크 생성
docker network create traefik-proxy

# 2. Docker Compose로 Traefik과 whoami 서비스 실행 (-d는 백그라운드 실행)
docker-compose up -d

# 'Host' 헤더를 지정하여 Traefik이 올바른 라우팅 규칙을 찾도록 합니다.
curl -H Host:whoami.localhost http://localhost

# traefik.yml

api:
  insecure: true
  dashboard: true

entryPoints:
  web:
    address: ":80"
    # (추가) 80포트로 온 모든 HTTP 요청을 websecure(HTTPS)로 리디렉션
    http:
      redirections:
        entryPoint:
          to: websecure
          scheme: https
  websecure:
    address: ":443"

providers:
  docker:
    exposedByDefault: false
    network: traefik-proxy

# (추가) Let's Encrypt를 위한 인증서 해석기 정의
certificatesResolvers:
  letsencrypt: # 이 해석기의 이름은 'letsencrypt'로 지정합니다.
    acme:
      # ※반드시 실제 사용하는 이메일 주소를 입력하세요. 인증서 만료 알림 등에 사용됩니다.
      email: "your-email@example.com"
      # 발급받은 인증서를 저장할 파일 경로
      storage: "/etc/traefik/acme.json"
      # 도메인 소유권 확인 방식 (HTTP-01 챌린지)
      httpChallenge:
        entryPoint: web

# docker-compose.yml

version: '3.8'

services:
  traefik:
    image: "traefik:v3.0"
    container_name: "traefik"
    command:
      - "--configFile=/etc/traefik/traefik.yml"
    ports:
      - "80:80"
      - "443:443"
      - "8080:8080"
    volumes:
      - "/var/run/docker.sock:/var/run/docker.sock:ro"
      - "./traefik.yml:/etc/traefik/traefik.yml:ro"
      # (추가) 인증서 파일(acme.json)을 호스트에 영속적으로 저장하기 위한 볼륨
      - "./acme.json:/etc/traefik/acme.json"
    networks:
      - traefik-proxy
    restart: unless-stopped

  whoami:
    image: "traefik/whoami"
    container_name: "whoami"
    networks:
      - traefik-proxy
    labels:
      - "traefik.enable=true"
      # (수정) 라우터가 사용할 엔트리포인트를 'websecure'(443 포트)로 변경
      - "traefik.http.routers.whoami.entrypoints=websecure"
      # (수정) Host 규칙을 실제 소유한 도메인으로 변경
      - "traefik.http.routers.whoami.rule=Host(`whoami.your-domain.com`)"
      # (추가) 이 라우터에 TLS를 활성화
      - "traefik.http.routers.whoami.tls=true"
      # (추가) TLS 인증서 발급을 위해 'letsencrypt' 해석기를 사용하도록 지정
      - "traefik.http.routers.whoami.tls.certresolver=letsencrypt"
      - "traefik.http.services.whoami.loadbalancer.server.port=80"

networks:
  traefik-proxy:
    external: true

# 비어있는 acme.json 파일 생성
touch acme.json

# 파일 소유자만 읽고 쓸 수 있도록 권한 설정 (600)
chmod 600 acme.json

docker-compose up -d