1-1. 구조 개념

Next.js 배포

• 정적 자산(HTML, JS, CSS, 이미지 등) → Cloudflare Pages(CDN)
• 서버 로직(API routes, 서버 컴포넌트 등) → Cloudflare Workers(에지 함수)
• 이 둘을 연결해주는 것이 OpenNext Cloudflare 어댑터

→ @opennextjs/cloudflare는 next build 결과물을 Cloudflare Workers 런타임에서 돌 수 있게 변환해 주는 어댑터

https://github.com/opennextjs/opennextjs-cloudflare?utm_source=chatgpt.com

즉 빌드 파이프라인은 이런 느낌:

1. next build (standalone 모드)
2. OpenNext가 빌드 산출물을 Workers용 번들 + Pages용 정적 파일로 재구성
3. Workers에 서버 코드/라우팅, Pages에 정적 에셋 배포

1-2. 왜 Cloudflare를 쓰는지

• Vercel/Amplify와 달리, Cloudflare는

  • 전 세계 100+개 국가 / 300+ 도시에 에지가 깔려 있음 → 사용자와 가까운 PoP에서 응답

  https://docs.mojoauth.com/enterprise-cloud/cloudflare-edge/?utm_source=chatgpt.com

  • Workers는 요청 올 때만 실행되는 서버리스라 콜드 스타트가 짧고 스케일 아웃이 자동

• 전 세계 갤러리/작가가 쓰는 서비스라면 글로벌 에지에서 도는 게 유리

• Cloudflare Workers
  • V8 기반 에지 런타임, Node.js 호환 레이어 제공
  • https://developers.cloudflare.com/workers/?utm_source=chatgpt.com
  • Bindings로 KV, R2, D1, Queues 등에 연결
• Cloudflare Pages
  • 정적 리소스를 전 세계 CDN에 배포
  • Next.js와 OpenNext 조합으로 SSR/ISR도 함께 처리 가능
  • https://developers.cloudflare.com/workers/framework-guides/web-apps/nextjs/?utm_source=chatgpt.com

1-3. 로컬 개발 플로우

npm run preview (또는 npx wrangler dev)를 통해 테스트