Kokias diegimo parinktis ir build išvestys palaiko Next.js?

Question

Accepted Answer

Next.js palaiko kelis diegimo tikslus, kuriuos iš dalies kontroliuoja **`output`** konfigūracija. Tinkama pasirinkti priklauso nuo to, ar jums reikia Node serverio, konteinerių ar grynai statinio hostingo.

## Build išvesties režimai

```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. Numatytasis (Node serveris) — visos funkcijos

Vykdo Node.js serverį, todėl gauni **viską**: SSR, ISR, Server Actions, Route Handlers, vaizdo optimizavimą, middleware. Tai naudoja tokios platformos kaip **Vercel** (Next.js kūrėjas, zero-config) ir Node hostai.

## 2. output: "standalone" — Docker / savivaldus hostingas

```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` sukuria minimalią aplanką, kurioje yra tik iš tikrųjų naudojamos priklausomybės, ideali mažiems Docker vaizdams AWS, GCP, jūsų serveriuose ir kt. Jūs išsaugote visas serverio funkcijas.

## 3. output: "export" — visiškai statinis

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

Statinis eksportas suteikia pigiausią, paprasčiausią hostingą, bet **išjungia serverio funkcijas**: nėra SSR, nėra ISR, nėra Route Handlers, nėra Server Actions, nėra patobulinamo vaizdo optimizavimo. Tinka tik visiškai statiniams svetainėms.

## Pasirinkimas

```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
```

## Kitos aplinkybės

```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
```

## Kodėl tai svarbu

Diegimas nėra vienmaštis: `output` režimas nustato, kurios Next.js funkcijos išlieka.

Žinojimas, kad **numatytoji/Node** išvestis išlaiko visas serverio galimybes, **standalone** jas pakuoja Docker/savivaldui hostingui, o **export** keičia visas serverio funkcijas grynajam statiniam hostingui, leidžia suderinti build su jūsų infrastruktūra — ir išvengti spąstų, kai `output: "export"` tyliai sugadina SSR/ISR/Server Actions.