📚 Reference
📜 Chapter
| 비교 항목 | 기본 빌드 | standalone | 정적 내보내기 |
|---|---|---|---|
| 설정 | output 설정 생략 |
output: 'standalone' |
output: 'export' |
| 빌드 명령 | next build |
next build |
next build |
| 주요 결과물 | .next |
.next/standalone |
out |
| 실행 방식 | next start |
node server.js |
정적 웹 서버로 파일 제공 |
| 운영 환경 Node.js | 필요 | 필요 | 불필요 |
| 실행 의존성 | 별도로 설치하거나 준비 | 필요한 의존성을 결과물에 포함 | 서버용 의존성 불필요 |
| 요청 시 SSR | 지원 | 지원 | 미지원 |
| Next.js 서버 API | 지원 | 지원 | 요청을 처리하는 서버 API 미지원 |
| Server Actions | 지원 | 지원 | 미지원 |
| 다른 경로로 복사 | 의존성과 설정도 함께 준비 | 배포 폴더를 구성해 복사 | out 폴더 복사 |
| 적합한 상황 | 프로젝트 환경을 유지하며 운영 | 필요한 파일만 모아 독립 배포 | 서버 기능 없는 정적 사이트 |
pnpm exec next build
pnpm exec next start
.next를 생성하고, 설치된 Next.js가 이를 읽어 서버를 실행한다..next만 복사한다고 실행되는 구조는 아니다. 목적지에 필요한 node_modules, 설정, 정적 파일 등도 준비해야 한다. 모노레포라면 실행 시 참조하는 workspace 패키지도 해결되어 있어야 한다.