배포 가이드 색인
저장소 루트의 DEPLOYMENT.md에 더 완전한 플랫폼 설명과 문제 해결 내용이 있습니다.
권장 흐름
- Vercel 배포(입문)
- 도메인 연결
- 트래픽이 커질 때: 정적 내보내기 · Netlify · Cloudflare Pages
전체 배포 문서
| 문서 | 시나리오 |
|---|---|
| deploy-vercel.md | Vercel 기본 SSR/ISR |
| vercel-domain.md | 커스텀 도메인 + Cloudflare |
| vercel-accelerate.md | 중국 내 접속 가속 |
| vercel-static.md | yarn export로 사용량 절감 |
| vercel-redeploy.md | 재배포 |
| netlify.md | Netlify（4.0.9+） |
| cloudflare-pages.md | Cloudflare 정적 배포 |
| edgeone-pages.md | Tencent Cloud EdgeOne(Node 버전, ENOSPC, Next SSG preset) |
| build-tuning.md | 빌드 타임아웃 / Notion 예열과 rate limit(환경 변수) |
| vps.md | VPS / Docker（Node 20+） |
빌드 타임아웃 문제 해결
Cloudflare, Netlify 같은 플랫폼에서 timeout of 300 seconds가 발생하거나 prefetch가 매우 느리다면 **빌드 성능 튜닝**을 참고하세요(BUILD_PREFETCH_ENABLED, STATIC_PAGE_GENERATION_TIMEOUT 등).
환경 요구사항(2026)
- Node.js 20(
.nvmrc참고) - Yarn：
yarn→yarn build/yarn export - 필수 설정:
NOTION_PAGE_ID
EdgeOne
Node 버전, 디스크 ENOSPC, 프레임워크 preset Next SSG 등은 **edgeone-pages.md**를 참고하세요. 빌드 중 .next/cache에 쓸 수 없으면 프로젝트는 시스템 임시 디렉터리로 fallback합니다. lib/cache/build_session.js를 참고하세요.