Next.js Docker tasviri chiqishi bilan: 'mustaqil': ko'p bosqichli qurish va ildizdan tashqari
Nima uchun mustaqil
Muntazam Next.js tasviri butun node_modules ni devDependencies, manbalar va qurish keshi bilan birga nusxalaydi. output: 'standalone' Next.js yordamida serverga haqiqatda qaysi fayllar kerakligini kuzatib boradi va ularni minimal server.js bilan birga .next/standalone ichiga joylashtiradi. Yakuniy rasmda faqat bu, statik va public tugaydi.
// next.config.ts
import type { NextConfig } from "next";
const nextConfig: NextConfig = {
output: "standalone",
};
export default nextConfig;Monorepozitariyada outputFileTracingRoot ni ombor ildiziga yo'l bilan qo'shing, aks holda iz qo'shni papkalardan paketlarni topa olmaydi.
Docker fayli
# syntax=docker/dockerfile:1
FROM node:22-bookworm-slim AS base
ENV NEXT_TELEMETRY_DISABLED=1
WORKDIR /app
# 1. Только зависимости — слой кэшируется, пока не меняется lock-файл
FROM base AS deps
COPY package.json package-lock.json ./
RUN --mount=type=cache,target=/root/.npm npm ci
# 2. Сборка
FROM base AS builder
COPY --from=deps /app/node_modules ./node_modules
COPY . .
ARG NEXT_PUBLIC_SITE_URL
ENV NEXT_PUBLIC_SITE_URL=$NEXT_PUBLIC_SITE_URL
RUN npm run build
# 3. Рантайм
FROM base AS runner
ENV NODE_ENV=production \
PORT=3000 \
HOSTNAME=0.0.0.0
COPY --from=builder --chown=node:node /app/public ./public
COPY --from=builder --chown=node:node /app/.next/standalone ./
COPY --from=builder --chown=node:node /app/.next/static ./.next/static
USER node
EXPOSE 3000
CMD ["node", "server.js"]Yechimlarni tahlil qilish:
- Uch bosqich. Kompilyatorlar, ishlab chiquvchi bog'liqliklar va manbalar oraliq bosqichlarda qoladi va yakuniy tasvirda tugamaydi.
- `--mount=type=cache` bir xil mashinadagi tuzilmalar orasidagi npm keshini saqlaydi. Bu BuildKit funktsiyasi, shuning uchun boshida
# syntaxqatori. - `HOSTNAME=0.0.0.0`.
server.jsushbu oʻzgaruvchidan manzilni tinglaydi. Busiz server konteyner nomiga ulanishi mumkin va uzatilgan port ulanishning uzilishi bilan javob beradi. - Statiklar alohida nusxalanadi.
.next/standalonetarkibida.next/staticvapublicmavjud emas - bu birinchi tuzilishdan keyin CSS va JS da 404 ning keng tarqalgan sababidir. - `USER node`. Rasmiy tugun rasmlari allaqachon imtiyozsiz foydalanuvchiga ega
node(uid 1000). O'zingizni yaratishingiz shart emas, lekin fayllar--chowndan ko'chirilishi kerak, aks holda jarayon ISR va tasvirni optimallashtirish uchun.next/cachega yozib bo'lmaydi.
Atrof-muhit o'zgaruvchilari: qurish va ishlash vaqti
NEXT_PUBLIC_* oʻzgaruvchilari next build vaqtida mijoz JavaScript-ga almashtiriladi. Ularni docker run bilan o‘tkazish juda kech – to‘plam allaqachon yig‘ilish qiymatini o‘z ichiga olgan yoki bo‘sh. Shuning uchun ular quruvchi bosqichida ARG orqali o'tadi.
Server sirlari (DATABASE_URL, API kalitlari), aksincha, tasvirga kiritilmasligi kerak. Ularni ARG sifatida o'tkazmang va .env dan nusxa ko'chirmang - ularni ishga tushirishda o'rnating:
docker run -d --env-file /etc/myapp/prod.env -p 127.0.0.1:3000:3000 myapp:1.4.0
.dockerignore ga ishonch hosil qiling, aks holda COPY . . montaj kontekstiga keraksiz narsalarni, jumladan, sirlarni tortadi:
node_modules .next .git .env* *.log coverage
PID 1 va konteynerni to'xtatish
PID 1 sifatida ishlaydigan tugun jarayoni signallar uchun standart yadro xatti-harakatlarini qabul qilmaydi. Agar ilovada SIGTERM ishlov beruvchisi boʻlmasa, docker stop kutish vaqtini kutadi (sukut boʻyicha 10 soniya) va jarayonni SIGKILL orqali oʻchirib, faol soʻrovlarni tugatadi. Oddiy yechim - bu boshlash jarayoni:
# compose.yml
services:
web:
image: myapp:1.4.0
init: true
env_file: /etc/myapp/prod.env
ports:
- "127.0.0.1:3000:3000"
healthcheck:
test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:3000/api/health').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"]
interval: 30s
timeout: 5s
retries: 3Yupqa tasvirda curl mavjud emas, shuning uchun sog'liqni tekshirish tugunning o'zida yozilgan: global fetch 18 va undan keyingi tugunlarda mavjud.
Tasvirlar va aniq
Next.js 15 da sharp avtomatik ravishda next start bilan va mustaqil rejimda ulanadi; uni qo'lda o'rnatishning hojati yo'q. Agar siz hali ham keskin yo'qligi haqida ogohlantirishni ko'rsangiz, qurish va ish vaqti bir platformada ekanligini tekshiring: glibc uchun tuzilgan ikkilik fayllar Alp (musl) da ishlamaydi va aksincha. Shuning uchun, misolda, barcha bosqichlar bitta asosiy tasvirdan iborat.
Natijani qanday tekshirish mumkin
docker build -t myapp:test --build-arg NEXT_PUBLIC_SITE_URL=https://example.com . docker image ls myapp:test # размер образа docker run --rm myapp:test id # uid=1000(node), не root docker run --rm myapp:test ls -la .next # владелец node
Qatlamlarda nima joy egallashini tahlil qilish uchun dive vositasi qulay. Agar yakuniy rasm kutilmagan darajada katta bo'lsa, u odatda butun node_modules ni o'z ichiga oladi: yuguruvchida COPY . . yo'qligini tekshiring.
Umumiy xatolar
Error: EACCES.next/cachega yozishda - fayllar--chownsiz nusxalangan.- Sayt ishlaydi, lekin uslublarsiz - ular
.next/staticnusxasini olishni unutishdi. NEXT_PUBLIC_*brauzerda bo'sh - montaj vaqtida emas, ish vaqtida uzatiladi.- Apple Silicon bilan Mac-da yarating, amd64 serverida ishga tushiring - sizga
docker buildx build --platform linux/amd64kerak, aks holda mahalliy modullar noto'g'ri arxitekturaga ega.
Mustaqillik kerak bo'lmaganda
Agar tarqatish Vercelga yoki o'z yig'ilishiga ega boshqa platformaga o'tsa, bu sozlama hech narsa bermaydi. Statik eksport uchun (output: 'export') server umuman kerak emas - statik bilan nginx yetarli.