본문 바로가기
Q&A2025년 1월 12일1분 읽기

Docker로 Next.js 앱 배포하기

송
송민지
조회 932댓글 3

Docker로 Next.js 앱 배포하기 관련해서 문제가 발생했습니다.

프로젝트에서 적용 중인데 예상과 다르게 동작합니다. 공식 문서대로 설정했는데 특정 환경에서 에러가 나고 있어요.

비슷한 경험 있으신 분의 도움이 필요합니다.

댓글 3

김김영삼1년 전

Docker로 Next.js 앱 배포하기 관련해서 답변드립니다.

이 문제는 보통 환경 설정이나 버전 차이에서 발생합니다.

확인해보실 것:

  1. 사용 중인 버전과 공식 문서의 버전이 일치하는지 확인하세요
  2. 에러 로그를 자세히 확인하고, 핵심 에러 메시지로 GitHub Issues를 검색해보세요
  3. 최소 재현 코드를 만들어서 문제 범위를 좁혀보세요

구체적인 에러 메시지나 코드를 공유해주시면 더 정확한 답변이 가능합니다!

송송민지(guest)1년 전
standalone 모드에서 이미지 최적화(next/image)가 제대로 동작하나요?
김김영삼1년 전

standalone에서 sharp 패키지가 필요합니다:

# Dockerfile에 추가
RUN apk add --no-cache libc6-compat
RUN pnpm add sharp

# 또는 next.config.js에서 외부 이미지 로더 사용
images: { loader: "custom", loaderFile: "./image-loader.js" }

Alpine 이미지에서는 sharp 빌드에 libc6-compat이 필요합니다.

Ctrl+Enter로 등록