📦
Hosting

Next.js standalone build: kam resurs bilan işlatiş va kiçik serverga joylaş

10.11.2026
← Barça maqolalar

Oddiy usulda joylangan Next.js loyihasi serverda butun node_modules papkasini talab qiladi. Bu papkada build uçun kerak bölgan, lekin işlaş vaqtida heç qaçon işlatilmaydigan yuzlab paketlar bor: TypeScript, linterlar, test kutubxonalari va boşqalar. Kiçik VPS'da bu disk joyini egallaydi, deploy vaqtini uzaytiradi va Docker image'larini oğirlaştiradi. Next.js'ning standalone rejimi aynan şu muammoni hal qiladi: build vaqtida u ilova haqiqatan işlatadigan fayllarni kuzatib, ularni alohida papkaga yiğadi.

Standalone rejim qanday işlaydi

Build paytida Next.js har bir sahifa va API route qaysi modullarni import qilişini tahlil qiladi. Standalone yoqilgan bölsa, natijada .next/standalone papkasi paydo böladi. Uning içida minimal server.js fayli va faqat zarur paketlardan iborat qisqartirilgan node_modules böladi. Bu papka next start buyruğiga muhtoj emas, u oddiy node server.js bilan işga tuşadi. Şu sababli serverga butun loyihani emas, faqat şu papkani köçiriş kifoya.

Standalone'ni yoqiş

Sozlaş bitta qatordan iborat. Loyihaning next.config.js yoki next.config.mjs fayliga output parametrini qöşing va build'ni qayta bajaring.

// next.config.mjs
const nextConfig = {
  output: "standalone",
};

export default nextConfig;
npm ci
npm run build
ls .next/standalone

Build tugagaç, .next/standalone papkasida server.js, package.json, node_modules va .next içki papkasini körasiz. Hajmni soliştiriş uçun du -sh node_modules .next/standalone buyruğini bajarib köring, farq loyihaga qarab har xil böladi, lekin odatda sezilarli.

Eng köp unutiladigan qadam: public va static

Standalone papkasiga ikki narsa avtomatik qöşilmaydi: public papkasi va .next/static içidagi CSS, JavaScript bölaklari. Next.js bu fayllarni ataylab taşlab ketadi, çunki ularni Nginx yoki CDN orqali töğridan-töğri beriş samaraliroq deb hisoblaydi. Agar ularni köçirmasangiz, sayt oçiladi, lekin dizaynsiz, rasmlarsiz va tugmalar işlamaydigan holda böladi. Köpçilik birinçi marta aynan şu yerda adaşadi.

cp -r public .next/standalone/
cp -r .next/static .next/standalone/.next/

Bu ikki buyruqni build skriptiga qöşib qöyiş yaxşi odat, şunda keyingi deploy'larda ular unutilmaydi. package.json da şunday yoziş mumkin.

"scripts": {
  "build": "next build",
  "postbuild": "cp -r public .next/standalone/ && cp -r .next/static .next/standalone/.next/"
}

Serverda işga tuşiriş

Standalone server port va manzilni muhit özgaruvçilari orqali oladi. PORT qaysi portda tinglaşni, HOSTNAME esa qaysi manzilda tinglaşni belgilaydi. Nginx orqasida işlatilganda 127.0.0.1 ni körsatiş xavfsizroq, Docker içida esa 0.0.0.0 kerak böladi.

cd /var/www/misol-next/.next/standalone
PORT=3000 HOSTNAME=127.0.0.1 NODE_ENV=production node server.js

Doimiy işlaşi uçun PM2 ecosystem fayli qulay. U ilovani fonda uşlaydi, yiqilsa qayta kötaradi va xotira çegarasidan oşsa qayta işga tuşiradi.

// ecosystem.config.js
module.exports = {
  apps: [{
    name: "misol-next",
    cwd: "/var/www/misol-next/.next/standalone",
    script: "server.js",
    max_memory_restart: "400M",
    env: { NODE_ENV: "production", PORT: 3000, HOSTNAME: "127.0.0.1" }
  }]
};

Build'ni serverdan taşqarida qiliş

Standalone rejimning eng katta afzalligi şundaki, build'ni kuçli kompyuterda yoki CI'da bajarib, serverga tayyor papkani yuboriş mumkin. Kiçik VPS build paytida xotira yetişmasligidan qiynalmaydi, server faqat tayyor ilovani işlatadi. Muhim şart bitta: build qilinadigan maşinaning operatsion tizimi va protsessor arxitekturasi server bilan mos bölişi kerak, çunki ba'zi paketlarda, masalan rasmlarni qayta işlovçi sharp'da, platformaga boğliq binar fayllar bor.

npm run build
tar -czf release.tar.gz -C .next/standalone .
scp release.tar.gz deploy@example.uz:/var/www/misol-next/releases/

Docker bilan işlatiş

Docker'da standalone ayniqsa foydali, çunki yakuniy image'da faqat işlaş uçun kerakli fayllar qoladi. Quyida köp bosqiçli Dockerfile'ning soddalaştirilgan varianti keltirilgan. Birinçi bosqiçda build bajariladi, ikkinçisida esa faqat natija köçiriladi.

FROM node:20-alpine AS build
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM node:20-alpine
WORKDIR /app
ENV NODE_ENV=production PORT=3000 HOSTNAME=0.0.0.0
COPY --from=build /app/.next/standalone ./
COPY --from=build /app/.next/static ./.next/static
COPY --from=build /app/public ./public
EXPOSE 3000
CMD ["node", "server.js"]

Amaliy misol: Namangandagi mebel dökoni

Namangandagi mebel dökoni katalog saytini Next.js'da işlatadi va uni 1 GB xotirali kiçik VPS'da uşlaydi. Avval build töğridan-töğri serverda bajarilardi va har safar xotira tugab, sayt bir neça daqiqa işlamay qolardi. Standalone rejimga ötgandan keyin build dasturçining kompyuterida bajariladi, serverga faqat tayyor arxiv yuboriladi va PM2 ilovani qayta yuklaydi. Serverda endi butun node_modules örniga faqat kerakli paketlar turadi, deploy esa bir daqiqadan kamroq vaqt oladi.

Tez-tez uçraydigan muammolar

Kam resursli serverda Next.js işlatmoqçi bölsangiz, sayt.uz kabinetidan kiçik VPS olib, standalone rejim bilan boşlaş yaxşi variant. Resurs yetmay qolsa, tarifni keyinçalik kattalaştiriş mumkin.

Öxşaş maqolalar

🛡️ OJS jurnal saytini botlardan himoyalaş: qidiruv, yuklama va loglar 🛠️ Texnik yordamga töğri murojaat: muammo tez hal bölişi uçun nima yoziş kerak 🧭 Vektor bazani öz serveringizda işlatiş: Qdrant va pgvector 🧭 Portainer: Docker konteynerlarini brauzer orqali boşqariş
🌐 Til
🇺🇿 O⁠'zbek 🇺🇿 Özbek (yangi) ✓ 🇺🇿 Ўзбек 🇷🇺 Русский 🇬🇧 English