비공개 저장소 무료 배포 3곳 비교: Pages·Vercel·CF
비공개 저장소로 무료 배포하려면 무엇을 고르나
저장소를 공개하지 않고 무료로 배포하는 길은 세 가지입니다. 개인 GitHub Free 계정이라면 GitHub Pages는 공개 저장소에서만 쓸 수 있습니다(GitHub, 2026). 그래서 비공개 저장소는 Vercel Hobby나 Cloudflare Pages로 배포하는 편이 현실적입니다. 광고나 결제가 붙은 사이트라면 Vercel Hobby는 약관상 쓸 수 없으므로 Cloudflare Pages를 먼저 검토합니다.
소스 코드를 배포 서비스에 아예 넘기고 싶지 않을 때도 방법이 있습니다. Vercel은 GitHub Actions에서 vercel build로 빌드한 뒤 vercel deploy --prebuilt로 결과물만 올리는 절차를 공식 문서에 적어 두었습니다(Vercel, 2026). Cloudflare Pages는 Direct Upload로 빌드된 파일만 올릴 수 있습니다(Cloudflare, 2026).
어느 방법을 쓰든 브라우저에 전달되는 HTML·JS·CSS는 누구나 볼 수 있습니다. 저장소를 비공개로 두면 원본 코드와 커밋 이력은 가릴 수 있습니다. 하지만 번들에 들어간 API 키까지 숨겨 주지는 않습니다. 이 글의 비교표와 전송량 계산, 비밀값 체크리스트를 차례로 따라가면 자기 사이트에 맞는 서비스를 고를 수 있습니다.
저장소 비공개와 사이트 비공개는 다른 문제다
저장소 비공개는 GitHub에서 원본 코드를 볼 수 있는 사람을 제한하는 설정입니다. 사이트 비공개는 배포된 웹페이지를 열 수 있는 사람을 제한하는 설정입니다. 두 설정은 따로 움직입니다. 비공개 저장소에서 배포한 사이트도 기본적으로는 인터넷에 공개됩니다.
GitHub 요금제별로 GitHub Pages를 쓸 수 있는 범위가 다릅니다. GitHub Free(개인)는 공개 저장소에서만 Pages를 쓸 수 있습니다. GitHub Pro와 GitHub Team은 비공개 저장소에서도 Pages로 게시할 수 있습니다(GitHub, 2026). Pro 요금은 이 글에서 확인하지 않았으므로 GitHub 요금 페이지에서 직접 확인해야 합니다.
아래 표는 원하는 공개 범위별로 필요한 GitHub 요금제를 보여 줍니다.
| 원하는 상태 | GitHub Free(개인) | GitHub Pro(개인) | GitHub Team(조직) | Enterprise Cloud(조직) |
|---|---|---|---|---|
| 공개 저장소 → 공개 사이트 | 가능 | 가능 | 가능 | 가능 |
| 비공개 저장소 → 공개 사이트 | 불가 | 가능 | 가능 | 가능 |
| 비공개 저장소 → 접근 제한 사이트 | 불가 | 불가 | 불가 | 가능 |
사이트 자체를 비공개로 게시하려면 조직 계정이 필요하고, 그 조직이 GitHub Enterprise Cloud를 써야 합니다(GitHub, 2026). 비공개로 게시한 사이트는 게시 원본 저장소의 읽기 권한이 있는 사람만 열 수 있습니다. 주소도 공개 사이트와 달리 *.pages.github.io 아래의 별도 하위 도메인을 씁니다(GitHub Enterprise Cloud Docs, 2026).
Vercel Hobby에도 사이트 접근을 막는 기능이 있습니다. Hobby 플랜에는 미리보기 배포와 프로덕션 배포 모두에 적용되는 Vercel Authentication 배포 보호가 포함되어 있습니다. 비밀번호 보호(Password Protection)는 Pro 플랜에서 보호 프로젝트 하나당 월 20달러를 내야 쓸 수 있습니다(Vercel, 2026).
무료 플랜 한도는 서비스마다 기준이 다르다
세 서비스의 무료 한도는 재는 단위부터 다릅니다. GitHub Pages는 사이트 용량과 월 대역폭으로 제한합니다. Vercel Hobby는 월 전송량과 하루 배포 횟수로 제한합니다. Cloudflare Pages는 월 빌드 횟수와 파일 개수로 제한합니다.
아래 표는 세 서비스의 무료 플랜 한도를 공식 문서 수치로 나란히 놓은 것입니다.
| 항목 | GitHub Pages(Free·Pro) | Vercel Hobby | Cloudflare Pages 무료 |
|---|---|---|---|
| 비공개 저장소 연결 | Pro·Team 이상 | GitHub Free 계정 연동 지원 | Direct Upload는 저장소 연결 불필요 |
| 사이트 용량 | 1GB 이하 | 확인되지 않음 | 파일 20,000개, 파일당 25MiB |
| 월 전송량(GB) | 100(소프트 한도) | Fast Data Transfer 100 | 정적 자산 요청 무료·무제한 |
| 빌드·배포 횟수 | 시간당 10회(소프트 한도) | 하루 100회 | 월 500회, 동시 1개 |
| 빌드 제한 시간(분) | 10 | 확인되지 않음 | 20 |
| 커스텀 도메인 | 지원 | 프로젝트당 50개 | 프로젝트당 100개 |
| 프로젝트 수(개) | 확인되지 않음 | 200 | 계정당 100 |
| 서버 함수 | 없음 | 호출 월 100만 건, 최대 300초 | Functions+Workers 하루 100,000건 |
| 상업적 이용 | 온라인 사업·전자상거래·SaaS용 무료 호스팅 금지 | 비상업적 개인 용도만 | 이 글이 확인한 한도 문서에는 명시 없음 |
GitHub Pages의 시간당 10회 빌드 한도는 사용자 지정 GitHub Actions 워크플로로 빌드·게시하면 적용되지 않습니다. GitHub Pages 소스 저장소의 권장 한도도 1GB입니다(GitHub Pages limits, 2026).
Vercel Hobby는 한도를 넘으면 대부분 30일이 지나야 그 기능을 다시 쓸 수 있습니다(Vercel, 2026). 요금을 더 내서 바로 풀 수 있는 구조가 아니므로 트래픽이 몰리는 달에는 사이트가 멈출 수 있습니다. Hobby 빌드 환경은 vCPU 2개, 메모리 8GB, 디스크 32GB입니다.
Cloudflare Pages 무료 플랜의 월 500회 빌드는 31일로 나누면 하루 평균 약 16회입니다(500 ÷ 31 ≈ 16.1). 하루에 수십 번 푸시하는 개발 방식이라면 월말 전에 빌드 한도가 바닥날 수 있습니다. 신규 사용자는 가입 후 처음 48시간 동안 새 프로젝트 생성이 제한될 수 있습니다(Cloudflare, 2026).
상업적 이용 기준이 선택을 가장 먼저 가른다
Vercel이 말하는 상업적 이용은 프로젝트 제작에 관여한 누군가가 금전적 이익을 얻는 배포를 뜻합니다. Vercel 공정 사용 지침은 방문자에게 결제를 받는 경우, 상품·서비스 판매를 광고하는 경우, Google AdSense 같은 광고를 넣는 경우를 예로 듭니다. 사이트 제작·수정·호스팅 대가를 받는 경우와 제휴 링크가 사이트의 주목적인 경우도 여기에 들어갑니다(Vercel, 2026). 기부를 요청하는 것은 상업적 이용에 들어가지 않습니다.
GitHub Pages도 비슷한 제한을 둡니다. 온라인 사업, 전자상거래 사이트, 상업적 SaaS를 운영하는 무료 웹 호스팅으로 쓰면 안 됩니다. 비밀번호나 신용카드 번호를 주고받는 민감한 거래에도 쓰면 안 됩니다(GitHub Pages limits, 2026).
광고를 붙일 예정인 블로그나 포트폴리오라면 Vercel Hobby는 처음부터 제외합니다. 이 글이 확인한 Cloudflare Pages 한도·요금 문서에는 상업적 이용 제한 조항이 없었습니다. 그렇더라도 Cloudflare 이용 약관은 가입 전에 직접 확인해야 합니다.
월 전송량 계산: 100GB 한도를 넘는가
월 전송량은 방문자가 페이지를 열 때 내려받는 데이터의 월 합계입니다. GitHub Pages(소프트 한도)와 Vercel Hobby(Fast Data Transfer)는 둘 다 월 100GB를 기준으로 삼습니다. 아래 순서에 자기 사이트의 숫자를 넣어 보면 됩니다.
계산 순서
- 한 페이지의 전송량(MB)을 구합니다. 브라우저 개발자 도구의 Network 탭에서 캐시를 끄고 새로고침한 뒤 하단에 표시되는 전송 합계를 봅니다.
- 월 방문 수와 방문당 평균 페이지 수를 정합니다. 분석 도구가 없다면 예상값을 넣습니다.
- 월 전송량(GB) = 월 방문 수 × 방문당 페이지 수 × 페이지 전송량(MB) ÷ 1,000
- 결과를 100GB와 비교합니다. 이 계산은 브라우저 캐시를 무시한 최대값이므로 실제 사용량은 대개 이보다 작습니다.
계산 예시
아래 표는 방문당 3페이지, 페이지당 1.5MB로 가정하고 방문 수만 바꿔 월 전송량을 계산한 결과입니다.
| 월 방문 수(회) | 계산식 | 월 전송량(GB) | 100GB 한도 |
|---|---|---|---|
| 10,000 | 10,000 × 3 × 1.5 ÷ 1,000 | 45 | 여유 |
| 20,000 | 20,000 × 3 × 1.5 ÷ 1,000 | 90 | 근접 |
| 30,000 | 30,000 × 3 × 1.5 ÷ 1,000 | 135 | 초과 |
한계 방문 수는 거꾸로 계산하면 나옵니다. 100,000MB ÷ (3페이지 × 1.5MB) ≈ 22,222회이므로, 이 가정에서는 월 방문이 약 2만 2천 회를 넘으면 100GB에 닿습니다. 페이지 용량을 이미지 압축으로 0.5MB까지 줄이면 한계는 약 66,666회로 세 배가 됩니다(100,000 ÷ (3 × 0.5)).
계산 결과가 100GB에 가깝다면 Cloudflare Pages가 유리합니다. Cloudflare는 무료 플랜에서도 정적 자산 요청을 무료·무제한으로 처리합니다(Cloudflare, 2026). 다만 Pages Functions를 쓰는 요청은 Workers 요청과 합쳐 하루 100,000건까지이고, 이 한도는 UTC 자정(한국 시간 오전 9시)에 초기화됩니다.
소스를 넘기지 않고 배포하는 절차
Git 연동 배포는 배포 서비스가 저장소에서 코드를 직접 가져가 빌드하는 방식입니다. Vercel for GitHub 앱은 저장소의 Contents 권한을 읽기·쓰기로 요청합니다(Vercel, 2026). 비공개 저장소라도 Vercel이 원본 코드를 읽게 된다는 뜻입니다. 이것이 싫다면 빌드를 GitHub Actions에서 끝내고 결과물만 올리는 방식을 씁니다.
Vercel: GitHub Actions에서 빌드 후 prebuilt 배포
Vercel 공식 문서가 안내하는 순서는 세 단계입니다(Vercel, 2026).
- Actions 안에서 Vercel CLI를 설치하고 환경변수를 받아 옵니다. 미리보기용과 프로덕션용 명령이 다릅니다.
npm install --global vercel@latest
# 미리보기
vercel pull --yes --environment=preview --token=${{ secrets.VERCEL_TOKEN }}
# 프로덕션
vercel pull --yes --environment=production --token=${{ secrets.VERCEL_TOKEN }}
- Actions 안에서 빌드합니다. 이 단계에서는 소스 코드가 Vercel에 노출되지 않습니다.
vercel build # 미리보기
vercel build --prod # 프로덕션
- 빌드 결과물인
.vercel/output폴더만 Vercel에 올립니다.--prebuilt를 붙이면 Vercel 쪽 빌드 단계를 건너뜁니다.
vercel deploy --prebuilt # 미리보기
vercel deploy --prebuilt --prod # 프로덕션
워크플로는 두 개로 나눕니다. main이 아닌 브랜치 푸시는 미리보기 워크플로가, main 푸시는 프로덕션 워크플로가 처리하게 합니다. VERCEL_TOKEN은 GitHub 저장소의 Secrets에 저장합니다.
Vercel 프로젝트를 연결하는 권한에는 조건이 있습니다. 개인 계정 저장소는 저장소 Owner만 Vercel 프로젝트로 가져오거나 연결할 수 있고, Collaborator는 할 수 없습니다. 조직 저장소는 조직 Owner나 그 저장소에 접근 권한이 있는 조직 Member만 연결할 수 있습니다(Vercel, 2026).
Cloudflare Pages: Direct Upload
Direct Upload는 미리 빌드한 파일을 Cloudflare 전역 네트워크에 직접 올리는 배포 방식입니다(Cloudflare, 2026). 저장소를 Cloudflare에 연결하지 않으므로 원본 코드는 Cloudflare로 넘어가지 않습니다.
npx wrangler pages project create
npx wrangler pages deploy <빌드_결과_폴더>
# 미리보기 브랜치로 배포
npx wrangler pages deploy <빌드_결과_폴더> --branch=<브랜치명>
대시보드에 끌어다 놓는 방식은 한 번에 파일 1,000개, 파일당 25MiB까지만 올라갑니다. Direct Upload로 만든 프로젝트는 나중에 Git 연동으로 바꿀 수 없습니다. 자동 배포가 필요해지면 Git 연동 프로젝트를 새로 만들어야 합니다(Cloudflare, 2026).
GitHub Pages: 사용자 지정 Actions 워크플로
GitHub Pages는 코드가 이미 GitHub에 있으므로 소스 노출 문제가 없습니다. 비공개 저장소에서 쓰려면 Pro 이상이면 됩니다. 빌드를 사용자 지정 GitHub Actions 워크플로로 돌리면 시간당 10회 빌드 한도도 적용되지 않습니다. 배포가 10분을 넘기면 시간 초과로 실패합니다(GitHub Pages limits, 2026).
빌드 결과물은 공개된다: 비밀값 체크리스트
정적 사이트의 번들 파일은 방문자의 브라우저로 그대로 전달됩니다. 저장소를 비공개로 두어도, 소스를 Vercel이나 Cloudflare에 넘기지 않아도 이 사실은 변하지 않습니다. 배포 전에 아래 항목을 하나씩 확인합니다.
- [ ] 결제·DB·AI API 비밀 키가 프론트엔드 코드에 문자열로 들어 있지 않다
- [ ] 브라우저에 노출하는 접두사가 붙은 환경변수(프레임워크마다 다름)에 비밀 키를 넣지 않았다
- [ ] 비밀 키가 필요한 호출은 Vercel Functions나 Cloudflare Pages Functions 같은 서버 함수로 옮겼다
- [ ] 비밀 키는 배포 서비스의 환경변수나 GitHub Secrets에만 저장했다
- [ ] 빌드 결과 폴더에서 키 문자열 일부를 검색해 걸리는 파일이 없다
- [ ] 소스맵(
.map) 파일을 배포할지 정했다. 소스맵이 있으면 원본 코드 구조를 복원할 수 있다 - [ ] GitHub Pages라면 비밀번호·카드번호를 받는 폼을 두지 않았다
- [ ] 과거 커밋에 키가 올라간 적이 있다면 키를 폐기하고 새로 발급했다
서버 함수에도 무료 한도가 있습니다. Vercel Hobby는 함수 호출 월 100만 건과 Active CPU 월 4 CPU-시간까지입니다(Vercel, 2026). Cloudflare 무료 플랜은 Functions와 Workers 요청을 합쳐 하루 100,000건까지입니다(Cloudflare, 2026). 비밀 키를 서버로 옮기면 이 한도를 함께 계산해야 합니다.
상황별 선택 판정표
아래 표는 흔한 상황 여섯 가지에 맞는 서비스를 정리한 것입니다. 앞의 비교표와 전송량 계산 결과를 바탕으로 판정했습니다.
| 내 상황 | 추천 | 판정 근거 |
|---|---|---|
| GitHub Free 개인 계정, 비공개 저장소, 광고 없는 개인 사이트 | Vercel Hobby 또는 Cloudflare Pages | GitHub Pages는 Free에서 공개 저장소만 가능 |
| 광고(AdSense)·제휴 수익이 있는 블로그 | Cloudflare Pages | Vercel Hobby는 광고를 상업적 이용으로 봄 |
| 월 전송량 계산이 100GB를 넘음 | Cloudflare Pages | 정적 자산 요청 무료·무제한 |
| 소스를 외부 서비스에 넘기기 싫음 | Vercel prebuilt 또는 Cloudflare Direct Upload | 빌드 결과물만 업로드 |
| 사내 문서처럼 사이트 접근 자체를 막아야 함 | GitHub Enterprise Cloud 비공개 게시 | 저장소 읽기 권한자만 열람 |
| 이미 GitHub Pro 사용, 정적 문서 사이트 | GitHub Pages | 비공개 저장소 게시 가능, 추가 서비스 불필요 |
AI 코딩 도구로 만든 사이트를 배포한 경험은 커뮤니티 vibe 탭에서 나눌 수 있습니다. 다른 개발 도구 가이드는 AI·개발 도구 가이드 목록에 모여 있습니다.
자주 묻는 질문
비공개 저장소로 GitHub Pages를 무료로 쓸 수 있나요?
GitHub Free 개인 계정으로는 쓸 수 없습니다. GitHub Free는 공개 저장소에서만 Pages를 지원하고, 비공개 저장소에서 게시하려면 GitHub Pro나 GitHub Team이 필요합니다(GitHub, 2026). 무료로 비공개 저장소를 배포하려면 Vercel Hobby나 Cloudflare Pages를 씁니다.
저장소를 비공개로 하면 사이트 코드도 안 보이나요?
아닙니다. 원본 코드와 커밋 이력은 가려지지만, 브라우저로 전달되는 HTML·JS·CSS는 누구나 볼 수 있습니다. 숨겨야 하는 API 키는 서버 함수와 환경변수로 옮겨야 합니다.
Vercel Hobby 사이트에 광고를 달아도 되나요?
안 됩니다. Vercel 공정 사용 지침은 Hobby를 비상업적 개인 용도로만 허용합니다. Google AdSense 같은 광고를 넣는 것도 상업적 이용의 예로 명시되어 있습니다(Vercel, 2026). 광고를 달려면 Pro(Developer 좌석 사용자당 월 20달러, 세금 별도)나 Enterprise 플랜이 필요합니다.
Vercel Hobby 한도를 넘으면 어떻게 되나요?
대부분의 기능은 30일이 지나야 다시 쓸 수 있습니다(Vercel, 2026). Hobby는 무료 플랜이라 청구 주기가 없고, 요금을 더 내서 한도를 늘리는 방식도 없습니다. 월 전송량 계산 결과가 100GB에 가깝다면 미리 다른 서비스를 검토합니다.
Cloudflare Pages Direct Upload 프로젝트를 나중에 Git 자동 배포로 바꿀 수 있나요?
바꿀 수 없습니다. Direct Upload로 만든 프로젝트는 Git 연동으로 전환되지 않으므로, 자동 배포가 필요하면 Git 연동 프로젝트를 새로 만들어야 합니다(Cloudflare, 2026). 처음부터 GitHub Actions에서 wrangler pages deploy를 실행하도록 구성해 두면 자동 배포 효과를 얻을 수 있습니다.
출처
- GitHub, GitHub's plans (2026): https://docs.github.com/en/get-started/learning-about-github/githubs-plans
- GitHub, GitHub Pages limits (2026): https://docs.github.com/en/pages/getting-started-with-github-pages/github-pages-limits
- GitHub, What is GitHub Pages? (2026): https://docs.github.com/en/pages/getting-started-with-github-pages/what-is-github-pages
- GitHub, Changing the visibility of your GitHub Pages site — Enterprise Cloud (2026): https://docs.github.com/en/enterprise-cloud@latest/pages/getting-started-with-github-pages/changing-the-visibility-of-your-github-pages-site
- Vercel, Vercel Hobby Plan (2026): https://vercel.com/docs/plans/hobby
- Vercel, Fair Use Guidelines (2026): https://vercel.com/docs/limits/fair-use-guidelines
- Vercel, Deploying GitHub Projects with Vercel (2026): https://vercel.com/docs/git/vercel-for-github
- Cloudflare, Pages Limits (2026): https://developers.cloudflare.com/pages/platform/limits/
- Cloudflare, Pages Functions Pricing (2026): https://developers.cloudflare.com/pages/functions/pricing/
- Cloudflare, Direct Upload (2026): https://developers.cloudflare.com/pages/get-started/direct-upload/