Caddy 웹서버 — 자동 HTTPS 리버스 프록시 완전 가이드

# Debian/Ubuntu 공식 저장소
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' \
  | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' \
  | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update && sudo apt install caddy

# 버전 확인
caddy version

sudo systemctl enable --now caddy
systemctl status caddy

example.com {
    root * /var/www/example.com
    file_server
    encode gzip zstd
}

example.com, www.example.com {
    redir https://example.com{uri} permanent
}

app.example.com {
    reverse_proxy localhost:3000
}

api.example.com {
    reverse_proxy {
        to localhost:8001 localhost:8002 localhost:8003
        lb_policy round_robin           # least_conn, ip_hash 등
        health_uri /healthz
        health_interval 10s
        health_timeout 3s
    }
}

example.com {
    # /api/* 는 백엔드로
    reverse_proxy /api/* localhost:8080

    # 나머지는 정적 파일
    handle {
        root * /var/www/spa
        try_files {path} /index.html      # SPA fallback
        file_server
    }
}

reverse_proxy localhost:3000 {
    header_up Host {upstream_hostport}
    header_up X-Real-IP {remote_host}
    header_down -Server                  # 응답에서 Server 헤더 제거
}

example.com {
    tls [email protected] {              # ACME 계정 이메일
        protocols tls1.2 tls1.3
    }
    reverse_proxy localhost:3000
}

# 직접 발급한 인증서 사용
tls /etc/ssl/site.crt /etc/ssl/site.key

# 내부 CA로 자체 서명 (개발용)
tls internal

{
    email [email protected]
    admin localhost:2019                 # Admin API 엔드포인트
    log {
        output file /var/log/caddy/access.log
        format json
    }
}

example.com {
    reverse_proxy localhost:3000
    log {
        output file /var/log/caddy/example.access.log {
            roll_size 50mb
            roll_keep 10
        }
        format console
    }
}

# 문법 검증 및 포맷팅
caddy validate --config /etc/caddy/Caddyfile
caddy fmt --overwrite /etc/caddy/Caddyfile

# 무중단 리로드 (graceful, 연결 끊김 없음)
sudo systemctl reload caddy
# 또는
caddy reload --config /etc/caddy/Caddyfile

# 현재 동작 중인 전체 설정 확인
curl -s localhost:2019/config/ | jq .

# 업스트림 헬스 상태 확인
curl -s localhost:2019/reverse_proxy/upstreams | jq .

# 설정 일부를 동적으로 교체 (PATCH)
curl -X POST localhost:2019/load \
  -H "Content-Type: application/json" \
  -d @new-config.json

journalctl -u caddy -f --no-pager