Vercel에 블로그 배포하기 — 10분 만에 내 사이트 만들기
- 1왜 티스토리 대신 직접 블로그를 만들었을까?
- 2Next.js가 뭔데? 왕초보가 이해한 방식으로 설명
- 3Supabase로 데이터베이스 연결하기 — 무료로 백엔드 만들기
- 4Vercel에 블로그 배포하기 — 10분 만에 내 사이트 만들기
- 5다국어 블로그 만들기 — 한국어/영어 동시 지원하는 법
배포란 뭘까?
지금까지 우리가 만든 블로그는 내 컴퓨터에서만 볼 수 있었습니다. 배포(Deploy)란 이 블로그를 인터넷에 올려서 전 세계 누구나 접속할 수 있게 하는 것을 말합니다.
쉽게 말하면, 내 컴퓨터에 있는 요리를 식당에 내놓는 것과 같습니다.
Vercel을 선택한 이유
배포 플랫폼은 여러 가지가 있지만, Next.js 프로젝트라면 Vercel이 최선의 선택입니다.
- Next.js를 만든 회사가 운영하는 플랫폼입니다. 궁합이 완벽합니다.
- 개인 프로젝트는 완전 무료입니다.
- GitHub에 코드를 올리면 자동으로 배포됩니다.
- 글로벌 CDN으로 전 세계 어디서나 빠르게 접속됩니다.
- HTTPS(SSL)가 자동으로 적용됩니다.
배포 과정 (진짜 10분이면 됩니다)
Step 1: GitHub에 코드 올리기
먼저 프로젝트 코드를 GitHub 저장소에 올려야 합니다. GitHub 계정이 없다면 먼저 가입하세요. VS Code의 터미널에서 git 명령어로 코드를 올리거나, GitHub Desktop 앱을 사용하면 됩니다.
Step 2: Vercel 가입 및 GitHub 연동
vercel.com에 접속해서 GitHub 계정으로 로그인합니다. 그러면 자동으로 GitHub 저장소 목록이 나타납니다.
Step 3: 프로젝트 가져오기
블로그 저장소를 선택하고 "Import" 버튼을 클릭합니다. 환경 변수(Supabase URL, API Key 등)를 입력하는 화면이 나오면, .env.local 파일의 내용을 하나씩 추가합니다.
Step 4: 배포!
"Deploy" 버튼을 클릭하면 Vercel이 자동으로 빌드하고 배포합니다. 약 1~2분 후에 프로젝트명.vercel.app 주소로 내 블로그에 접속할 수 있습니다.
커스텀 도메인 연결하기
vercel.app 도메인도 좋지만, 자체 도메인을 쓰면 더 전문적으로 보입니다. 도메인 구매 사이트(가비아, Namecheap 등)에서 도메인을 구매한 후, Vercel 프로젝트 설정에서 도메인을 추가하면 됩니다.
DNS 설정에서 Vercel이 안내하는 CNAME 또는 A 레코드를 추가하면 보통 5~30분 내에 연결됩니다.
자동 배포의 마법
Vercel의 가장 좋은 점 중 하나는 자동 배포입니다. GitHub에 코드를 push하면 Vercel이 자동으로 감지하고 새 버전을 배포합니다. 별도의 작업이 필요 없습니다.
심지어 브랜치별로 미리보기 배포(Preview Deployment)도 자동으로 만들어줍니다. 새 기능을 테스트할 때 매우 유용합니다.
마치며
배포까지 완료하면 진짜 내 블로그가 인터넷에 살아 있는 것을 확인하는 순간이 옵니다. 그 순간의 기쁨은 직접 경험해보지 않으면 모릅니다. 내가 만든 것이 전 세계에 공개되는 경험, 정말 특별합니다.
다음 글에서는 블로그에 다국어 지원(한국어/영어)을 추가하는 방법을 공유할게요!
로컬 개발 환경(`localhost:3000`) vs 프로덕션 배포 환경 비교
내 컴퓨터에서 npm run dev로 띄운 웹사이트는 나 혼자만 볼 수 있는 테스트 서버입니다. 이를 전 세계 누구나 도메인 주소로 24시간 접속할 수 있게 하려면 클라우드 호스팅 플랫폼에 프로덕션 빌드(Production Build)를 배포해야 합니다. Next.js 제작사인 Vercel과 글로벌 엣지 네트워크인 Cloudflare Pages/Workers의 특징을 비교해 보겠습니다.
| 비교 항목 | 로컬 개발 서버 (`next dev`) | Vercel (Hobby 무료 플랜) | Cloudflare Workers / Pages |
|---|---|---|---|
| 코드 최적화 여부 | 최적화 안 됨 (디버깅 및 실시간 수정 중심) | 코드 압축(Minification), 이미지 자동 WebP 변환, 정적 캐싱 | 글로벌 300개 이상 엣지 로케이션에서 초저지연 응답 |
| 무료 트래픽 한도 | 본인 PC 내부에서만 접속 가능 | 월 100GB 대역폭 제공 | 정적 에셋 대역폭 무제한 무료 (일 10만 건 Worker 요청 무료) |
| 환경변수 관리 | 프로젝트 폴더 내 `.env.local` 파일 참조 | Vercel 대시보드 → Settings → Environment Variables에 등록 | Cloudflare 대시보드 또는 GitHub Actions Secrets 연동 |
| SSL 보안 인증서(HTTPS) | 기본 `http://` (비보안) | 도메인 연결 즉시 Let's Encrypt 무료 HTTPS 자동 발급·갱신 | Cloudflare Universal Edge SSL 자동 적용 및 DDoS 방어 |
배포 시 가장 많이 실패하는 '환경변수(Environment Variables)'와 빌드 검증 명령어
로컬에서는 잘 돌아가던 프로젝트가 Vercel에서 Build Failed가 뜨는 원인의 90%는 **① 타입스크립트 문법/타입 에러**이거나 **② `.gitignore`로 인해 GitHub에 올라가지 않은 `.env.local`의 환경변수를 Vercel 대시보드에 등록하지 않았기 때문**입니다. GitHub에 푸시하기 전에 반드시 내 컴퓨터 터미널에서 아래 명령어로 프로덕션 빌드가 통과하는지 먼저 확인하세요.
# 1. TypeScript 타입 오류가 없는지 사전 검사
npx tsc --noEmit
# 2. 실제 Vercel 서버가 실행하는 것과 동일한 프로덕션 빌드 테스트
npm run build
# 3. 빌드가 성공하면 로컬에서 프로덕션 모드로 실행하여 최종 확인
npm run start
커스텀 도메인(예: `bangjang.net`) 연결 시 DNS 레코드 설정 요약
- 루트 도메인(`@`, 예: `bangjang.net`) 연결: 도메인 등록 업체(가비아, 호스팅케이알, Cloudflare DNS 등)의 DNS 관리 화면에서 타입
A레코드를 추가하고, 호스트 이름에@, 값(IP 주소)에 호스팅사가 안내하는 서버 IP(Vercel의 경우76.76.21.21)를 입력합니다. - 서브도메인(`www`) 연결: 타입
CNAME레코드를 추가하고, 호스트 이름에www, 목적지 값에cname.vercel-dns.com을 입력하면 `www.bangjang.net`으로 접속해도 메인 도메인으로 깔끔하게 자동 리다이렉트됩니다.



댓글 (0)
첫 번째 댓글을 작성해보세요!