배포 매뉴얼
GitHub + Vercel 초보자를 위한 단계별 배포 가이드

git push 한 번으로
내 서비스를 세상에

GitHub 저장소를 Vercel에 연결하면 서버를 직접 준비하지 않아도 코드를 올릴 때마다 자동으로 배포됩니다. 저장소 준비부터 첫 배포, 환경 변수, 커스텀 도메인까지 차례대로 따라 해 보세요.

10개 장
0 → 3장첫 배포 완료
2026.11최종 확인
How it works

배포는 이렇게 이루어집니다

한 번만 연결해 두면, 이후에는 평소처럼 코드를 push하는 것이 곧 배포입니다. 서버 설정도, 파일 업로드도 필요 없습니다.

01

코드 push

로컬에서 작업한 코드를 git push로 GitHub 저장소에 올립니다.

02

자동 빌드

Vercel이 변경을 감지해 코드를 내려받고 빌드합니다. 설정은 대부분 자동입니다.

03

서비스 공개

my-app.vercel.app 같은 주소로 누구나 접속할 수 있고, HTTPS도 자동입니다.

main 브랜치에 push → Production 실제 사용자가 보는 운영 사이트가 바로 갱신됩니다.
다른 브랜치 · PR → Preview 운영 사이트는 그대로 두고, 별도 주소에서 미리 확인합니다.
Before you start

시작하기 전에

아래 항목을 확인하면 바로 따라 할 수 있습니다. 설치 방법과 확인 명령어는 0장에서 자세히 안내합니다.

이런 분께 맞습니다

  • Git으로 commit·push는 해 봤지만 배포는 처음인 분
  • 만든 웹 프로젝트(HTML, React, Next.js 등)를 인터넷에 공개하고 싶은 분
  • push만 하면 자동으로 배포되는 환경을 만들고 싶은 분

준비물

  • GitHub 계정
  • Git 설치 — git --version으로 확인
  • Node.js LTS 프레임워크 사용 시
  • 배포할 프로젝트 — index.html 하나만 있어도 OK

Vercel 계정은 2장에서 GitHub 계정으로 가입합니다. 무료(Hobby) 요금제는 개인·비상업적 용도입니다.

Quick look

빠른 맛보기

1장에서 실행할 명령어입니다. 이 과정을 마친 뒤 Vercel에서 저장소를 Import하고 Deploy를 누르면 첫 배포가 끝납니다.

# 1. 로컬 프로젝트를 Git 저장소로 만들고 첫 커밋
$ git init
$ git add .
$ git commit -m "Initial commit"

# 2. GitHub 저장소와 연결하고 push
$ git branch -M main
$ git remote add origin https://github.com/<USER>/<REPO>.git
$ git push -u origin main