რა განახლების პარამეტრებს და빌드 გამოსახულებას მხარს უჭერს Next.js?

Question

Accepted Answer

Next.js მხარს უჭერს რამდენიმე განხორციელების სამიზნეებს, რომლებიც ნაწილობრივ კონტროლირებულია **`output`** კონფიგურაციით. სწორი არჩევანი დამოკიდებულია იმაზე, თუ გჭირდებათ Node სერვერი, კონტეინერები თუ სუფთა სტატიკური ჰოსტინგი.

## build output რეჟიმები

```js
// next.config.js
module.exports = {
  // output: undefined  → default: needs a Node.js server (full features)
  // output: "standalone" → self-contained folder for Docker/containers
  // output: "export"     → pure static HTML/CSS/JS (no server)
};
```

## 1. Default (Node სერვერი) — სრული ფუნქციები

ახორციელებს Node.js სერვერს, ამიტომ თქვენ მიიღებთ **ყველაფერს**: SSR, ISR, Server Actions, Route Handlers, გამოსახულების ოპტიმიზაცია, middleware. ეს არის რაც იყენებს ისეთი პლატფორმები, როგორიცაა **Vercel** (Next.js-ის შემქმნელი, zero-config) და Node hosts.

## 2. output: "standalone" — Docker / self-hosting-ისთვის

```dockerfile
# Next traces only the needed files into .next/standalone → a tiny, self-contained server
COPY --from=builder /app/.next/standalone ./
CMD ["node", "server.js"]
```

`standalone` აწარმოებს მინიმალური ფოლდერს მხოლოდ ფაქტობრივად გამოყენებული დამოკიდებულებებით, იდეალური მცირე Docker გამოსახულებებისთვის AWS-ზე, GCP-ზე, თქვენი სერვერებისთვის და სხვ. თქვენ ინარჩუნებთ ყველა სერვერის ფუნქციას.

## 3. output: "export" — სრულად სტატიკური

```text
next build → out/  (plain HTML/CSS/JS, deployable to any static host: S3, GitHub Pages, Netlify CDN)
```

სტატიკური ექსპორტი იძლევა ყველაზე იაფი, უმარტივესი ჰოსტინგი მაგრამ **გამორთავს სერვერის ფუნქციებს**: არ არის SSR, არ არის ISR, არ არის Route Handlers, არ არის Server Actions, არ არის ზე-ფრენის გამოსახულების ოპტიმიზაცია. შესაფერი მხოლოდ სრულად სტატიკური საიტებისთვის.

## არჩევა

```text
Need SSR/ISR/Server Actions, want zero-config → Vercel (or a Node host) — default output
Want containers / self-host with full features → output: "standalone" + Docker
Purely static content (docs, marketing)        → output: "export" → any static CDN
```

## სხვა მოსაზრებები

```text
- Runtime choice (Edge vs Node) affects where functions run
- Self-hosting ISR/caching needs persistent storage or a shared cache
- Image optimization on non-Vercel hosts may need a custom loader
```

## რატომ მნიშვნელოვანია

განხორციელება არ არის ერთი ზომა-ყველასთვის: `output` რეჟიმი განსაზღვრავს რომელი Next.js ფუნქციები რჩება.

ცოდნა, რომ **default/Node** გამოსახულება ინარჩუნებს ყველა სერვერის შესაძლებლობებს, **standalone** აკეთებს მათ Docker/self-hosting-ისთვის, და **export** ვაჭრობს ყველა სერვერის ფუნქციებით სუფთა სტატიკური ჰოსტინგისთვის საშუალებას გიჩვენებთ build-ის თქვენი ინფრასტრუქტურასთან შესაბამისობაში მოხდეს — და თავი აიფრიდოთ `output: "export"` ის ხაფიფი SSR/ISR/Server Actions გაწყვეტის ხაფიფი ხაფიფი.