CF
Cloudflare Wrangler 2026 — 팀 공유 분석
Workers/Pages/D1/R2/KV CLI 기능 · 비용 · HTML 정적호스팅 적합도
TL;DR
- HTML 정적 호스팅 = Cloudflare Pages. 대역폭 무제한 · 무료. Vercel/Netlify 무료 100 GB 대비 압도적 우위.
- 2026 변화: Pages → Workers Static Assets 로 통합 진행중. 신규 프로젝트는
wrangler deploy(Workers + assets) 가 권장 경로. - 유료는 $5/mo 단일 플랜으로 Workers·Pages·D1·R2·KV·Queues 공통 quota 포함. 개인 사이드프로젝트는 사실상 0원.
1. Wrangler 가 하는 일
★ 핵심
- Workers / Pages 배포 (
wrangler deploy,pages deploy) - 로컬 dev 서버 (workerd 런타임, 프로덕션과 동일 엔진)
--remote모드로 실제 D1·KV·R2 바인딩 사용해 디버깅- Secrets / env / vars 관리
- 버전 롤백 (
wrangler versions rollback)
★ 리소스 관리
- D1 (SQLite) — 생성/마이그레이션/쿼리
- R2 (S3 호환) — 버킷·오브젝트
- KV (key-value) — namespace
- Queues / Durable Objects / Vectorize / Hyperdrive
- AI Gateway · Workers AI 모델 라우팅
★ 2026 신규
- Workers Static Assets — Pages 대체. 단일
wrangler.toml에 정적+동적 합침 - Smart Placement v2 — Worker 위치를 백엔드 근처로 자동 배치
- Containers 베타 — Worker 안에서 컨테이너 spawn
- Workers Builds — Git push → 자동 빌드/배포 (GitHub Actions 대체)
★ 통합 / DX
- TypeScript 타입 자동 생성 (
wrangler types) - Vitest pool 로 워커 단위 테스트
- Cloudflare MCP 서버 — Claude/Cursor 가 직접 자원 조작
- One-click
create-cloudflareCLI (C3)
2. 비용 정리 (2026)
Workers·Pages·D1·R2·KV 가 단일 플랜 안에 모두 포함. 한도 초과 시만 종량.
| 서비스 | 무료 (Free) | 유료 (Workers Paid $5/mo) | 초과 종량 |
|---|---|---|---|
| Pages 정적 |
대역폭 무제한, 500 builds/mo, 동시빌드 1 | 대역폭 무제한, 5,000 builds/mo, 동시빌드 20 | 없음 (대역폭 과금 X) |
| Workers | 100K req/일, CPU 10ms/req | 10M req/mo + CPU 30M ms/mo | $0.30 / 1M req · $0.02 / 1M CPU ms |
| D1 (SQLite) | 5GB · 5M row read/일 · 100K write/일 | 유료 plan 한도 확장 | $0.001/1M read · $1/1M write · $0.75/GB |
| R2 (S3 호환) | 10GB 저장 · 1M class A/mo · 10M class B/mo | 한도 확장 | $0.015/GB · egress $0 (무료) |
| KV | 100K read/일 · 1K write/일 · 1GB | 10M read/mo · 1M write/mo · 1GB | $0.50/1M read · $5/1M write · $0.50/GB |
| Queues | 없음 (유료 필요) | 1M ops/mo 포함 | $0.40/1M op |
| Durable Obj | 없음 | 1M req/mo · 400K GB-s | $0.15/1M req |
| Workers Builds | 3,000 build-min/mo | 6,000 build-min/mo | $0.005 / build-min |
※ $5/mo 는 Workers Paid 단일 결제 — 같은 결제로 위 모든 서비스 유료 한도가 한 번에 열림.
3. HTML 정적 호스팅 적합도
결론 — Cloudflare 는 정적 HTML 호스팅에 가장 적합한 무료 옵션 중 하나.
대역폭 무제한·CDN 글로벌 엣지·HTTPS 자동·커스텀 도메인 무료까지 모두 포함. 단점은 build minute 제한과 함수 호출 시 cold-start 가능성 정도.
| 기준 | Cloudflare Pages | Vercel Free | Netlify Free | GitHub Pages |
|---|---|---|---|---|
| 월 대역폭 | 무제한 | 100 GB | 100 GB | 100 GB (소프트) |
| 월 빌드 | 500 | 6,000 min | 300 min | 사실상 무제한 |
| 커스텀 도메인 | 무료 | 무료 | 무료 | 무료 |
| 엣지 함수 | Workers | Edge Func 100K | 125K req | 없음 |
| SSR / 동적 | Yes (Workers) | Yes | Yes | No |
| 롤백 / 프리뷰 | Yes | Yes | Yes | 제한 |
| 상업 사용 | 허용 | 개인만 | 허용 | 제한 |
| 총평 | ★ 최적 | DX 우수 | 전통적 | 단순용 |
4. 팀에서 어떻게 쓰면 좋을까
✓ 잘 맞는 케이스
- 마케팅 사이트 · docs · 랜딩페이지
- 대용량 이미지/영상 호스팅 (egress 무료)
- 글로벌 트래픽 (200+ PoP)
- 가벼운 API (Workers + D1/KV)
- OAuth 콜백 · 웹훅 수신기
△ 주의해야 할 케이스
- 장기 작업 (CPU 30s 한도 — Pro 도 5분)
- Node.js 전용 라이브러리 의존성 (nodejs_compat 필요)
- 대용량 빌드 (월 500 build 한도)
- 로컬 파일시스템 의존 코드
5. 빠른 시작 (HTML 정적 사이트)
# 1) wrangler 설치 (Node 20+ 필요)
npm i -g wrangler@latest
# 2) 로그인 (브라우저 OAuth)
wrangler login
# 3) 폴더에 index.html 만든 뒤 배포
wrangler pages deploy ./public --project-name my-site
# 4) 커스텀 도메인 연결 (대시보드 또는)
wrangler pages domain add my-site example.com
# 5) (선택) Workers + Static Assets 새 방식
wrangler init my-site
# wrangler.toml 의 [assets] directory 지정 후
wrangler deploy6. 의사결정 요약
| 상황 | 추천 | 월 비용 |
|---|---|---|
| 순수 정적 HTML 호스팅 | Cloudflare Pages 무료 플랜 + 커스텀 도메인 | $0 |
| JAMstack (Next/Astro/Svelte) | Workers Static Assets 권장 (Pages 도 OK) | $0~5 |
| API + DB 필요 | Workers + D1 + KV + R2 | $5 |
| 이미지/영상 CDN | R2 (egress $0) — S3 대안 | $0.015/GB |
| 대규모 트래픽 사이트 | Pages + Workers + Cache API | $5+ |