Next.js 15 Standalone modu Docker ile nasıl kullanılır?

next.config.js dosyasında output: "standalone" tanımlandığında Next.js, yalnızca gerekli olan node_modules paketlerini ve sunucu dosyasını izole eder. Bu sayede Docker imaj boyutu 1 GB yerine yaklaşık 80-120 MB seviyesine iner.

Neden multi-stage (çok aşamalı) Dockerfile tercih edilmelidir?

Multi-stage derleme, derleme aşamasındaki ağır geliştirici paketlerini (TypeScript derleyicisi, derleme önbellekleri) prodüksiyon imajından ayırarak hem güvenlik açıklarını minimize eder hem de imajın saniyeler içinde ayağa kalkmasını sağlar.

Non-root kullanıcı neden önemlidir?

Konteynerlerin varsayılan olarak root yetkisiyle çalıştırılması, güvenlik ihlali durumunda ana sunucuya sızma riskini artırır. Non-root kullanıcı (örn: nextjs veya appuser) tanımlamak en temel DevSecOps gerekliliğidir.

DevSecOps & Konteyner Mimarisi

Dockerfile & Docker Compose Builder

Next.js 15+ Standalone, Node.js, Python FastAPI ve Go mikroservisleri için çok aşamalı (multi-stage), hafif, güvenli ve prodüksiyona hazır Dockerfile ve docker-compose konfigürasyonları üretin.

Proje & Konteyner Ayarları

Uygulama Mimarisi / Framework

Paket Yöneticisi

Konteyner Portu (EXPOSE)

Docker Compose Servis Eklentileri

PostgreSQL 16 (Altyapı & Veritabanı)

Redis 7 Cache (Oturum & Kuyruk)

Güvenlik & Optimizasyon

Non-Root Kullanıcı (Root İzolasyonu)

HEALTHCHECK Direktifi Ekle

Dockerfile

Multi-Stage Ready

# syntax=docker.io/docker/dockerfile:1
# Multi-Stage Production Dockerfile for Next.js 15+ App Router
FROM node:20-alpine AS base

# 1. Dependencies stage
FROM base AS deps
RUN apk add --no-cache libc6-compat
WORKDIR /app

COPY package.json pnpm-lock.yaml* ./
RUN corepack enable pnpm && pnpm i --frozen-lockfile

# 2. Builder stage
FROM base AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .

ENV NEXT_TELEMETRY_DISABLED=1
ENV NODE_ENV=production

RUN corepack enable pnpm && pnpm run build

# 3. Production runner stage
FROM base AS runner
WORKDIR /app

ENV NODE_ENV=production
ENV NEXT_TELEMETRY_DISABLED=1
ENV PORT=3000
ENV HOSTNAME="0.0.0.0"

RUN addgroup --system --gid 1001 nodejs
RUN adduser --system --uid 1001 nextjs

# Set correct permissions for Next.js standalone cache
RUN mkdir .next
RUN chown nextjs:nodejs .next

# Copy standalone build and static assets
COPY --from=builder --chown=nextjs:nodejs /app/public ./public
COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static

USER nextjs

EXPOSE 3000

HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
  CMD wget --no-verbose --tries=1 --spider http://localhost:3000/api/health || exit 1
CMD ["node", "server.js"]

Dockerfile & Docker Compose Mimarisi Hakkında

Modern mikroservis ve bulut mimarilerinde (Kubernetes, AWS ECS, Google Cloud Run, Vercel & Coolify) konteynerlerin hafif, güvenli ve hızlı derlenebilir olması kritik önem taşır. Dockerfile & Docker Compose Builder; Next.js 15+ Standalone modu, Python FastAPI, Node.js ve Go mimarileri için çok aşamalı (multi-stage) Dockerfile, docker-compose.yml ve .dockerignore konfigürasyonlarını en iyi endüstri standartlarında üretir.

Detayları Göster

Multi-Stage (Çok Aşamalı) Derleme ve Katman Önbellekleme

Çok aşamalı derleme sayesinde kaynak kodun derlendiği araçlar (Node build toolchain, Go derleyicisi, pip build dependencyleri) final imajına dahil edilmez. Bu yöntemle konteyner imaj boyutları 1 GB seviyesinden 60-120 MB seviyesine indirilir. Ayrıca non-root kullanıcı (root yetkisi olmayan kullanıcı) tanımları eklenerek container breakout ve yetki yükseltme saldırılarına karşı tam koruma sağlanır.

Diğer Geliştirici Araçlarıyla Birlikte Kullanım

Ürettiğiniz mikroservisler için Cursor veya Windsurf AI kurallarını oluşturmak amacıyla .cursorrules Generator aracımızı kullanabilir; API uçlarınızı test etmek için cURL to Modern Fetch aracından faydalanabilirsiniz. Veritabanı sorgularınızı ve pgvector indekslerinizi optimize etmek için ise AI SQL Optimizer eklentimize göz atabilirsiniz.

Blog · Konular · SSS