Caddy로 HTTPS 자동화 — Let's Encrypt 인증서 무한 갱신

Caddyfile — 가장 기본적인 형태

# 정적 파일 서빙
example.com {
    root * /var/www/html
    file_server
}

# 이것만으로 HTTPS가 자동 적용됩니다
# HTTP → HTTPS 리다이렉트도 자동입니다

# Caddy 설치 및 실행 (Ubuntu/Debian)

# 저장소 추가 및 설치
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
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

# Caddyfile 위치: /etc/caddy/Caddyfile
# 서비스 시작
sudo systemctl enable caddy
sudo systemctl start caddy

Caddyfile — 리버스 프록시

example.com {
    reverse_proxy localhost:3000
}

# 이 한 줄이 Nginx에서는 이렇게 됩니다:
# server {
#     listen 443 ssl http2;
#     server_name example.com;
#     ssl_certificate /etc/letsencrypt/live/...;
#     ssl_certificate_key /etc/letsencrypt/live/...;
#     location / {
#         proxy_pass http://localhost:3000;
#         proxy_http_version 1.1;
#         proxy_set_header Upgrade $http_upgrade;
#         proxy_set_header Connection 'upgrade';
#         proxy_set_header Host $host;
#         proxy_cache_bypass $http_upgrade;
#     }
# }

Caddyfile — WebSocket + 헤더 전달

example.com {
    reverse_proxy localhost:3000 {
        header_up X-Real-IP {remote_host}
        header_up X-Forwarded-For {remote_host}
        header_up X-Forwarded-Proto {scheme}
    }
    # WebSocket은 자동 지원됩니다
}

Caddyfile — 다중 도메인 + 서브도메인

# 메인 사이트
example.com {
    reverse_proxy localhost:3000
}

# 관리자 사이트
admin.example.com {
    reverse_proxy localhost:3001
}

# API 서버
api.example.com {
    reverse_proxy localhost:4000
}

# 다른 도메인의 서비스
another-domain.com {
    reverse_proxy localhost:5000
}

# 각 도메인마다 자동으로 HTTPS 인증서가 발급됩니다

Caddyfile — 보안 헤더 추가

example.com {
    reverse_proxy localhost:3000

    header {
        # HSTS (HTTPS 강제)
        Strict-Transport-Security "max-age=31536000; includeSubDomains; preload"
        # XSS 방지
        X-Content-Type-Options "nosniff"
        X-Frame-Options "SAMEORIGIN"
        # 리퍼러 정보 제한
        Referrer-Policy "strict-origin-when-cross-origin"
        # 서버 정보 숨기기
        -Server
    }
}

# 인증서 상태 확인

# Caddy 관리 API로 인증서 확인
curl localhost:2019/config/

# 인증서 저장 위치
ls ~/.local/share/caddy/certificates/

# Caddy 로그에서 인증서 관련 이벤트 확인
journalctl -u caddy | grep -i certificate