1. 홈
  2. 개발자
  3. Dockerfile 생성기

Dockerfile 생성기

언어를 고르고 옵션을 선택하면 모범 사례를 반영한 Dockerfile이 나옵니다.

다른 형식·기능까지 한 번에 하려면 서버 설정 파일 생성기 →

내 브라우저에서 처리 · 업로드 없음
Dockerfile
FROM node:24-alpine AS deps WORKDIR /app ENV NODE_ENV=production COPY package.json package-lock.json ./ RUN npm ci --omit=dev && npm cache clean --force FROM node:24-alpine AS runtime WORKDIR /app ENV NODE_ENV=production COPY --from=deps --chown=node:node /app/node_modules ./node_modules COPY --chown=node:node . . USER node EXPOSE 3000 CMD ["node", "server.js"]
.dockerignore
.git .gitignore .env .env.* !.env.example Dockerfile .dockerignore docker-compose*.yml compose*.yaml *.md .vscode .idea .DS_Store node_modules npm-debug.log* coverage dist
빌드·실행 명령
# 이미지 빌드 docker build -t my-app . # 컨테이너 실행 docker run --rm -p 3000:3000 my-app
생성된 Dockerfile 은 운영에 반영하기 전에 검토하세요. 비밀번호·토큰은 이미지에 굽지 말고 실행할 때 환경 변수나 시크릿으로 넘기세요.

입력한 내용은 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.

사용 방법

  1. 언어·프레임워크를 고릅니다. Node.js, Next.js, Python, Go, Java, Rust, .NET, 정적 사이트(nginx) 프리셋이 있습니다.
  2. 기본 이미지 버전과 앱 포트를 정하고, 프리셋에 맞는 항목(패키지 매니저, 실행 명령, JAR 경로 등)을 채웁니다.
  3. 멀티스테이지 빌드, 비루트 사용자, HEALTHCHECK 체크박스로 모범 사례를 켜고 끕니다.
  4. 오른쪽 아래에 생성된 Dockerfile 과 .dockerignore 를 복사하거나 내려받습니다. 이미지 빌드·실행 명령도 함께 나옵니다.

옵션 설명

옵션 하는 일
멀티스테이지 빌드 빌드 도구와 소스를 최종 이미지에서 빼서 이미지를 줄이고 공격 면을 줄입니다. Next.js 와 정적 사이트는 항상 멀티스테이지입니다.
비루트 사용자 컨테이너 프로세스를 root 가 아닌 사용자로 실행합니다. Node 는 기본 node 사용자, 그 외는 UID 10001 의 app 사용자를 만듭니다. .NET 은 USER $APP_UID 입니다.
HEALTHCHECK 30초 간격으로 앱 포트와 경로를 호출해 컨테이너 상태를 표시합니다. 이미지에 있는 도구(wget, python)로만 호출하도록 맞춥니다.
.dockerignore .git, .env, node_modules 같은 파일이 빌드 컨텍스트와 이미지에 들어가지 않게 합니다. .env.example 은 예외로 둡니다.

프리셋별 구성

  • Node.js: node:<버전>-alpine. 빌드 단계를 켜면 의존성 설치, 빌드, 프로덕션 의존성만 설치한 실행 단계로 나뉩니다. npm ci, pnpm install --frozen-lockfile, yarn install --frozen-lockfile 처럼 락 파일을 고정해 설치합니다.
  • Next.js: output: "standalone" 결과(.next/standalone, .next/static, public)만 복사해 node server.js 로 실행합니다. next.config 에 해당 설정이 있어야 합니다.
  • Python: 첫 단계에서 가상환경(/opt/venv)에 패키지를 설치하고 실행 단계로 그 폴더만 복사합니다. Flask·Django 는 gunicorn, FastAPI 는 uvicorn 기본 명령을 넣어 주며, 해당 패키지가 requirements.txt 에 있어야 합니다.
  • Go: CGO_ENABLED=0 으로 정적 바이너리를 만들어 alpine 에 복사합니다. go.sum 이 없어도 빌드되도록 go.sum* 로 복사합니다.
  • Java: Maven 은 pom.xml 을 먼저 복사해 의존성 레이어를 캐시하고, 실행은 eclipse-temurin:<버전>-jre-alpine 입니다. Gradle 은 bootJar 를 실행하므로 JAR 경로를 직접 확인하세요.
  • Rust: rust:1-bookworm 으로 빌드하고 같은 Debian 세대의 debian:bookworm-slim 에서 실행합니다. 빌더와 런타임의 glibc 버전이 어긋나면 실행 시 오류가 나기 때문입니다.
  • 정적 사이트: 빌드 결과를 nginx 에 올립니다. 비루트를 켜면 nginxinc/nginx-unprivileged 이미지와 8080 포트, 끄면 nginx:stable-alpine 과 80 포트입니다.

예시: Node.js 멀티스테이지

빌드 단계 켬, 실행 명령 node dist/index.js 로 생성하면 의존성 설치(deps), 빌드(build), 실행(runtime) 세 단계가 나옵니다. 실행 단계는 npm ci --omit=dev 로 프로덕션 의존성만 설치하고 dist 폴더만 복사한 뒤 USER node 로 전환합니다.

주의할 점

  • 이미지 태그의 버전은 생성 시점의 선택지일 뿐입니다. 사용하는 언어 버전의 지원 기간과 Docker Hub 의 실제 태그를 확인하고 필요하면 고정된 다이제스트까지 지정하세요.
  • 생성된 Dockerfile 은 운영 반영 전에 직접 검토하세요. 앱마다 추가 시스템 패키지, 빌드 인자, 마이그레이션 단계가 필요할 수 있습니다.
  • 비밀번호·API 키·토큰을 ENV 나 ARG 로 이미지에 넣지 마세요. 이미지 이력에 남습니다. 실행할 때 환경 변수, 시크릿, 볼륨으로 전달하세요.
  • 서비스 여러 개를 함께 띄운다면 docker-compose 생성기로, 앞단 프록시는 Nginx 설정 생성기로 이어서 만들 수 있습니다. 환경 변수 파일 정리는 환경 변수 변환기, 호스트에서 서비스로 돌리려면 systemd 서비스 생성기, YAML 확인은 JSON YAML 변환기가 있습니다.

자주 묻는 질문

멀티스테이지 빌드는 왜 쓰나요?

컴파일러, 개발 의존성, 소스 코드는 빌드에만 필요합니다. 최종 이미지에는 실행 결과만 복사하면 이미지가 작아지고 불필요한 도구가 줄어 보안 면에서도 유리합니다.

비루트 사용자로 실행하면 무엇이 달라지나요?

컨테이너 안에서 앱이 탈취돼도 root 권한이 없어 피해 범위가 줄어듭니다. 쿠버네티스처럼 1024 미만 포트를 열 수 없는 환경도 있으니 앱 포트는 3000, 8080 처럼 높은 번호를 권장합니다.

알파인과 slim 이미지 중 무엇이 좋은가요?

이 도구는 Node, Go, Java 는 alpine, Python 은 slim(Debian)을 씁니다. Python 의 일부 패키지는 alpine(musl)에서 미리 빌드된 바이너리가 없어 설치가 느리거나 실패할 수 있기 때문입니다.

HEALTHCHECK 가 계속 unhealthy 로 나오면 어떻게 하나요?

앱이 지정한 경로에서 오류가 아닌 상태 코드로 응답하는지, 컨테이너 안에서 127.0.0.1 로 접속할 수 있도록 0.0.0.0 에 바인딩했는지 확인하세요. 실행 이미지에 wget 이나 curl 이 없으면 해당 도구를 설치해야 합니다.

입력한 내용이 서버로 전송되나요?

아니요. Dockerfile 은 브라우저 안에서만 만들어지며 어디로도 전송되지 않습니다.

입력한 내용은 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.

필요한 도구가 없나요?

어떤 작업을 하고 싶은지 적어 주세요. 요청이 많은 도구부터 만듭니다.