바이브 코딩으로 Cloudflare에서
홈페이지 만들기 완전 가이드 2026
처음부터 무거운 유료 서버와 워드프레스를 올리지 않습니다.
무료 플랜에서도 L3~L7 DDoS 공격을 무제한 방어하고, 정적 호스팅 $0 · R2 전송비(Egress) $0 · 원가 도메인을 제공하는 Cloudflare-first 아키텍처로 시작해 꼭 필요한 기능만 조립하는 26장 바이블입니다.
클플을 써야 하는 이유 ① — 전 세계 330+ 도시 엣지 응답과 0ms 콜드 스타트
단일 리전 서버와 달리, 방문자와 가장 가까운 도시의 엣지 서버가 정적 파일과 API를 즉시 응답합니다
일반 클라우드 서버리스는 요청이 들어올 때 가상 컨테이너를 켜느라 수백 ms~수 초의 지연(Cold Start)이 생깁니다. Cloudflare Workers는 크롬 V8 격리(Isolates) 엔진으로 즉시 실행됩니다.
- 정적 파일 $0 무제한급 응답: Astro로 빌드한 HTML·CSS·이미지는 전 세계 330+ 도시 CDN에서 서버 연산 없이 즉시 열립니다.
- 단일 패스 통합 처리: DNS 조회 → SSL 암호화 → WAF/DDoS 방어 → 캐시·API 응답이 하나의 엣지 노드 안에서 한 번에 끝납니다.
- 트래픽 폭발 무중단: SNS나 유튜브 유입이 갑자기 몰려도 서버 다운이나 스케일링 대기 시간이 없습니다.
클플을 써야 하는 이유 ② — 데이터 전송비(Egress) $0가 만드는 압도적 가성비
클라우드 요금 폭탄의 주범인 '다운로드 대역폭(Egress) 비용'이 R2·Pages·Workers·D1에서는 아예 $0입니다!
AWS S3 등 기존 클라우드는 파일을 저장하는 비용보다 밖으로 내보내는 전송비(Egress)가 훨씬 비쌉니다. 이미지나 PDF가 인기를 끌면 곧바로 요금 폭탄으로 이어집니다.
- R2 인터넷 전송비 완전 $0: 고화질 포트폴리오 이미지, 브로슈어 PDF, 영상을 수만 명이 다운로드해도 대역폭 요금이 $0(무료)입니다.
- R2 넉넉한 무료 구간: 매월 10GB 저장 + 쓰기(Class A) 100만 건 + 읽기(Class B) 1,000만 건까지 기본 무료입니다.
- 원가 도메인(Registrar): 도메인 등록·갱신 시 레지스트리·ICANN 원가만 받으며, 2년 차에 가격을 2~3배 올리는 꼼수 마크업이 없습니다.
클플을 써야 하는 이유 ③ — 무료 플랜도 무제한 DDoS 방어 & 워드프레스 해방
우측 3D 홈페이지로 날아오는 붉은 DDoS 공격이 Cloudflare 방패에 막혀 튕겨 나가는 모습을 직접 확인하세요!
일반 호스팅이나 AWS에서는 경쟁사나 해커가 DDoS 트래픽 공격을 퍼부으면 서버가 죽거나 수백만 원의 트래픽 요금을 물게 됩니다. Cloudflare는 무료($0) 플랜에서도 이를 엣지에서 자동 차단합니다.
- 언미터드 DDoS & WAF 기본 내장: L3/L4 네트워크 공격과 L7 HTTP DDoS 공격을 엣지 방패에서 흡수하며, 공격 트래픽으로 인한 추가 요금이 전혀 없습니다.
- 워드프레스 해킹 지옥 해방: PHP·MySQL 상시 서버와 플러그인 취약점이 아예 없으므로 관리자 무차별 대입 공격이 통하지 않습니다.
- 한 계정에서 100개 사이트 무료 운영: Pages는 계정당 최대 100개 프로젝트를 무료로 생성해 수십 개 브랜드 사이트를 거뜬히 돌립니다.
이 가이드에서 조립하는 Cloudflare · 보완 서비스 11종 전체 지도
필수 코어 4종, 데이터·스토리지 4종, 확장 서비스 3종의 계층과 역할을 먼저 구분하면 바인딩이 한눈에 보입니다
| 계층 | 서비스명 | 홈페이지에서 맡는 역할 | 핵심 운영 포인트 |
|---|---|---|---|
| 필수 코어 | 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 가속 | 초기엔 생략하고 트래픽·기능 확장 시 도입 |
01 새 기준 — 이전 스택(Next.js·Vercel·Supabase)과 무엇이 달라졌는가?
"공개 페이지를 먼저 정적으로 가볍게 올리고, 진짜 필요한 기능만 서버리스와 바인딩으로 하나씩 붙인다"
예전 가이드의 Next.js + Vercel + Supabase는 훌륭하지만, 소규모 비즈니스나 개인 프로젝트에서는 프론트·DB·도메인 계정이 3곳으로 나뉘어 관리와 과금 추적이 번거로웠습니다.
- 프론트 배포: Vercel ($20/월~)
- DB·스토리지: Supabase / S3
- 도메인·DNS: 별도 등록기관
- → 시크릿·권한·청구서가 3곳으로 분산
- 정적 배포: Astro + Pages ($0)
- API·DB·파일: Workers + D1 + R2 + KV
- 도메인·SSL·DDoS: Cloudflare 단일 존
- → 한 곳에서 네이티브 바인딩으로 즉시 연결
홈, 소개, 칼럼, 매장 안내 등 콘텐츠는 정적 HTML로 빌드해 무료 CDN에 먼저 올립니다.
문의 접수, 예약 신청, 알림 발송처럼 서버 검증이 필요한 지점에만 작은 함수를 붙입니다.
문의·예약 메타는 D1에, 급증하는 방문·클릭 로그는 Turso로 분리해 10GB 한계를 방어합니다.
고화질 이미지·PDF 원본은 R2(Egress $0)로 빼고, 공지 배너는 KV로 빠르게 읽습니다.
02 대상 정하기 & 13 첫 화면 템플릿 — 방문자의 '다음 행동'을 한 문장으로 정의하라
AI에게 "홈페이지 만들어줘"라고만 하면 예쁜 껍데기만 나옵니다. 4대 유형별 전환 목표를 먼저 못 박으세요
5초 안에 전문성 전달
"누구에게 어떤 문제를 해결해 주는 사람인지"가 첫 화면 헤드라인에 즉시 드러나야 합니다.
- 핵심 요소: 한 줄 가치 제안, 대표 글 목록, 연락처 허브
- 추천 구성: Astro 정적 빌드 + Pages 배포 (유지비 $0)
- 확장: 뉴스레터 구독 폼(Functions + D1)
대표 작업물과 성과 증명
화려한 효과보다 실제 작업물과 전후 성과 수치가 먼저 보이고 의뢰 폼으로 이어져야 합니다.
- 핵심 요소: 프로젝트 카드, 해결 과정, 즉시 의뢰 폼
- 추천 구성: 고화질 작업물은 R2, 문의는 D1
- 확장: 분야별 태그 필터(React Island)
모바일 즉시 예약·길찾기
방문자의 85% 이상이 모바일입니다. 첫 화면에서 전화, 길찾기, 영업시간, 예약을 바로 누르게 합니다.
- 핵심 요소: 전화·지도 버튼, 영업시간표, 메뉴·가격표
- 추천 구성: 휴무 배너는 KV, 예약 접수는 D1
- 확장: 매니저 예약 알림 웹훅 발송
단일 문제 10초 내 해결
견적 계산기, 참가 신청기, 진단 도구처럼 값을 입력하면 즉시 결과를 얻는 단일 기능에 집중합니다.
- 핵심 요소: 입력 폼, 실시간 계산 UI, 결과 공유
- 추천 구성: Astro + React Island + Workers API
- 확장: 관리자 전용 확인 라우트 분리
03 도메인 · DNS · SSL 초반 연결 안정화 — 기존 메일(MX/TXT) 레코드를 절대 지우지 마라
AI에게 DNS 화면을 직접 조작하게 하지 말고, 현재 레코드를 백업한 뒤 추가할 레코드 계획만 표로 받아 승인하세요
- 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 원가 등록을 활용합니다.
| 레코드 타입 | 이름(Name) | 조작 원칙 |
|---|---|---|
| CNAME | @ / www | Pages 커스텀 도메인 탭 안내에 따라 연결 추가 |
| MX / TXT | @ / _dmarc | 절대 삭제·수정 금지 (기존 메일 서버 유지) |
04 Wrangler CLI — AI가 명령을 제안하고 사람이 승인해 실행하는 작업 리모컨
Workers, Pages, D1, R2, KV를 터미널에서 다루는 핵심 도구입니다. 실행 전 항상 '무엇을 왜 만드는지' 설명을 먼저 받으세요
$ 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
- 1. 리소스 이름 규칙 초반 확정: 프로젝트명, D1 DB명, R2 버킷명은 나중에 바꾸기 까다로우므로
[브랜드]-[역할]-[환경]규칙을 처음부터 정합니다. - 2. 원격 리소스 생성 전 계획 확인: 원격 DB나 버킷 생성은 계정 한도와 직결되므로 AI가 자동 실행하지 못하게 합니다.
- 3. 로컬 통과 후 원격 실행: DB 스키마 변경(Migration)은 반드시
--local에서 먼저 성공한 뒤--remote에 적용합니다. - 4. 에러 전달 시 민감 정보 마스킹: 터미널 에러를 AI에게 줄 때 API 토큰, 계정 ID, 이메일 주소는 반드시 지우고 전달합니다.
05 AI 권한 위임 — "코드와 초안은 AI에게, 비밀값과 파괴적 명령은 사람이 통제한다"
AI 에이전트에게 전체 관리자 토큰을 주면 실수로 운영 DB 삭제나 의도치 않은 프로덕션 배포가 일어날 수 있습니다
| 구분 | 담당 주체 | 구체적인 작업 범위 |
|---|---|---|
| 설계 및 코딩 | AI 코딩 파트너 | 폴더 구조 계획, Astro/React 컴포넌트 작성, Functions API 코드, wrangler.toml 초안 |
| 진단 및 제안 | AI 코딩 파트너 | 실행할 CLI 명령어 제안, 빌드/런타임 에러 로그 원인 분석, SQL 스키마 초안 작성 |
| 인증 및 결제 | 사람 직접 통제 | 대시보드 로그인, 최소 권한 API 토큰 발급, 결제 수단 등록 및 예산 알림 설정 |
| 파괴적·운영 명령 | 사람 직접 통제 | 리소스 삭제(Delete), 캐시 전체 Purge, 운영 DB 원격 Migration, 최종 Production 배포 |
- 1. Global API Key 사용 절대 금지: 계정 전체를 좌우하는 Global Key 대신, 특정 프로젝트(Pages Edit, D1 Edit)만 허용된 Scoped API Token을 만듭니다.
- 2. 실제 값 대신 변수 이름만 공유: 채팅창에는 토큰 원문을 절대 넣지 말고
CLOUDFLARE_API_TOKEN,RESEND_API_KEY같은 변수 이름만 알려줍니다. - 3. 작업 종료 후 임시 토큰 회수(Revoke): 배포 테스트용으로 발급한 토큰은 작업이 끝나면 대시보드에서 즉시 폐기하거나 권한을 낮춥니다.
08 환경 변수와 바인딩 — local · preview · production 3단계 환경 맞추기
로컬에선 됐는데 배포 후 깨지는 이유의 90%는 바인딩 이름 불일치나 원격 Secret 누락 때문입니다
Git 저장소에는 실제 비밀번호가 없는 .env.example만 커밋합니다. 실제 비밀값은 로컬에선 .env.local(또는 .dev.vars)에 두고, 운영에선 Cloudflare Secrets에 등록합니다.
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)하고 재발급합니다.
06 Astro 콘텐츠 골격 & 07 Pages Functions vs 독립 Workers 위치 나누기
읽는 화면은 Astro 정적 HTML로 가볍게 만들고, 서버 코드는 성격에 따라 페이지 근처(Functions)와 독립 Worker로 나눕니다
회사 소개, 포트폴리오, 칼럼, 매장 안내처럼 읽는 콘텐츠가 중심인 사이트는 무거운 SPA보다 Astro가 압도적으로 빠릅니다.
- Zero-JS 기본 지향: 불필요한 자바스크립트를 덜어낸 순수 정적 HTML을 생성해 초기 로딩 속도와 SEO 점수를 극대화합니다.
- 부분 상호작용(Islands): 견적 계산기, 실시간 검색창, 예약 달력처럼 동작이 꼭 필요한 부분만 React 컴포넌트를 섬(Island)처럼 끼워 넣습니다.
- 공통 템플릿 내장: 헤더·풋터, OpenGraph, 사이트맵,
robots.txt를 초반에 공통 레이아웃으로 묶어 둡니다.
| 구현할 기능 | 추천 위치 | 선택 이유 및 운영 장점 |
|---|---|---|
| 문의·예약 폼 저장 | Pages Functions | 프론트 입력 폼과 API 라우트(/functions/api)가 한 저장소에 붙어 있어 관리가 직관적임 |
| R2 업로드 서명 발급 | Pages Functions / Worker | R2 쓰기 권한과 서명 비밀키를 브라우저에 숨기고 안전하게 업로드 URL만 내려줌 |
| 정기 크론(Cron) 집계 | 독립 Worker | 매일 자정 통계 집계, 정기 리포트 발송 등 Cron Triggers 스케줄 실행에 최적화 |
| 다수 사이트 공통 API | 독립 Worker | 여러 홈페이지에서 공통으로 호출하는 인증·결제 웹훅·알림 게이트웨이를 한 곳에서 관리 |
09 운영 데이터 저장 — 왜 핵심 DB는 D1에 두고 누적 로그는 Turso로 분리하는가?
D1은 단일 데이터베이스 최대 10GB(Paid 기준) 한계가 있으므로, 끝없이 쌓이는 방문·이벤트 로그는 Turso로 나누는 것이 정석입니다
모든 데이터를 D1 하나에 몰아넣으면 방문자 이벤트가 쌓일 때 단일 DB 10GB 용량 한계와 Rows Read 스캔 비용이 급증합니다.
- Cloudflare D1에 둘 데이터: 고객 문의 내역, 예약 신청, 게시글/칼럼 메타데이터, 상품 카탈로그, 관리자 설정 등 핵심 운영 데이터 (`env.DB` 네이티브 바인딩).
- Turso(libSQL)로 뺄 데이터: 페이지뷰 누적 로그, 버튼 클릭 이벤트, 일별/실시간 인기 순위 원천 데이터 (`TURSO_DATABASE_URL` + Secret 토큰 연결).
- 필수 스키마 습관: 모든 운영 테이블에는 처음부터
id,created_at,updated_at,status컬럼과 조회 조건 인덱스(Index)를 반드시 넣습니다.
10 파일 저장소 R2 & 11 빠른 설정·캐시 KV — 4대 저장소(D1·Turso·R2·KV) 총정리
DB에 이미지 바이너리를 직접 넣지 마세요! 파일 원본은 R2에 두고 DB에는 파일 경로(URL/Key)만 기록합니다
- R2 디렉터리 Prefix 설계: 버킷 안에
public/portfolio/2026/...,private/invoices/...처럼 공개 파일과 비공개 첨부파일 경로를 명확히 나눕니다. - 업로드 제한 검증: 허용 확장자(webp, pdf 등)와 최대 파일 크기를 Pages Functions에서 먼저 검사한 뒤 R2에 올립니다.
- KV는 '읽기 특화' 저장소: 공지 배너 문구, 임시 휴무 플래그, 인기글 캐시처럼 자주 읽고 가끔 바꾸는 값에 최적입니다.
- KV에 절대 넣으면 안 되는 것: KV는 결과적 일관성(Eventually Consistent) 구조이므로 실시간 재고 수량 차감이나 결제 원장을 KV에 두면 데이터가 어긋납니다.
| 저장소 | 성격 | 홈페이지 추천 데이터 | 핵심 주의사항 |
|---|---|---|---|
| D1 | 네이티브 핵심 SQL | 문의, 예약, 게시글 메타, 카탈로그, 설정 | 단일 DB 10GB 한계 및 rows 스캔 관리 (인덱스 필수) |
| Turso | 누적 로그·통계 DB | 방문 로그, 클릭 이벤트 누적, 인기 순위 집계 | 외부 HTTP/SDK 연결 → URL·토큰을 Secret에 보관 |
| R2 | 오브젝트 파일 저장소 | 고화질 이미지 원본, PDF 브로슈어, 백업 | Egress $0 무료! DB에는 파일 URL/키만 저장 |
| KV | 글로벌 엣지 읽기 캐시 | 공지 배너 문구, 기능 플래그, API 응답 캐시 | 쓰기 직후 전파 지연 가능 → 결제·재고 원본 금지 |
실전 3D 아키텍처 스튜디오 — 사이트 시나리오를 클릭해 3D 패킷 흐름과 바인딩을 확인하세요!
시나리오 버튼을 누르면 우측 3D 라우팅 그래프에서 요청 패킷이 해당 서비스 노드로 실시간 분기되며 wrangler.toml이 생성됩니다
Astro 정적 페이지 + Pages Functions + D1(문의) + R2(포트폴리오 이미지)
작업물 목록은 Astro 정적으로 빠르게 보여주고, 고해상도 이미지와 PDF는 R2(env.MEDIA)에 분리합니다. 고객 문의 폼 제출 시 Pages Functions가 D1(env.DB)에 안전하게 기록합니다.
12 바이브 코딩 프롬프트 루프 — 한 번에 통째로 시키지 말고 3단계로 끊어라
실패하는 바이브 코딩은 첫 프롬프트에서 제작부터 배포까지 한 방에 시킵니다. [계획 → 수정 → 검증]으로 쪼개세요
- 1단계 (Plan): 수정할 파일 목록, 바인딩 이름, DB 스키마만 표로 받고 사람이 검토합니다.
- 2단계 (Modify): 승인된 범위의 파일만 수정하게 하고, 새 패키지 설치 전에는 이유를 먼저 묻습니다.
- 3단계 (Summary & Verify): 변경된 파일 요약과 남은 위험 요소를 보고받은 뒤 로컬 검증으로 넘어갑니다.
14 로컬 검증 — dev · build · preview 3단 관문을 통과하기 전엔 배포하지 마라
개발 서버(dev)에서 잘 보여도 정적 빌드(build)나 Wrangler 바인딩 프리뷰(preview)에서 깨지는 경우가 많습니다
$ npm run dev
# [관문 2] 타입 오류나 깨진 import 없이 정적 산출물(dist)이 생성되는지 확인
$ npm run build
# [관문 3] D1·R2·KV 바인딩이 연결된 상태에서 Functions API 동작 검증
$ npx wrangler pages dev ./dist
터미널 오류 수백 줄을 통째로 붙여넣으면 AI가 문맥을 잃고 엉뚱한 파일을 건드립니다. 딱 아래 3가지 핵심 정보만 추려서 전달하세요.
- ① 처음 실패한 명령어:
npm run build에서 깨졌는지,wrangler pages dev런타임에서 깨졌는지 명시합니다. - ② 핵심 에러 메시지 첫 20줄: 가장 처음 등장한
Error: ...와 스택 트레이스 상단 20줄만 발췌합니다 (민감 정보 마스킹). - ③ 방금 수정한 파일 목록: 직전 단계에서 건드린 파일 2~3개가 무엇인지 함께 알려주면 원인을 10초 안에 찾습니다.
15 배포 흐름 — GitHub 자동 배포와 Wrangler CLI 직접 배포를 섞어 쓰지 마라
어느 날은 Git push로 올리고 어느 날은 터미널 CLI로 올리면 운영 버전이 꼬입니다. 한 프로젝트는 하나의 배포 루트로 통일하세요
| 구분 | 방식 A · GitHub 저장소 자동 배포 | 방식 B · Wrangler CLI 직접 배포 |
|---|---|---|
| 작동 방식 | PR/브랜치 푸시 시 Preview URL 자동 생성, main 병합 시 Production 배포 | 로컬에서 npm run build 완료 후 wrangler pages deploy ./dist 실행 |
| 가장 큰 장점 | 커밋 이력과 배포 버전이 1:1 연동되고 대시보드 롤백이 매우 쉬움 | 빠른 로컬 PC 빌드 자원을 활용하며 배포 시점을 사람이 직접 통제함 |
| 추천 대상 | 처음 운영하는 개인·스몰 비즈니스 사이트 (강력 추천) | 복잡한 모노레포이거나 커스텀 빌드 스크립트 통제가 필요한 개발자 |
- 1. Build와 Deploy 단계 분리: 코드 빌드 오류인지 Cloudflare 권한 오류인지 즉시 구분합니다.
- 2. 빌드 환경 명문화: 빌드 명령(
npm run build), 출력 폴더(dist), Node 버전(Node 20/22)을 대시보드와 문서에 똑같이 적어 둡니다. - 3. Preview 브랜치 선행 검증: 바로
main에 푸시하지 말고preview미리보기 URL로 모바일 화면과 폼 전송을 먼저 테스트합니다. - 4. 도메인 연결 직후 점검: 커스텀 도메인 연결 직후
canonical URL과sitemap.xml주소가 실제 도메인으로 바뀌었는지 확인합니다.
16 공개 품질 — 검색 노출(SEO)과 모바일 360px 가독성은 처음부터 템플릿에 내장하라
사이트를 다 만든 뒤에 메타태그와 모바일 화면을 고치려면 전체 페이지를 다 뜯어고쳐야 합니다
Astro의 공통 BaseLayout.astro 상단 <head>에 아래 요소들을 props로 받아 모든 페이지가 고유한 메타 정보를 갖도록 강제합니다.
- 1. 고유한 Title & Description: 모든 페이지가 똑같은 제목을 쓰지 않도록 페이지별 핵심 키워드와 요약문을 부여합니다.
- 2. 정확한 Canonical URL: 중복 문서 페널티를 막기 위해
<link rel="canonical">이 실제 공개 도메인을 가리키게 합니다. - 3. OpenGraph 공유 썸네일: 카카오톡·슬랙 공유 시 매력적인 대표 이미지(1200×630)와 제목이 뜨는지 점검합니다.
- 4. Sitemap & Robots.txt:
@astrojs/sitemap으로 자동 생성하고 구글 서치콘솔·네이버 서치어드바이저에 등록합니다.
- 모바일 360px 폭 강제 점검: 작은 스마트폰(360px 폭)에서 글자가 세로로 깨지거나 버튼이 겹치지 않도록 "모바일 360px 기준으로
word-break: keep-all과 가로 스크롤 여부를 점검해 줘"라고 지시하세요. - 시맨틱 태그 준수: 클릭 동작은
<div>가 아닌 실제<button>이나<a>태그로 작성합니다. - 의미 있는 Alt 텍스트: 정보성 이미지에는 명확한 대체 텍스트(
alt)를 넣습니다. - Lighthouse 90점 이상 확인: 배포 전 크롬 Lighthouse로 Performance, Accessibility, SEO를 1회 스캔합니다.
17 장기 운영 습관 (백업·문서화) & 18 자주 만나는 4대 장애 증상 진단표
AI가 짠 설정이라도 사람이 1분 만에 파악할 수 있게 표로 문서화하고, 장애 시 연결 지점부터 하나씩 좁혀 나갑니다
- 1. DB 마이그레이션 이력화: D1 스키마 변경 파일명에는
20261103_add_booking.sql처럼 날짜와 목적을 남깁니다. - 2. R2 보관 주기 및 백업 규칙: R2 버킷 폴더 구조와 원본 보관·백업 주기를 문서에 명시합니다.
- 3. 개인정보·토큰 로그 배제:
console.log에는 고객 전화번호나 인증 토큰 원문을 절대 남기지 않습니다. - 4. 월 1회 정기 점검 루틴: 매월 1일 무료 한도 사용량, 에러 로그, 문의 폼 정상 작동 여부를 테스트합니다.
| 발생 증상 | 가장 먼저 확인할 곳 | AI에게 전달할 핵심 진단 정보 |
|---|---|---|
| 배포 성공 후 404 | 빌드 출력 폴더(dist) 설정과 라우팅 | 빌드 명령어, 생성된 dist 폴더 트리, Pages 출력 디렉터리 설정값 |
| 폼 제출 시 DB 500 | wrangler 바인딩 이름과 원격 테이블 유무 | wrangler.toml 바인딩 블록, 코드의 env.DB 호출부, 원격 마이그레이션 여부 |
| R2 이미지 엑박 | R2 공개 도메인 연결 및 파일 키 경로 | 요청 이미지 URL, Network 탭 응답 코드(403/404), 버킷 공개 설정 |
| 도메인 안 열림 | DNS 레코드(CNAME/A) 및 SSL 발급 상태 | 현재 DNS 레코드 목록(민감정보 제외), Pages 커스텀 도메인 Active 여부 |
19 가격 감각 — Cloudflare($0~$5) · Vercel($20) · Supabase($25) 과금 비교
정적 파일 요청은 무료·무제한이지만 Pages Functions를 호출하는 순간 Workers 요청 한도에 합산된다는 점을 기억하세요
| 플랫폼 | 유료 시작점 및 핵심 과금 구조 | 가장 빛을 발하는 프로젝트 |
|---|---|---|
| Cloudflare | Free $0 / Workers Paid 월 $5 (정적 무료 · R2 Egress $0 · 무료 DDoS) | 콘텐츠 홈페이지 + 가벼운 API, 포트폴리오, 매장 사이트 다수 운영 |
| Vercel | Pro 월 $20 + 대역폭/함수 종량 과금 | 복잡한 Next.js SSR 제품 및 팀 단위 PR 협업 |
| Supabase | Pro 월 $25 + Postgres/Auth 통합 | 무거운 Postgres 조인·소셜 로그인·실시간 구독 앱 |
20 솔직한 단점 7가지 & 22 플랫폼 철학 (통합 제품 Vercel vs 조립 플랫폼 Cloudflare)
Cloudflare는 압도적으로 저렴하고 빠르지만, 부품이 잘게 나뉘어 있어 바인딩 계약과 환경 분리를 앞단에서 설계해야 합니다
- 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 개념을 알고 써야 합니다.
Cloudflare가 처음에 낯선 이유는 통합 프레임워크 제품이 뒤에서 숨겨 주는 인프라 결정권(비용·캐시·저장소 위치)을 개발자에게 직접 돌려주기 때문입니다.
연결은 쉽지만 트래픽 증가 시 인프라 제어권과 대역폭 비용 통제 폭이 좁음
초반 바인딩 표만 맞추면 전 세계 엣지에서 가장 저렴하고 안전하게 수십 개 사이트를 통제함
wrangler.toml과 바인딩 표 작성을 도와주므로 조립 허들이 사라졌습니다!21 딸깍 복사용 실전 프롬프트 3종 & 마스터 치트시트
비밀값이나 계정 ID는 절대 넣지 마세요! 대괄호 `[ ]` 안의 사이트 목적만 바꿔 복사한 뒤 AI 코딩 도구에 바로 붙여넣으세요
- 핵심 효과: AI가 바로 코드를 뒤엎거나 무단 배포하지 못하도록 1단계 설계 표부터 받아냅니다.
- 핵심 효과: 바인딩 이름(`env.DB`, `env.MEDIA`)을 고정해 배포 후 런타임 에러를 원천 차단합니다.
- 핵심 효과: 로컬 3단 관문과 모바일 360px·SEO 체크리스트를 거친 뒤 사람이 최종 배포합니다.
실무 이점 총정리 ① — 무료 시작점, 워드프레스 해방, 계정당 100개 사이트 확장
공식 문서로 확인된 무료 한도와 유료($5) 경계 수치만 정확하게 정리했습니다
- 정적 홈페이지($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
실무 이점 총정리 ② — 무료 D1 한도 · CDN 캐시 · 언미터드 DDoS · 원가 도메인 · R2
Free 플랜만으로도 DB, 글로벌 캐시, L3~L7 DDoS 보호, 무료 SSL, R2 10GB 스토리지를 즉시 사용할 수 있습니다
- 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
- 원가 도메인 등록·갱신: 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
실무 이점 총정리 ③ — PayPal 결제 · 예산 알림 · 30일 트래픽 분석 · 보안 메일
예산 알림은 메일로 경고를 보내지만 서비스를 자동 중단(Hard Cap)하지는 않으므로 정확한 동작 범위를 알고 써야 합니다
- 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
- 전 플랜 무료 이메일 알림: DDoS 공격 감지, SSL/TLS 인증서 발급·만료, Origin 오류율 상승, 봇 트래픽 급증 알림을 이메일로 무료 수신합니다.
- Security Insights: 보안 설정상의 잠재적 위험이나 조치 권장 사항을 스캔해 알려줍니다.
- ⚠️ 미확인 항목 투명 고지: "PHP 코드 등 특정 언어 취약점을 직접 스캔해 경고 메일을 보낸다"는 내용은 공식 문서에서 확인되지 않습니다(대신 Free WAF Managed Ruleset이 Log4j·워드프레스 등 알려진 웹 취약점 요청을 차단합니다).