CLOUDFLARE-FIRST GUIDE 2026 무료 DDoS 방어 · R2 Egress $0 Three.js 3D 네트워크 에디션

바이브 코딩으로 Cloudflare에서
홈페이지 만들기 완전 가이드 2026

처음부터 무거운 유료 서버와 워드프레스를 올리지 않습니다.
무료 플랜에서도 L3~L7 DDoS 공격을 무제한 방어하고, 정적 호스팅 $0 · R2 전송비(Egress) $0 · 원가 도메인을 제공하는 Cloudflare-first 아키텍처로 시작해 꼭 필요한 기능만 조립하는 26장 바이블입니다.

정적 호스팅 & 대역폭
$0 무제한
Astro + Pages 정적 파일 무료 CDN 응답
R2 파일 전송비 혁신
Egress $0
다운로드 대역폭 폭탄 요금 완전 0원
무료 플랜 보안 방패
DDoS 무료
언미터드 DDoS 방어 + 100개 사이트
LIVE 3D — 내 3D 홈페이지를 지키는 무료 DDoS 엣지 방패 & 네트워크 이동
● Shield Active ($0 Free)
DDOS BLOCKED: 100% | ORIGIN LOAD: 0% | EGRESS: $0
02 · WHY CLOUDFLARE #1 — 330+ CITIES ANYCAST EDGE & 0MS COLD START

클플을 써야 하는 이유 ① — 전 세계 330+ 도시 엣지 응답과 0ms 콜드 스타트

단일 리전 서버와 달리, 방문자와 가장 가까운 도시의 엣지 서버가 정적 파일과 API를 즉시 응답합니다

속도 · 글로벌 네트워크
무거운 컨테이너(Lambda) vs Cloudflare V8 Isolates 콜드 스타트 0ms

일반 클라우드 서버리스는 요청이 들어올 때 가상 컨테이너를 켜느라 수백 ms~수 초의 지연(Cold Start)이 생깁니다. Cloudflare Workers는 크롬 V8 격리(Isolates) 엔진으로 즉시 실행됩니다.

  • 정적 파일 $0 무제한급 응답: Astro로 빌드한 HTML·CSS·이미지는 전 세계 330+ 도시 CDN에서 서버 연산 없이 즉시 열립니다.
  • 단일 패스 통합 처리: DNS 조회 → SSL 암호화 → WAF/DDoS 방어 → 캐시·API 응답이 하나의 엣지 노드 안에서 한 번에 끝납니다.
  • 트래픽 폭발 무중단: SNS나 유튜브 유입이 갑자기 몰려도 서버 다운이나 스케일링 대기 시간이 없습니다.
🌐 우측 3D 지구본 확인: 아치형 광케이블 궤적을 따라 가장 가까운 도시 노드가 10ms대에 즉시 응답합니다.
03 · WHY CLOUDFLARE #2 — ZERO EGRESS FEE ($0 BANDWIDTH)

클플을 써야 하는 이유 ② — 데이터 전송비(Egress) $0가 만드는 압도적 가성비

클라우드 요금 폭탄의 주범인 '다운로드 대역폭(Egress) 비용'이 R2·Pages·Workers·D1에서는 아예 $0입니다!

전송비 $0 무료 고속도로
일반 클라우드(S3 과금 톨게이트) vs Cloudflare R2 ($0 하이패스) Egress = Free

AWS S3 등 기존 클라우드는 파일을 저장하는 비용보다 밖으로 내보내는 전송비(Egress)가 훨씬 비쌉니다. 이미지나 PDF가 인기를 끌면 곧바로 요금 폭탄으로 이어집니다.

  • R2 인터넷 전송비 완전 $0: 고화질 포트폴리오 이미지, 브로슈어 PDF, 영상을 수만 명이 다운로드해도 대역폭 요금이 $0(무료)입니다.
  • R2 넉넉한 무료 구간: 매월 10GB 저장 + 쓰기(Class A) 100만 건 + 읽기(Class B) 1,000만 건까지 기본 무료입니다.
  • 원가 도메인(Registrar): 도메인 등록·갱신 시 레지스트리·ICANN 원가만 받으며, 2년 차에 가격을 2~3배 올리는 꼼수 마크업이 없습니다.
일반 클라우드 (S3 등)
$$$ 톨게이트 과금
조회수 폭발 시 대역폭 요금 폭탄
Cloudflare R2 + Pages
Egress $0.00
10GB 무료 + 전송비 평생 0원
04 · WHY CLOUDFLARE #3 — FREE UNMETERED DDOS SHIELD & NO WORDPRESS

클플을 써야 하는 이유 ③ — 무료 플랜도 무제한 DDoS 방어 & 워드프레스 해방

우측 3D 홈페이지로 날아오는 붉은 DDoS 공격이 Cloudflare 방패에 막혀 튕겨 나가는 모습을 직접 확인하세요!

L3~L7 DDoS 무료 방어
전 플랜 무료 언미터드(Unmetered) DDoS 방패 + 100개 사이트 공격 과금 $0

일반 호스팅이나 AWS에서는 경쟁사나 해커가 DDoS 트래픽 공격을 퍼부으면 서버가 죽거나 수백만 원의 트래픽 요금을 물게 됩니다. Cloudflare는 무료($0) 플랜에서도 이를 엣지에서 자동 차단합니다.

  • 언미터드 DDoS & WAF 기본 내장: L3/L4 네트워크 공격과 L7 HTTP DDoS 공격을 엣지 방패에서 흡수하며, 공격 트래픽으로 인한 추가 요금이 전혀 없습니다.
  • 워드프레스 해킹 지옥 해방: PHP·MySQL 상시 서버와 플러그인 취약점이 아예 없으므로 관리자 무차별 대입 공격이 통하지 않습니다.
  • 한 계정에서 100개 사이트 무료 운영: Pages는 계정당 최대 100개 프로젝트를 무료로 생성해 수십 개 브랜드 사이트를 거뜬히 돌립니다.
🔥 우측 하단 [🔥 DDoS 집중 공격 발사] 클릭: 3D 홈페이지는 끄떡없고 공격 패킷만 방패에서 폭파됩니다!
05 · CLOUDFLARE STACK MAP (11 SERVICES OVERVIEW)

이 가이드에서 조립하는 Cloudflare · 보완 서비스 11종 전체 지도

필수 코어 4종, 데이터·스토리지 4종, 확장 서비스 3종의 계층과 역할을 먼저 구분하면 바인딩이 한눈에 보입니다

필수 4 · 데이터 4 · 확장 3
Cloudflare + 보완 서비스 11종 핵심 역할 매트릭스 Architecture Map
계층서비스명홈페이지에서 맡는 역할핵심 운영 포인트
필수 코어Static Assets / Pages정적 HTML·CSS·이미지 글로벌 배포정적 요청 무료·무제한급, 초고속 CDN
필수 코어Workers / Functions문의 폼, 예약, 웹훅 서버리스 API 실행V8 런타임 (Free 일 10만 건 / Paid 월 $5)
필수 코어Wrangler & Bindings리소스 생성 CLI 및 env.DB 연결 계약코드 변수명과 설정 파일 이름 100% 일치 필수
데이터·파일D1 + Turso핵심 운영 DB(D1) + 누적 이벤트 로그(Turso)D1 단일 DB 10GB 한계를 Turso 병용으로 해결
데이터·파일R2 + KV원본 미디어·PDF(R2) + 공지 배너·캐시(KV)R2는 Egress 무료, KV는 글로벌 읽기 특화
고급 확장DO · Queues · Hyperdrive실시간 상태(DO), 비동기 큐, 외부 DB 가속초기엔 생략하고 트래픽·기능 확장 시 도입
06 · SECTION 01 — NEW STANDARD (CLOUDFLARE-FIRST)

01 새 기준 — 이전 스택(Next.js·Vercel·Supabase)과 무엇이 달라졌는가?

"공개 페이지를 먼저 정적으로 가볍게 올리고, 진짜 필요한 기능만 서버리스와 바인딩으로 하나씩 붙인다"

점진적 조립(Progressive)
다중 벤더 분산 스택 vs Cloudflare-First 단일 대시보드 구조 비교

예전 가이드의 Next.js + Vercel + Supabase는 훌륭하지만, 소규모 비즈니스나 개인 프로젝트에서는 프론트·DB·도메인 계정이 3곳으로 나뉘어 관리와 과금 추적이 번거로웠습니다.

이전 다중 플랫폼 방식
  • 프론트 배포: Vercel ($20/월~)
  • DB·스토리지: Supabase / S3
  • 도메인·DNS: 별도 등록기관
  • → 시크릿·권한·청구서가 3곳으로 분산
2026 Cloudflare-First 기준
  • 정적 배포: Astro + Pages ($0)
  • API·DB·파일: Workers + D1 + R2 + KV
  • 도메인·SSL·DDoS: Cloudflare 단일 존
  • → 한 곳에서 네이티브 바인딩으로 즉시 연결
바이브 코딩과 가장 잘 맞는 4단계 점진적 확장 순서 실패 없는 순서
STEP 1 · 읽는 페이지 먼저 공개 (Pages / Static Assets)

홈, 소개, 칼럼, 매장 안내 등 콘텐츠는 정적 HTML로 빌드해 무료 CDN에 먼저 올립니다.

STEP 2 · 꼭 필요한 폼·API만 연결 (Pages Functions / Workers)

문의 접수, 예약 신청, 알림 발송처럼 서버 검증이 필요한 지점에만 작은 함수를 붙입니다.

STEP 3 · 구조화 데이터 연결 (D1 + Turso)

문의·예약 메타는 D1에, 급증하는 방문·클릭 로그는 Turso로 분리해 10GB 한계를 방어합니다.

STEP 4 · 대용량 파일과 캐시 분리 (R2 + KV)

고화질 이미지·PDF 원본은 R2(Egress $0)로 빼고, 공지 배너는 KV로 빠르게 읽습니다.

07 · SECTION 02 & 13 — SITE SCOPE & CONVERSION TEMPLATES

02 대상 정하기 & 13 첫 화면 템플릿 — 방문자의 '다음 행동'을 한 문장으로 정의하라

AI에게 "홈페이지 만들어줘"라고만 하면 예쁜 껍데기만 나옵니다. 4대 유형별 전환 목표를 먼저 못 박으세요

전환 중심 설계
유형 01 · 개인 홈페이지

5초 안에 전문성 전달

"누구에게 어떤 문제를 해결해 주는 사람인지"가 첫 화면 헤드라인에 즉시 드러나야 합니다.

  • 핵심 요소: 한 줄 가치 제안, 대표 글 목록, 연락처 허브
  • 추천 구성: Astro 정적 빌드 + Pages 배포 (유지비 $0)
  • 확장: 뉴스레터 구독 폼(Functions + D1)
🎯 목표: 글 읽고 구독·연락
유형 02 · 포트폴리오

대표 작업물과 성과 증명

화려한 효과보다 실제 작업물과 전후 성과 수치가 먼저 보이고 의뢰 폼으로 이어져야 합니다.

  • 핵심 요소: 프로젝트 카드, 해결 과정, 즉시 의뢰 폼
  • 추천 구성: 고화질 작업물은 R2, 문의는 D1
  • 확장: 분야별 태그 필터(React Island)
🎯 목표: 작업물 확인 후 의뢰
유형 03 · 자영업·로컬 매장

모바일 즉시 예약·길찾기

방문자의 85% 이상이 모바일입니다. 첫 화면에서 전화, 길찾기, 영업시간, 예약을 바로 누르게 합니다.

  • 핵심 요소: 전화·지도 버튼, 영업시간표, 메뉴·가격표
  • 추천 구성: 휴무 배너는 KV, 예약 접수는 D1
  • 확장: 매니저 예약 알림 웹훅 발송
🎯 목표: 위치 확인 후 즉시 예약
유형 04 · 마이크로 웹앱

단일 문제 10초 내 해결

견적 계산기, 참가 신청기, 진단 도구처럼 값을 입력하면 즉시 결과를 얻는 단일 기능에 집중합니다.

  • 핵심 요소: 입력 폼, 실시간 계산 UI, 결과 공유
  • 추천 구성: Astro + React Island + Workers API
  • 확장: 관리자 전용 확인 라우트 분리
🎯 목표: 도구 사용 및 결과 저장
08 · SECTION 03 — DOMAIN · DNS · SSL SAFETY

03 도메인 · DNS · SSL 초반 연결 안정화 — 기존 메일(MX/TXT) 레코드를 절대 지우지 마라

AI에게 DNS 화면을 직접 조작하게 하지 말고, 현재 레코드를 백업한 뒤 추가할 레코드 계획만 표로 받아 승인하세요

DNS 운영 사고 예방
도메인 연결 전 반드시 챙겨야 할 5대 안전 수칙 DNS & SSL
  • 1. 대표 주소(Canonical) 확정: example.com과 www.example.com 중 대표 주소를 정하고 한쪽으로 리다이렉트합니다.
  • 2. 기존 메일 레코드 절대 보존: 구글 워크스페이스·네이버웍스 등의 MX, TXT, SPF, DKIM을 건드리면 회사 메일이 즉시 끊깁니다.
  • 3. 임시 주소(.pages.dev) 선행 QA: 커스텀 도메인 연결 전에 기본 *.pages.dev 주소에서 모바일 화면과 폼 동작을 먼저 검증합니다.
  • 4. 무료 Universal SSL & 알림: 기본 Universal SSL을 켜고 전 플랜 무료인 인증서 발급·만료 알림 메일을 활성화합니다.
  • 5. 원가 도메인(Registrar): 신규 도메인은 마크업 수수료가 전혀 없는 Cloudflare Registrar 원가 등록을 활용합니다.
DNS 변경 시 AI에게 요청하는 안전한 프롬프트 패턴 사람 직접 승인
DNS SAFE PROMPT — 계획표만 받고 대시보드 입력은 사람이 직접! "현재 도메인에 회사 메일용 MX와 TXT 레코드가 있어. 기존 메일이 절대 끊기지 않게 보존하면서 Cloudflare Pages 프로젝트를 루트 도메인과 www에 연결하려면 어떤 DNS 레코드를 추가해야 하는지 표로만 정리해 줘."
레코드 타입이름(Name)조작 원칙
CNAME@ / wwwPages 커스텀 도메인 탭 안내에 따라 연결 추가
MX / TXT@ / _dmarc절대 삭제·수정 금지 (기존 메일 서버 유지)
09 · SECTION 04 — WRANGLER CLI REMOTE CONTROL

04 Wrangler CLI — AI가 명령을 제안하고 사람이 승인해 실행하는 작업 리모컨

Workers, Pages, D1, R2, KV를 터미널에서 다루는 핵심 도구입니다. 실행 전 항상 '무엇을 왜 만드는지' 설명을 먼저 받으세요

승인 기반 터미널 루프
가장 자주 쓰는 Wrangler 필수 명령어 루틴 CLI Standard
# 1. 현재 로그인된 Cloudflare 계정 및 권한 먼저 확인
$ npx wrangler whoami

# 2. D1 데이터베이스 및 R2 버킷 생성 (이름 규칙 일관성 유지)
$ npx wrangler d1 create site-core-db
$ npx wrangler r2 bucket create site-public-media

# 3. 로컬 빌드 및 로컬 바인딩 프리뷰 검증
$ npm run build && npx wrangler pages dev ./dist

# 4. 검증 통과 후 최종 프로덕션 배포 (사람이 직접 승인)
$ npx wrangler pages deploy ./dist
Wrangler 운영 시 반드시 지켜야 할 4대 수칙 네이밍 & 보안
  • 1. 리소스 이름 규칙 초반 확정: 프로젝트명, D1 DB명, R2 버킷명은 나중에 바꾸기 까다로우므로 [브랜드]-[역할]-[환경] 규칙을 처음부터 정합니다.
  • 2. 원격 리소스 생성 전 계획 확인: 원격 DB나 버킷 생성은 계정 한도와 직결되므로 AI가 자동 실행하지 못하게 합니다.
  • 3. 로컬 통과 후 원격 실행: DB 스키마 변경(Migration)은 반드시 --local에서 먼저 성공한 뒤 --remote에 적용합니다.
  • 4. 에러 전달 시 민감 정보 마스킹: 터미널 에러를 AI에게 줄 때 API 토큰, 계정 ID, 이메일 주소는 반드시 지우고 전달합니다.
10 · SECTION 05 — AI PERMISSION DELEGATION BOUNDARIES

05 AI 권한 위임 — "코드와 초안은 AI에게, 비밀값과 파괴적 명령은 사람이 통제한다"

AI 에이전트에게 전체 관리자 토큰을 주면 실수로 운영 DB 삭제나 의도치 않은 프로덕션 배포가 일어날 수 있습니다

최소 권한 원칙 (Least Privilege)
AI 코딩 파트너 vs 사람(승인자)의 명확한 역할 분담표 권한 분리
구분담당 주체구체적인 작업 범위
설계 및 코딩AI 코딩 파트너폴더 구조 계획, Astro/React 컴포넌트 작성, Functions API 코드, wrangler.toml 초안
진단 및 제안AI 코딩 파트너실행할 CLI 명령어 제안, 빌드/런타임 에러 로그 원인 분석, SQL 스키마 초안 작성
인증 및 결제사람 직접 통제대시보드 로그인, 최소 권한 API 토큰 발급, 결제 수단 등록 및 예산 알림 설정
파괴적·운영 명령사람 직접 통제리소스 삭제(Delete), 캐시 전체 Purge, 운영 DB 원격 Migration, 최종 Production 배포
안전한 API 토큰 운용 3원칙 토큰 거버넌스
  • 1. Global API Key 사용 절대 금지: 계정 전체를 좌우하는 Global Key 대신, 특정 프로젝트(Pages Edit, D1 Edit)만 허용된 Scoped API Token을 만듭니다.
  • 2. 실제 값 대신 변수 이름만 공유: 채팅창에는 토큰 원문을 절대 넣지 말고 CLOUDFLARE_API_TOKEN, RESEND_API_KEY 같은 변수 이름만 알려줍니다.
  • 3. 작업 종료 후 임시 토큰 회수(Revoke): 배포 테스트용으로 발급한 토큰은 작업이 끝나면 대시보드에서 즉시 폐기하거나 권한을 낮춥니다.
💡 핵심 원칙: AI에게 "알아서 배포까지 다 해줘"라고 시키는 순간 안전장치가 사라집니다.
11 · SECTION 08 — SECRETS & 3-STAGE ENVIRONMENT BINDINGS

08 환경 변수와 바인딩 — local · preview · production 3단계 환경 맞추기

로컬에선 됐는데 배포 후 깨지는 이유의 90%는 바인딩 이름 불일치나 원격 Secret 누락 때문입니다

런타임 계약 3D 시각화
로컬(.env.local) vs 운영(Secrets) 철저 분리 3단계 환경 관리

Git 저장소에는 실제 비밀번호가 없는 .env.example만 커밋합니다. 실제 비밀값은 로컬에선 .env.local(또는 .dev.vars)에 두고, 운영에선 Cloudflare Secrets에 등록합니다.

# .env.example (Git 커밋용 — 키 이름과 용도만 기록)
PUBLIC_SITE_URL="https://example.com" # 브라우저 노출 허용
RESEND_API_KEY="" # 서버 전용: wrangler secret put 으로 등록
TURSO_AUTH_TOKEN="" # 절대 클라이언트 코드에서 참조 금지!
  • 바인딩 이름 = 런타임 계약: wrangler.toml에 binding = "DB"라고 적었다면 서버 코드에서도 반드시 env.DB로만 호출해야 합니다.
  • 유출 시 1분 내 폐기: API 키나 DB 토큰이 실수로 Git에 올라갔다면 커밋만 지우지 말고 즉시 키를 폐기(Revoke)하고 재발급합니다.
12 · SECTION 06 & 07 — ASTRO ISLANDS & FUNCTIONS VS WORKERS

06 Astro 콘텐츠 골격 & 07 Pages Functions vs 독립 Workers 위치 나누기

읽는 화면은 Astro 정적 HTML로 가볍게 만들고, 서버 코드는 성격에 따라 페이지 근처(Functions)와 독립 Worker로 나눕니다

프론트 · 백엔드 황금 비율
06. 왜 홈페이지 프론트엔드로 Astro인가? 아일랜드 아키텍처

회사 소개, 포트폴리오, 칼럼, 매장 안내처럼 읽는 콘텐츠가 중심인 사이트는 무거운 SPA보다 Astro가 압도적으로 빠릅니다.

  • Zero-JS 기본 지향: 불필요한 자바스크립트를 덜어낸 순수 정적 HTML을 생성해 초기 로딩 속도와 SEO 점수를 극대화합니다.
  • 부분 상호작용(Islands): 견적 계산기, 실시간 검색창, 예약 달력처럼 동작이 꼭 필요한 부분만 React 컴포넌트를 섬(Island)처럼 끼워 넣습니다.
  • 공통 템플릿 내장: 헤더·풋터, OpenGraph, 사이트맵, robots.txt를 초반에 공통 레이아웃으로 묶어 둡니다.
07. Pages Functions vs 독립 Workers 선택 기준표 서버 코드 위치 결정
구현할 기능추천 위치선택 이유 및 운영 장점
문의·예약 폼 저장Pages Functions프론트 입력 폼과 API 라우트(/functions/api)가 한 저장소에 붙어 있어 관리가 직관적임
R2 업로드 서명 발급Pages Functions / WorkerR2 쓰기 권한과 서명 비밀키를 브라우저에 숨기고 안전하게 업로드 URL만 내려줌
정기 크론(Cron) 집계독립 Worker매일 자정 통계 집계, 정기 리포트 발송 등 Cron Triggers 스케줄 실행에 최적화
다수 사이트 공통 API독립 Worker여러 홈페이지에서 공통으로 호출하는 인증·결제 웹훅·알림 게이트웨이를 한 곳에서 관리
13 · SECTION 09 — D1 + TURSO HYBRID DATABASE STRATEGY

09 운영 데이터 저장 — 왜 핵심 DB는 D1에 두고 누적 로그는 Turso로 분리하는가?

D1은 단일 데이터베이스 최대 10GB(Paid 기준) 한계가 있으므로, 끝없이 쌓이는 방문·이벤트 로그는 Turso로 나누는 것이 정석입니다

D1 10GB 한계 돌파 설계
Cloudflare D1 (핵심 메타) vs Turso (누적 이벤트 로그) 하이브리드 DB 분담

모든 데이터를 D1 하나에 몰아넣으면 방문자 이벤트가 쌓일 때 단일 DB 10GB 용량 한계와 Rows Read 스캔 비용이 급증합니다.

  • Cloudflare D1에 둘 데이터: 고객 문의 내역, 예약 신청, 게시글/칼럼 메타데이터, 상품 카탈로그, 관리자 설정 등 핵심 운영 데이터 (`env.DB` 네이티브 바인딩).
  • Turso(libSQL)로 뺄 데이터: 페이지뷰 누적 로그, 버튼 클릭 이벤트, 일별/실시간 인기 순위 원천 데이터 (`TURSO_DATABASE_URL` + Secret 토큰 연결).
  • 필수 스키마 습관: 모든 운영 테이블에는 처음부터 id, created_at, updated_at, status 컬럼과 조회 조건 인덱스(Index)를 반드시 넣습니다.
14 · SECTION 10 & 11 — R2 MEDIA STORAGE & KV EDGE CACHE

10 파일 저장소 R2 & 11 빠른 설정·캐시 KV — 4대 저장소(D1·Turso·R2·KV) 총정리

DB에 이미지 바이너리를 직접 넣지 마세요! 파일 원본은 R2에 두고 DB에는 파일 경로(URL/Key)만 기록합니다

4대 저장소 완벽 비교
R2 폴더(Prefix) 규칙 & KV 주의점 Storage Rules
  • R2 디렉터리 Prefix 설계: 버킷 안에 public/portfolio/2026/..., private/invoices/...처럼 공개 파일과 비공개 첨부파일 경로를 명확히 나눕니다.
  • 업로드 제한 검증: 허용 확장자(webp, pdf 등)와 최대 파일 크기를 Pages Functions에서 먼저 검사한 뒤 R2에 올립니다.
  • KV는 '읽기 특화' 저장소: 공지 배너 문구, 임시 휴무 플래그, 인기글 캐시처럼 자주 읽고 가끔 바꾸는 값에 최적입니다.
  • KV에 절대 넣으면 안 되는 것: KV는 결과적 일관성(Eventually Consistent) 구조이므로 실시간 재고 수량 차감이나 결제 원장을 KV에 두면 데이터가 어긋납니다.
홈페이지 4대 저장소(D1 · Turso · R2 · KV) 한눈에 비교표 4-Way Storage Matrix
저장소성격홈페이지 추천 데이터핵심 주의사항
D1네이티브 핵심 SQL문의, 예약, 게시글 메타, 카탈로그, 설정단일 DB 10GB 한계 및 rows 스캔 관리 (인덱스 필수)
Turso누적 로그·통계 DB방문 로그, 클릭 이벤트 누적, 인기 순위 집계외부 HTTP/SDK 연결 → URL·토큰을 Secret에 보관
R2오브젝트 파일 저장소고화질 이미지 원본, PDF 브로슈어, 백업Egress $0 무료! DB에는 파일 URL/키만 저장
KV글로벌 엣지 읽기 캐시공지 배너 문구, 기능 플래그, API 응답 캐시쓰기 직후 전파 지연 가능 → 결제·재고 원본 금지
15 · INTERACTIVE 3D REQUEST ROUTER & BINDING STUDIO

실전 3D 아키텍처 스튜디오 — 사이트 시나리오를 클릭해 3D 패킷 흐름과 바인딩을 확인하세요!

시나리오 버튼을 누르면 우측 3D 라우팅 그래프에서 요청 패킷이 해당 서비스 노드로 실시간 분기되며 wrangler.toml이 생성됩니다

Interactive 3D Simulator
SIMULATOR — 포트폴리오 + 문의 폼 + 고화질 작업물 추천 아키텍처

Astro 정적 페이지 + Pages Functions + D1(문의) + R2(포트폴리오 이미지)

작업물 목록은 Astro 정적으로 빠르게 보여주고, 고해상도 이미지와 PDF는 R2(env.MEDIA)에 분리합니다. 고객 문의 폼 제출 시 Pages Functions가 D1(env.DB)에 안전하게 기록합니다.

① 사이트 유형 시나리오 선택 (클릭 시 3D 라우터 & 코드 연동)
프론트엔드 Astro Static + React Island
서버리스 API Pages Functions (/functions/api)
데이터베이스 Cloudflare D1 (env.DB)
파일 / 캐시 R2 (env.MEDIA) + KV (env.SITE_FLAGS)
# wrangler.toml 런타임 바인딩 계약 예시 (코드의 env 이름과 100% 일치 필수) name = "my-cloudflare-site" pages_build_output_dir = "./dist" [[d1_databases]] binding = "DB" database_name = "site-core-db" database_id = "xxxx-xxxx-xxxx" # local / preview / prod 분리 관리 [[r2_buckets]] binding = "MEDIA" bucket_name = "site-public-media"
16 · SECTION 12 — VIBE CODING 3-STEP LOOP

12 바이브 코딩 프롬프트 루프 — 한 번에 통째로 시키지 말고 3단계로 끊어라

실패하는 바이브 코딩은 첫 프롬프트에서 제작부터 배포까지 한 방에 시킵니다. [계획 → 수정 → 검증]으로 쪼개세요

1. 계획 → 2. 수정 → 3. 검증
❌ 실패하는 한 방 지시 vs ⭕ 성공하는 3단계 분할 루프 프롬프트 통제 기술
❌ 나쁜 지시 (폴더 구조 붕괴 및 무단 배포 위험) "Cloudflare로 예약이랑 게시판이랑 관리자 다 되는 홈페이지 통째로 만들어서 바로 배포까지 해줘!"
⭕ 좋은 지시 (1단계 계획만 먼저 요청) "1단계로 홈 화면의 섹션 구조와 수정할 파일 목록만 먼저 계획해서 표로 보여줘. 아직 코드는 고치지 말고, 기존 공통 레이아웃·버튼·SEO 컴포넌트를 찾아 재사용해줘."
  • 1단계 (Plan): 수정할 파일 목록, 바인딩 이름, DB 스키마만 표로 받고 사람이 검토합니다.
  • 2단계 (Modify): 승인된 범위의 파일만 수정하게 하고, 새 패키지 설치 전에는 이유를 먼저 묻습니다.
  • 3단계 (Summary & Verify): 변경된 파일 요약과 남은 위험 요소를 보고받은 뒤 로컬 검증으로 넘어갑니다.
17 · SECTION 14 — LOCAL VERIFICATION PIPELINE

14 로컬 검증 — dev · build · preview 3단 관문을 통과하기 전엔 배포하지 마라

개발 서버(dev)에서 잘 보여도 정적 빌드(build)나 Wrangler 바인딩 프리뷰(preview)에서 깨지는 경우가 많습니다

배포 전 필수 3관문
배포 전 반드시 거치는 터미널 3단계 검증 루틴 Verification Loop
# [관문 1] 개발 서버에서 레이아웃, 반응형 UI, 기본 인터랙션 확인
$ npm run dev

# [관문 2] 타입 오류나 깨진 import 없이 정적 산출물(dist)이 생성되는지 확인
$ npm run build

# [관문 3] D1·R2·KV 바인딩이 연결된 상태에서 Functions API 동작 검증
$ npx wrangler pages dev ./dist
✔ Production 배포는 마지막 1회: 위 3관문이 모두 통과한 뒤 마지막 한 번만 배포합니다.
AI에게 에러를 가장 정확하게 고치게 하는 '3종 압축 전달법' 디버깅 효율 5배 향상

터미널 오류 수백 줄을 통째로 붙여넣으면 AI가 문맥을 잃고 엉뚱한 파일을 건드립니다. 딱 아래 3가지 핵심 정보만 추려서 전달하세요.

  • ① 처음 실패한 명령어: npm run build에서 깨졌는지, wrangler pages dev 런타임에서 깨졌는지 명시합니다.
  • ② 핵심 에러 메시지 첫 20줄: 가장 처음 등장한 Error: ...와 스택 트레이스 상단 20줄만 발췌합니다 (민감 정보 마스킹).
  • ③ 방금 수정한 파일 목록: 직전 단계에서 건드린 파일 2~3개가 무엇인지 함께 알려주면 원인을 10초 안에 찾습니다.
18 · SECTION 15 — DEPLOYMENT PIPELINE UNIFICATION

15 배포 흐름 — GitHub 자동 배포와 Wrangler CLI 직접 배포를 섞어 쓰지 마라

어느 날은 Git push로 올리고 어느 날은 터미널 CLI로 올리면 운영 버전이 꼬입니다. 한 프로젝트는 하나의 배포 루트로 통일하세요

Preview → Production 승격
방식 A: GitHub 연결 자동 배포 vs 방식 B: Wrangler CLI 배포 배포 루트 비교
구분방식 A · GitHub 저장소 자동 배포방식 B · Wrangler CLI 직접 배포
작동 방식PR/브랜치 푸시 시 Preview URL 자동 생성, main 병합 시 Production 배포로컬에서 npm run build 완료 후 wrangler pages deploy ./dist 실행
가장 큰 장점커밋 이력과 배포 버전이 1:1 연동되고 대시보드 롤백이 매우 쉬움빠른 로컬 PC 빌드 자원을 활용하며 배포 시점을 사람이 직접 통제함
추천 대상처음 운영하는 개인·스몰 비즈니스 사이트 (강력 추천)복잡한 모노레포이거나 커스텀 빌드 스크립트 통제가 필요한 개발자
배포 사고를 막는 4대 체크포인트 Deployment Safety
  • 1. Build와 Deploy 단계 분리: 코드 빌드 오류인지 Cloudflare 권한 오류인지 즉시 구분합니다.
  • 2. 빌드 환경 명문화: 빌드 명령(npm run build), 출력 폴더(dist), Node 버전(Node 20/22)을 대시보드와 문서에 똑같이 적어 둡니다.
  • 3. Preview 브랜치 선행 검증: 바로 main에 푸시하지 말고 preview 미리보기 URL로 모바일 화면과 폼 전송을 먼저 테스트합니다.
  • 4. 도메인 연결 직후 점검: 커스텀 도메인 연결 직후 canonical URL과 sitemap.xml 주소가 실제 도메인으로 바뀌었는지 확인합니다.
19 · SECTION 16 — PUBLIC QUALITY: SEO · ACCESSIBILITY · MOBILE 360PX

16 공개 품질 — 검색 노출(SEO)과 모바일 360px 가독성은 처음부터 템플릿에 내장하라

사이트를 다 만든 뒤에 메타태그와 모바일 화면을 고치려면 전체 페이지를 다 뜯어고쳐야 합니다

검색 색인 & UX 표준
검색 엔진이 즉시 색인하는 필수 SEO 4종 세트 SEO Built-in

Astro의 공통 BaseLayout.astro 상단 <head>에 아래 요소들을 props로 받아 모든 페이지가 고유한 메타 정보를 갖도록 강제합니다.

  • 1. 고유한 Title & Description: 모든 페이지가 똑같은 제목을 쓰지 않도록 페이지별 핵심 키워드와 요약문을 부여합니다.
  • 2. 정확한 Canonical URL: 중복 문서 페널티를 막기 위해 <link rel="canonical">이 실제 공개 도메인을 가리키게 합니다.
  • 3. OpenGraph 공유 썸네일: 카카오톡·슬랙 공유 시 매력적인 대표 이미지(1200×630)와 제목이 뜨는지 점검합니다.
  • 4. Sitemap & Robots.txt: @astrojs/sitemap으로 자동 생성하고 구글 서치콘솔·네이버 서치어드바이저에 등록합니다.
웹 접근성(A11y) 및 모바일 360px 필승 점검표 Mobile & A11y
  • 모바일 360px 폭 강제 점검: 작은 스마트폰(360px 폭)에서 글자가 세로로 깨지거나 버튼이 겹치지 않도록 "모바일 360px 기준으로 word-break: keep-all과 가로 스크롤 여부를 점검해 줘"라고 지시하세요.
  • 시맨틱 태그 준수: 클릭 동작은 <div>가 아닌 실제 <button>이나 <a> 태그로 작성합니다.
  • 의미 있는 Alt 텍스트: 정보성 이미지에는 명확한 대체 텍스트(alt)를 넣습니다.
  • Lighthouse 90점 이상 확인: 배포 전 크롬 Lighthouse로 Performance, Accessibility, SEO를 1회 스캔합니다.
20 · SECTION 17 & 18 — OPERATIONS HABITS & TROUBLESHOOTING

17 장기 운영 습관 (백업·문서화) & 18 자주 만나는 4대 장애 증상 진단표

AI가 짠 설정이라도 사람이 1분 만에 파악할 수 있게 표로 문서화하고, 장애 시 연결 지점부터 하나씩 좁혀 나갑니다

유지보수 & 빠른 복구
17. 운영 자산을 지키는 4대 습관 Operations
  • 1. DB 마이그레이션 이력화: D1 스키마 변경 파일명에는 20261103_add_booking.sql처럼 날짜와 목적을 남깁니다.
  • 2. R2 보관 주기 및 백업 규칙: R2 버킷 폴더 구조와 원본 보관·백업 주기를 문서에 명시합니다.
  • 3. 개인정보·토큰 로그 배제: console.log에는 고객 전화번호나 인증 토큰 원문을 절대 남기지 않습니다.
  • 4. 월 1회 정기 점검 루틴: 매월 1일 무료 한도 사용량, 에러 로그, 문의 폼 정상 작동 여부를 테스트합니다.
18. 자주 만나는 4대 장애 증상별 1순위 진단 매트릭스 Troubleshooting
발생 증상가장 먼저 확인할 곳AI에게 전달할 핵심 진단 정보
배포 성공 후 404빌드 출력 폴더(dist) 설정과 라우팅빌드 명령어, 생성된 dist 폴더 트리, Pages 출력 디렉터리 설정값
폼 제출 시 DB 500wrangler 바인딩 이름과 원격 테이블 유무wrangler.toml 바인딩 블록, 코드의 env.DB 호출부, 원격 마이그레이션 여부
R2 이미지 엑박R2 공개 도메인 연결 및 파일 키 경로요청 이미지 URL, Network 탭 응답 코드(403/404), 버킷 공개 설정
도메인 안 열림DNS 레코드(CNAME/A) 및 SSL 발급 상태현재 DNS 레코드 목록(민감정보 제외), Pages 커스텀 도메인 Active 여부
21 · SECTION 19 — PRICING SENSE & 3-PLATFORM COMPARISON

19 가격 감각 — Cloudflare($0~$5) · Vercel($20) · Supabase($25) 과금 비교

정적 파일 요청은 무료·무제한이지만 Pages Functions를 호출하는 순간 Workers 요청 한도에 합산된다는 점을 기억하세요

압도적 가성비 비교
플랫폼 3사 유료 시작점 & 과금 경계 완벽 비교 Pricing Matrix
플랫폼유료 시작점 및 핵심 과금 구조가장 빛을 발하는 프로젝트
CloudflareFree $0 / Workers Paid 월 $5
(정적 무료 · R2 Egress $0 · 무료 DDoS)
콘텐츠 홈페이지 + 가벼운 API, 포트폴리오, 매장 사이트 다수 운영
VercelPro 월 $20 + 대역폭/함수 종량 과금복잡한 Next.js SSR 제품 및 팀 단위 PR 협업
SupabasePro 월 $25 + Postgres/Auth 통합무거운 Postgres 조인·소셜 로그인·실시간 구독 앱
⚡ 핵심 경계: 정적 HTML·이미지는 무료·무제한! 폼 제출 등 Functions 호출만 Workers 한도(Free 일 10만 건, CPU 10ms / Paid 월 $5에 1,000만 건, CPU 최대 5분)를 씁니다.
22 · SECTION 20 & 22 — 7 HONEST CONS & PLATFORM PHILOSOPHY

20 솔직한 단점 7가지 & 22 플랫폼 철학 (통합 제품 Vercel vs 조립 플랫폼 Cloudflare)

Cloudflare는 압도적으로 저렴하고 빠르지만, 부품이 잘게 나뉘어 있어 바인딩 계약과 환경 분리를 앞단에서 설계해야 합니다

도입 전 트레이드오프
20. 도입 전 반드시 알고 가야 할 솔직한 단점 7가지 조립의 복잡성
  • 1. 독립 부품 연결 필요: Pages, D1, R2, KV를 따로 만들고 바인딩으로 연결해야 합니다.
  • 2. 바인딩 이름 = 런타임 계약: wrangler.toml과 코드의 env.* 이름이 다르면 에러가 납니다.
  • 3. 3갈래 환경 분리 관리: local · preview · production 리소스 ID와 Secret을 표로 맞춰야 합니다.
  • 4. D1 단일 DB 10GB 한계: 대형 Postgres가 아니므로 누적 로그는 Turso 등으로 분리해야 합니다.
  • 5. Functions 호출 시 Workers 한도 차감: 정적 요청과 동적 API 요청 한도를 구분해야 합니다.
  • 6. V8 런타임 제약: Node 서버의 로컬 파일시스템(fs)이나 무거운 네이티브 모듈은 그대로 못 씁니다.
  • 7. 세분화된 과금 지표: 요청 수, CPU 시간, D1 rows, R2 Class A/B 개념을 알고 써야 합니다.
22. 철학의 차이: 왜 Cloudflare는 부품을 조립하게 할까? Product vs Platform

Cloudflare가 처음에 낯선 이유는 통합 프레임워크 제품이 뒤에서 숨겨 주는 인프라 결정권(비용·캐시·저장소 위치)을 개발자에게 직접 돌려주기 때문입니다.

Vercel = 프레임워크 통합 제품

연결은 쉽지만 트래픽 증가 시 인프라 제어권과 대역폭 비용 통제 폭이 좁음

Cloudflare = 엣지 조립 플랫폼

초반 바인딩 표만 맞추면 전 세계 엣지에서 가장 저렴하고 안전하게 수십 개 사이트를 통제함

💡 결론: AI 바이브 코딩이 초기 wrangler.toml과 바인딩 표 작성을 도와주므로 조립 허들이 사라졌습니다!
23 · SECTION 21 — COPY-PASTE VIBE CODING PROMPTS & MASTER SHEET

21 딸깍 복사용 실전 프롬프트 3종 & 마스터 치트시트

비밀값이나 계정 ID는 절대 넣지 마세요! 대괄호 `[ ]` 안의 사이트 목적만 바꿔 복사한 뒤 AI 코딩 도구에 바로 붙여넣으세요

프롬프트 01 · 초기 설계 & 골격 계획
STEP 1 — PLAN ONLY (코드 수정 전 계획 승인) "Astro + Cloudflare Pages 기준으로 [자영업 매장 소개 및 예약] 사이트를 만들려고 해. 아직 코드는 고치지 말고, 1) 첫 화면 전환 목표에 맞춘 섹션 구조, 2) 정적 페이지와 Pages Functions API 분리안, 3) D1·R2·KV 바인딩 표, 4) 수정할 파일 목록만 먼저 계획해서 표로 보여줘."
  • 핵심 효과: AI가 바로 코드를 뒤엎거나 무단 배포하지 못하도록 1단계 설계 표부터 받아냅니다.
프롬프트 02 · D1 · R2 · KV 안전 구현
STEP 2 — SAFE IMPLEMENTATION (바인딩 & 시크릿 보호) "승인한 계획대로 문의 폼 API를 Pages Functions로 구현해줘. DB 바인딩 이름은 `env.DB`(D1), 첨부 이미지는 `env.MEDIA`(R2)를 사용하고, created_at·updated_at·status 컬럼을 포함해줘. 실제 토큰이나 비밀값은 코드에 넣지 말고 `.env.example`과 `wrangler` 설정 예시만 작성해줘."
  • 핵심 효과: 바인딩 이름(`env.DB`, `env.MEDIA`)을 고정해 배포 후 런타임 에러를 원천 차단합니다.
프롬프트 03 · 로컬 검증 & 배포전 QA
STEP 3 — VERIFY & QA (배포 자동 실행 금지) "방금 수정한 파일 목록과 요약을 정리해줘. 원격 리소스 생성이나 production deploy 명령은 직접 실행하지 말고, 내가 로컬에서 `npm run dev`, `npm run build`, preview 순서로 검증할 명령어와 모바일 360px 텍스트 겹침·SEO(title, canonical, sitemap) 체크리스트만 알려줘."
  • 핵심 효과: 로컬 3단 관문과 모바일 360px·SEO 체크리스트를 거친 뒤 사람이 최종 배포합니다.
24 · PRACTICAL BENEFITS ① — COST · NO WORDPRESS · MULTI-SITE

실무 이점 총정리 ① — 무료 시작점, 워드프레스 해방, 계정당 100개 사이트 확장

공식 문서로 확인된 무료 한도와 유료($5) 경계 수치만 정확하게 정리했습니다

공식 문서 기준 수치
홈페이지 비용 — $0 Free 시작점과 월 $5 Paid 시작점 Workers · Pages
  • 정적 홈페이지($0): Pages·Workers의 정적 asset 요청은 무료·무제한입니다. 소개·포트폴리오 사이트는 Workers Free($0)로 충분합니다.
  • 동적 API 호출(일 10만 건 무료): Pages Functions와 Workers 요청은 Free에서 하루 100,000건을 공유합니다(UTC 자정 리셋, 초과 시 에러 1027).
  • Workers Paid(월 $5): 계정당 최소 월 $5에 월 1,000만 요청 포함(추가 100만 건당 $0.30), 데이터 전송(egress) 추가 요금이 없습니다.
  • Pages Free 빌드·파일 한도: 월 500회 빌드, 동시 빌드 1개, 사이트당 파일 20,000개, 파일당 최대 25MiB까지 무료 제공됩니다.

출처: Cloudflare Workers pricing·limits, Pages functions pricing·limits, plans/free

워드프레스 없이 한 계정에서 수십 개 사이트 운영 멀티 사이트 한도
  • 무거운 CMS 불필요: 워드프레스(PHP+MySQL) 없이 Astro 정적 사이트를 Pages에 올리고 폼·API만 Functions로 가볍게 붙입니다.
  • Pages 프로젝트 100개: 계정당 최대 100개의 Pages 프로젝트를 생성할 수 있으며, 커스텀 도메인도 프로젝트당 100개까지 연결됩니다.
  • 독립 Workers 개수: Free 기준 100개, Paid 기준 500개까지 생성 가능하며 Pages 프로젝트 한도와 별도로 계산됩니다.
  • 도메인 대량 추가 규칙: 10분에 최대 25개까지 도메인 추가가 가능하여 수십 개 브랜드·랜딩 사이트를 단일 계정에서 넉넉히 운영합니다.

출처: Cloudflare Pages limits, Workers limits, Fundamentals — add multiple sites

25 · PRACTICAL BENEFITS ② — D1 · CDN CACHE · DDOS · REGISTRAR · R2

실무 이점 총정리 ② — 무료 D1 한도 · CDN 캐시 · 언미터드 DDoS · 원가 도메인 · R2

Free 플랜만으로도 DB, 글로벌 캐시, L3~L7 DDoS 보호, 무료 SSL, R2 10GB 스토리지를 즉시 사용할 수 있습니다

인프라 & 스토리지 혜택
D1 데이터베이스 · CDN 캐시 · 언미터드 DDoS 보호 Free 기본 제공
  • D1 무료 구간: Free에서도 DB 10개, 총 저장 5GB(DB당 500MB), 일 읽기 500만 행, 일 쓰기 10만 행이 무료이며 데이터 전송(egress) 요금이 없습니다.
  • 글로벌 CDN 캐시: Free 존에 기본 포함되며 Cache Rules 10개를 제공합니다(정적 파일 확장자 기본 캐시, HTML·JSON은 기본 미캐시).
  • 언미터드 DDoS 방패: 전 플랜에 L3~L7 표준 언미터드 DDoS 및 HTTP DDoS 보호가 제공되며, 공격 트래픽 급증으로 인한 종량 과금이 없습니다.
  • 기본 WAF & SSL: 새 존에는 Free Managed Ruleset(Log4j, Shellshock, 워드프레스 취약점 방어)과 커스텀 룰, Universal SSL이 무료 배포됩니다.

출처: D1 pricing, Cache plans·default behavior, DDoS docs, WAF managed rules

마크업 없는 원가 도메인(Registrar) & R2 Egress Free 숨은 비용 제로
  • 원가 도메인 등록·갱신: Cloudflare Registrar는 레지스트리와 ICANN 원가만 청구하며 별도 마크업이나 숨은 수수료(Surprise fee)가 없습니다.
  • 투명한 확장자별 가격: 도메인 가격은 TLD마다 다르므로 단일 달러 금액으로 고정하지 않으며 pricing.registrar.cloudflare.com을 따릅니다.
  • R2 Egress = Free: 어떤 스토리지 클래스든 인터넷으로 나가는 데이터 전송(Egress) 대역폭 요금이 $0입니다.
  • R2 Standard 무료 구간: 월 10GB-month 저장, Class A 100만 요청, Class B 1,000만 요청까지 무료입니다(Infrequent Access 조회 시 GB당 $0.01 별도).

출처: Cloudflare Registrar overview, R2 pricing, R2 how-it-works

26 · PRACTICAL BENEFITS ③ — PAYPAL · BUDGET ALERTS · ANALYTICS · NOTIFICATIONS

실무 이점 총정리 ③ — PayPal 결제 · 예산 알림 · 30일 트래픽 분석 · 보안 메일

예산 알림은 메일로 경고를 보내지만 서비스를 자동 중단(Hard Cap)하지는 않으므로 정확한 동작 범위를 알고 써야 합니다

결제 · 모니터링 완결
편리한 결제 수단 · 예산 알림 · 30일 트래픽 분석 Billing & Analytics
  • PayPal 결제 지원: 주요 신용·체크카드뿐만 아니라 PayPal(US 외 지역은 미화 USD 기준)로 간편하게 결제 수단을 연결할 수 있습니다.
  • Usage Based Billing 알림: Workers, D1, R2 등 종량제 상품에 청구 금액 기준 알림을 설정하면 도달 시 이메일을 보냅니다(단, 서비스 자동 차단 Hard Cap은 아니며 1일 최대 1회 발송).
  • 30일 트래픽·보안 분석: Zone Analytics 및 HTTP Traffic 분석은 Free를 포함한 모든 플랜에서 최대 30일 범위의 요청·대역폭·위협 지표를 제공합니다.
  • GraphQL Analytics API: 대시보드 UI의 원천 데이터셋을 GraphQL 쿼리로 직접 조회해 커스텀 모니터링에도 활용할 수 있습니다.

출처: Cloudflare payment methods, billing policy, Analytics FAQ, HTTP traffic

보안·SSL·DDoS 이메일 알림 (확정 사실 vs 미확인 구분) Notifications
  • 전 플랜 무료 이메일 알림: DDoS 공격 감지, SSL/TLS 인증서 발급·만료, Origin 오류율 상승, 봇 트래픽 급증 알림을 이메일로 무료 수신합니다.
  • Security Insights: 보안 설정상의 잠재적 위험이나 조치 권장 사항을 스캔해 알려줍니다.
  • ⚠️ 미확인 항목 투명 고지: "PHP 코드 등 특정 언어 취약점을 직접 스캔해 경고 메일을 보낸다"는 내용은 공식 문서에서 확인되지 않습니다(대신 Free WAF Managed Ruleset이 Log4j·워드프레스 등 알려진 웹 취약점 요청을 차단합니다).
🎉 완결: 이제 1단계 계획 프롬프트(23p)를 복사해 나만의 Cloudflare 홈페이지를 안전하게 시작하세요!