Nginx & Caddy 완전 정복 5편 — Caddy 기초: Caddyfile과 자동 HTTPS

         ┌─────────────── caddy (단일 프로세스, 단일 바이너리) ───────────────┐
         │                                                                  │
 Caddyfile ──adapt──▶ JSON 설정 ──▶ ┌──────────────┐                        │
         │                         │  Admin API   │ ◀── localhost:2019     │
         │                         └──────┬───────┘                        │
         │                    ┌───────────┼────────────┐                   │
         │              ┌─────▼────┐ ┌────▼─────┐ ┌────▼─────┐             │
         │              │ http app │ │ tls app  │ │ pki app  │  ...        │
         │              └──────────┘ └──────────┘ └──────────┘             │
         │                 goroutine들이 요청 처리 (Go 런타임 스케줄러)       │
         └──────────────────────────────────────────────────────────────────┘

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

brew install caddy

docker run -d --name caddy \
  -p 80:80 -p 443:443 -p 443:443/udp \
  -v $(pwd)/Caddyfile:/etc/caddy/Caddyfile \
  -v caddy_data:/data \
  -v caddy_config:/config \
  caddy:2

# 현재 디렉터리를 정적 파일 서버로 (디렉터리 목록 표시)
caddy file-server --listen :8080 --browse
 
# 리버스 프록시
caddy reverse-proxy --from :8080 --to localhost:3000
 
# 도메인을 주면 HTTPS까지 자동 (공인 DNS + 80/443 접근 가능해야 함)
caddy reverse-proxy --from example.com --to localhost:3000

caddy run                     # 포그라운드 실행 (현재 디렉터리의 Caddyfile 사용)
caddy start                   # 백그라운드 실행
caddy stop
caddy reload                  # 무중단 설정 리로드 (Admin API 경유)
caddy validate --config /etc/caddy/Caddyfile   # 설정 검증 (= nginx -t)
caddy fmt --overwrite Caddyfile                 # 포매터 (들여쓰기 정리)
caddy adapt --config Caddyfile --pretty         # Caddyfile → JSON 변환 결과 보기
caddy list-modules            # 포함된 모듈 목록 (= nginx -V)
caddy trust                   # 로컬 CA 루트 인증서를 시스템 신뢰 저장소에 설치
caddy hash-password           # basic_auth용 비밀번호 해시 생성

# ① 전역 옵션 블록 (선택, 반드시 맨 위)
{
	email admin@example.com
	# debug
}
 
# ② 스니펫 (재사용 조각, 6편)
(common) {
	encode zstd gzip
}
 
# ③ 사이트 블록: 주소 { 지시어들 }
example.com {
	import common
	root * /var/www/example
	file_server
}
 
www.example.com {
	redir https://example.com{uri} permanent
}

example.com                 # HTTPS 자동 (80/443)
example.com, www.example.com  # 여러 도메인을 한 블록에
*.example.com               # 와일드카드 (DNS 챌린지 필요, 6편)
localhost                   # 로컬 CA로 HTTPS
:8080                       # 포트만 → HTTP, 모든 호스트
http://example.com          # 명시적 HTTP (자동 HTTPS 끔)
https://example.com:8443    # 커스텀 포트의 HTTPS
192.168.0.10                # IP → 로컬 CA로 HTTPS

지시어 [매처] 인자들... {
	하위 지시어
}

root * /var/www/site          # * = 모든 요청
root /blog/* /var/www/blog    # /blog/ 이하 요청만
reverse_proxy /api/* localhost:8080

{$SITE_DOMAIN:localhost} {
	reverse_proxy {$UPSTREAM:app:3000}
}

example.com {
	respond "Hello HTTPS"
}

localhost {
	reverse_proxy localhost:3000
}

# (1) Caddy 내장 CA 사용 → 클라이언트에 Caddy 루트 인증서 배포 필요
app.internal.corp {
	tls internal
	reverse_proxy 10.0.0.11:8080
}
 
# (2) 사내 CA가 발급한 인증서 파일 직접 지정
app.corp.example {
	tls /etc/caddy/certs/app.crt /etc/caddy/certs/app.key
	reverse_proxy 10.0.0.11:8080
}

{
	auto_https off          # 전부 끄기
	# auto_https disable_redirects   # 리다이렉트만 끄기
}

example.com {
	root * /var/www/example
	encode zstd gzip
	file_server
 
	# 정적 자산 장기 캐시
	@static path *.css *.js *.png *.jpg *.svg *.woff2
	header @static Cache-Control "public, max-age=31536000, immutable"
 
	handle_errors {
		rewrite * /{err.status_code}.html
		file_server
	}
}

app.example.com {
	root * /var/www/spa/dist
	encode zstd gzip
	try_files {path} /index.html
	file_server
}

example.com {
	reverse_proxy localhost:3000
}

example.com {
	# /api/* → 백엔드 (경로 유지: /api/users → :8080/api/users)
	reverse_proxy /api/* localhost:8080
 
	# 나머지 → 프런트엔드
	reverse_proxy localhost:3000
}

example.com {
	handle_path /api/* {
		reverse_proxy localhost:8080    # /api/users → :8080/users
	}
 
	handle {
		reverse_proxy localhost:3000
	}
}

reverse_proxy localhost:8080 {
	header_up X-Request-Start "{time.now.unix_ms}"   # 백엔드로 보내는 요청 헤더
	header_down -Server                              # 클라이언트로 가는 응답 헤더 제거
}

reverse_proxy https://api.partner.com {
	header_up Host {upstream_hostport}
}

example.com {
	log {
		output file /var/log/caddy/example.access.log {
			roll_size 100MiB
			roll_keep 10
			roll_keep_for 720h
		}
		format json
	}
	reverse_proxy localhost:3000
}

journalctl -u caddy -f        # systemd로 실행 중인 Caddy의 프로세스 로그

{
	email admin@example.com
}
 
www.example.com {
	redir https://example.com{uri} permanent
}
 
example.com {
	encode zstd gzip
 
	handle /ws/* {
		reverse_proxy localhost:4000
	}
 
	handle_path /api/* {
		reverse_proxy localhost:8080
	}
 
	handle {
		root * /var/www/example
		try_files {path} /index.html
		file_server
	}
 
	log {
		output file /var/log/caddy/example.log
	}
}