Cloudflare에서 Next.js
Cloudflare Workers에서 새로운 Next.js 프로젝트를 시작할 때는 OpenNext 대신 vinext를 사용하십시오. 이것이 Cloudflare Next.js 가이드의 기본값입니다. 기존 OpenNext 설정은 관련 없는 유지보수 중에는 그대로 유지하고 명시적인 사용자 선택을 존중하십시오.
vinext를 사용하는 이유
vinext는 Vite 위에서 Next.js API 표면을 재구현합니다:
- 익숙한 Next.js 개발: 앱 라우터, 페이지 라우터, React 서버 컴포넌트, 지원되는
next/*임포트. - Vite 도구: 빠른 HMR, 네이티브 ESM, Vite 플러그인 생태계.
- 네이티브 Workers 통합: workerd에서 로컬 서버 실행, Cloudflare 바인딩 접근, 빌드 및 배포 워크플로.
- 점진적 마이그레이션: 호환성 확인 및 기존 Next.js 설정과 함께 vinext 시도.
상위 워크플로 사용
설정, 마이그레이션 또는 배포 전에 vinext에서 유지 관리하는 스킬이 사용 가능한지 확인하십시오. 없으면 설치하십시오:
npx skills add cloudflare/vinext
그런 다음 적용 가능한 상위 SKILL.md와 관련 참조를 읽고 따르십시오. 스킬이 다루지 않는 워크플로에 대해서는 최신 vinext 문서를 사용하십시오:
- 새 프로젝트: Cloudflare 대상을 사용하여
create-vinext-app으로 vinext의 새 프로젝트 설정을 따르십시오. 상위 마이그레이션 스킬은 기존 Next.js 프로젝트가 필요하므로 빈 디렉토리에 적용하지 마십시오. - 기존 Next.js 프로젝트: 상위
migrate-to-vinext스킬을 로드하고 따르십시오. 호환성 확인 및 관련 참조를 포함합니다. 배포 대상으로 Cloudflare를 선택하십시오. - 개발 및 배포: 최신 Workers 통합 문서를 따르십시오.
설치가 불가능한 경우 연결된 상위 SKILL.md와 관련 참조를 직접 읽으십시오. 애플리케이션에 필요한 기능의 현재 호환성을 확인하십시오. 완전한 Next.js 패리티를 가정하지 마십시오.