리액트 앱 배포하기

Vite와 Create React App 빌드를 그대로 공개합니다

Zip
File
Drag & drop zip or
single file here
Upload file
This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.
⭐️ 사용자 200만 명 이상
서버 설정 없이 배포 · GitHub 연동은 모든 요금제

이력서에 적을 앱 주소

부트캠프 팀 프로젝트나 포트폴리오용으로 만든 리액트 앱은 이력서와 README에 적을 주소가 있어야 합니다. Vite라면 dist, Create React App이라면 build 폴더 안의 파일을 ZIP으로 묶어 Tiiny Host에 올립니다. 서버나 배포 파이프라인을 따로 설정할 일은 없습니다.

이력서에 적을 앱 주소

로컬에서 배포까지

1. 경로 설정

1. 경로 설정

vite.config.js의 base를 './'로 바꿉니다. CRA는 package.json의 homepage를 '.'으로 둡니다.

2. npm run build

2. npm run build

빌드 명령으로 dist나 build 폴더를 만듭니다.

3. ZIP 업로드

3. ZIP 업로드

폴더 안의 파일을 ZIP으로 묶어 tiiny.host에 올리고 앱 주소를 정합니다.

기능

빌드부터 운영까지

📱 휴대폰 QR

Tiny 이상에서 받은 QR 코드로 휴대폰에서 바로 앱을 엽니다.

🔄 GitHub 푸시 배포

저장소를 연결한 뒤에는 기본 브랜치 푸시가 곧 배포입니다. 무료 요금제에서도 씁니다.

🧭 HashRouter 권장

새로고침해도 페이지가 열리도록 React Router는 HashRouter로 씁니다.

🌐 자체 도메인

Solo 요금제에서 회사나 개인 도메인을 앱에 연결합니다.

📊 스크립트 없는 통계

분석 코드를 넣지 않아도 방문 수와 유입 경로가 보입니다(Tiny 이상).

↩️ 빌드 되돌리기

문제가 있는 빌드를 올렸다면 Tiny 이상의 버전 기록에서 이전 판을 고릅니다.

비교

AWS S3로 배포할 때와의 차이

트래픽이 큰 서비스라면 AWS의 구성이 맞습니다. 발표나 포트폴리오용 앱을 공개하기에는 설정할 것이 많습니다.

⚡ Tiiny Host
AWS S3 + CloudFront
설정 단계
빌드 ZIP 업로드 한 번으로 공개합니다.
✓ 가능
버킷과 배포 설정
요금 방식
요금제마다 정해진 월 요금을 냅니다.
✓ 가능
사용량 과금
HTTPS
tiiny.site 주소에 SSL이 기본 적용됩니다.
✓ 가능
인증서 직접 연결
방문 통계
대시보드에서 방문 수를 봅니다(Tiny 이상).
✓ 가능
별도 설정
함께 비교한 방법 AWS S3 + CloudFront
요금제

내 도메인 연결은 Solo부터

무료 요금제로도 빌드를 공개할 수 있습니다. 배너를 없애고 방문 통계를 보려면 Tiny, 회사 도메인을 붙이려면 Solo를 고릅니다.

무료
$0/월, 기간 제한 없음
  • ✓ 사이트 1개 게시
  • ✓ HTML·ZIP 파일 최대 3MB
  • ✓ 월 방문 5,000회, 트래픽 5GB
  • ✓ SSL이 적용된 무료 주소 myname.tiiny.site
  • – 작은 Tiiny Host 배너 표시
더 필요할 때 업그레이드
$5부터/월, 연간 결제 시
약 6,800원부터 / 월
  • Tiny $5 약 6,800원 · 배너 제거, 최대 25MB, 방문 통계, 버전 기록
  • Solo $13 약 17,600원 · 자체 도메인, 최대 75MB, 프로젝트 5개, API
  • Pro $31 약 42,000원 · 프로젝트 15개, 팀원 추가
  • Pro Max $74 약 100,300원 · 프로젝트 무제한, 저장 공간 2TB
전체 요금제 보기 → ⭐️ 7일 이내 환불 보장

원화 금액은 2026년 9월 28일 환율(1달러 ≈ 1,356원)로 계산한 월 요금 어림값입니다. 실제 청구 금액은 결제 화면에서 확인하세요.

요금제별 저장 공간과 업로드 크기

업로드 용량 한도
무료
3MB
HTML, ZIP 등 모든 파일
Tiny · $5
25MB
프로젝트당
Solo · $13
75MB
프로젝트당
Pro · $31
10GB
계정 전체
Pro Max · $74
2TB
계정 전체

무료 요금제의 3MB 한도는 빌드 결과물 전체에 적용됩니다. 이미지나 폰트가 많은 앱이라면 Tiny(25MB)부터 살펴보세요.

AI 에이전트 지원

GitHub Actions에서 배포

GitHub Actions 같은 CI에서 빌드한 ZIP을 API로 보냅니다. API는 Solo 이상 요금제에서 씁니다.

REST API업로드 엔드포인트 하나로 자동화와 예약 게시를 구성합니다.
MCP 서버Claude Code는 명령어 한 줄로 연결됩니다. Cursor, VS Code, Windsurf, Zed, Codex, v0는 설정 몇 줄이면 됩니다.
Claude 커넥터Claude 앱과 Claude Code에서 보고서나 문서를 곧바로 게시합니다.
스킬한 번 설치한 에이전트는 PDF와 ZIP을 비롯해 100가지가 넘는 파일 형식을 링크로 게시합니다.
API 문서 보기 → API는 Solo 요금제부터 제공
upload.sh
curl -X POST https://ext.tiiny.host/v1/upload \
  -H "x-api-key: $TIINY_API_KEY" \
  -F "files=@dist.zip" \
  -F "domain=my-react-app.tiiny.site"

# → https://my-react-app.tiiny.site
# 파일 교체는 같은 도메인에 PUT 요청

공개하는 앱의 예

부트캠프 팀 프로젝트

부트캠프 팀 프로젝트

최종 발표 전에 팀원과 강사가 같은 주소로 앱을 확인합니다.

개발자 이력서

개발자 이력서

직접 만든 리액트 앱 주소를 이력서와 깃허브 README에 적습니다.

해커톤 데모

해커톤 데모

심사 직전에 빌드한 데모를 올려 심사위원 휴대폰으로 바로 보여 줍니다.

참고 자료

리액트 배포 더 알아보기

How To Deploy a React App - A Guide to Quick and Easy Deployment

리액트 앱을 빌드해 배포하기까지의 과정을 차례대로 설명합니다.

NextJS vs React: Key Differences and How to Choose

Next.js와 리액트의 차이, 프로젝트에 맞게 고르는 기준을 다룹니다.

자주 묻는 질문

리액트 앱을 무료로 배포할 수 있나요?

빌드 결과물이 3MB 이하라면 무료 요금제로 공개합니다. 무료 페이지에는 작은 Tiiny Host 배너가 표시됩니다.

Vite로 만든 앱은 어떻게 배포하나요?

vite.config.js에서 base를 './'로 두고 npm run build를 실행합니다. 그다음 dist 폴더 안의 파일을 ZIP으로 묶어 올립니다.

배포했더니 화면이 하얗게 나와요.

src가 든 프로젝트 폴더를 그대로 올렸을 가능성이 큽니다. 올려야 하는 것은 npm run build로 만든 dist나 build의 내용입니다. 스타일만 빠진다면 빌드할 때의 경로 설정(base나 homepage)을 확인하세요.

새로고침하면 404가 떠요.

Tiiny Host는 없는 경로에 404 페이지를 돌려줍니다. /about 같은 주소를 직접 열 때 서버에는 그 경로의 파일이 없으므로 404가 나옵니다. React Router에서는 HashRouter로 /#/about 형태의 주소를 씁니다. 이 방식에서는 모든 페이지가 index.html에서 열립니다.

GitHub 저장소에서 자동으로 배포되나요?

연결한 저장소의 기본 브랜치에 푸시할 때마다 사이트에 반영됩니다. 게시되는 것은 빌드된 파일이므로 dist 같은 출력 폴더도 커밋해 두세요. 모든 요금제에서 쓰고, 저장소는 75MB까지입니다.

Next.js로 만든 앱도 배포되나요?

정적 내보내기(static export)로 만든 Next.js라면 출력 폴더를 올려 공개합니다. API 라우트나 서버 사이드 렌더링처럼 서버에서 돌아가는 기능은 쓸 수 없습니다.

리액트 앱에도 비밀번호가 걸리나요?

걸 수 없습니다. 비밀번호 보호는 리액트 앱과 PHP 프로젝트를 지원하지 않습니다. PDF나 HTML 사이트에는 Solo 요금제부터 비밀번호를 겁니다.

API 키 같은 환경 변수는 어떻게 하나요?

VITE_로 시작하는 환경 변수는 빌드할 때 코드에 들어가, 브라우저에서 누구나 볼 수 있습니다. 비밀 키는 서버 쪽 코드에서만 다룹니다.

오늘 만든 앱을 오늘 공개