ทำไมต้องใช้โหมด Standalone เมื่อรัน Next.js บน Docker?
เวลาเรานำเว็บแอปพลิเคชันที่พัฒนาด้วย Next.js ไปรันบน VPS หรือเซิร์ฟเวอร์ Linux ของตัวเอง ปัญหาที่พบบ่อยคือขนาดของ Docker Image ที่ใหญ่มาก (บางครั้งเกิน 1 GB) หากเราคัดลอกโฟลเดอร์ node_modules ทั้งหมดเข้าไปใน Container โดยตรง
ปฏิภาณ พลยิ่ง (Patipan Plonying) แนะนำให้เปิดใช้งานตัวเลือก output: 'standalone' ในไฟล์ next.config.ts ซึ่งจะให้ Next.js วิเคราะห์และคัดแยกเฉพาะไฟล์ที่จำเป็นต่อการรันบน Production ออกมาไว้ในโฟลเดอร์ .next/standalone ทำให้ขนาด Image ลดลงเหลือเพียงไม่กี่ร้อยเมกะไบต์และสตาร์ทระบบได้เร็วขึ้นมาก
import type { NextConfig } from "next";
const nextConfig: NextConfig = {
output: "standalone",
poweredByHeader: false,
};
export default nextConfig;ตัวอย่าง Multi-stage Dockerfile ที่ใช้งานจริง
การแบ่ง Dockerfile ออกเป็น 3 ขั้นตอน ได้แก่ deps (ติดตั้งแพ็กเกจ), builder (สั่ง build โปรเจกต์) และ runner (อิมเมจสำหรับรันจริง) ช่วยให้สามารถใช้ Docker Layer Cache ได้อย่างคุ้มค่า และปลอดภัยขึ้นด้วยการรันผ่านผู้ใช้ที่ไม่ใช่ root (non-root user)
FROM node:20-alpine AS base
FROM base AS deps
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci
FROM base AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
RUN npm run build
FROM base AS runner
WORKDIR /app
ENV NODE_ENV=production
ENV PORT=3000
ENV HOSTNAME="0.0.0.0"
RUN addgroup --system --gid 1001 nodejs && \
adduser --system --uid 1001 nextjs
COPY --from=builder /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
CMD ["node", "server.js"]การตั้งค่า Nginx เป็น Reverse Proxy และจัดการโดเมน
เมื่อ Container ของ Next.js รันอยู่ที่พอร์ต 3000 ภายในเครื่อง เราจะใช้ Nginx รับทราฟฟิกจากพอร์ต 80/443 ด้านหน้า เพื่อทำหน้าที่จัดการ SSL/TLS (HTTPS), บังคับ Redirect จากโดเมนไม่มี www ไปยัง www อย่างถาวร (301 Redirect) และส่งต่อคำขอไปยังพอร์ต 3000
server {
listen 80;
server_name pl-patipan.in.th;
return 301 https://www.pl-patipan.in.th$request_uri;
}
server {
listen 443 ssl http2;
server_name www.pl-patipan.in.th;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}