Koje opcije implementacije i izlaze sastavke Next.js podržava?

Question

Accepted Answer

Next.js podržava nekoliko ciljeva implementacije, dijelom kontrolirane **`output`** konfigom. Ispravan izbor ovisi o tome trebate li Node poslužitelj, kontejnere ili čist statički hosting.

## Modusi izlaza sastavke

```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. Zadana postavka (Node poslužitelj) — sve značajke

Pokreće Node.js poslužitelj, pa dobivate **sve**: SSR, ISR, Server Actions, Route Handlers, optimizaciju slika, middleware. To je ono što koriste platforme kao **Vercel** (tvorac Next.js-a, bez konfiguracije) i Node domaćini.

## 2. output: "standalone" — za Docker / samotmčenje

```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` proizvodi minimalnu mapu samo s potrebnim zavisnostima, idealno za male Docker slike na AWS-u, GCP-u, vašim vlastitim poslužiteljima itd. Zadržavate sve značajke poslužitelja.

## 3. output: "export" — potpuno statično

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

Statički izvoz omogućava najjeftiniji, najjednostavniji hosting, ali **onemogućava značajke poslužitelja**: nema SSR-a, nema ISR-a, nema Route Handlers-a, nema Server Actions-a, nema optimizacije slika u realnom vremenu. Prikladno samo za potpuno statične web-stranice.

## Odabir

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

## Ostala razmatranja

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

## Zašto je važno

Implementacija nije jedno rješenje za sve: `output` modus određuje koje Next.js značajke opstaju.

Znajući da **zadana/Node** izlaz čuva sve mogućnosti poslužitelja, **standalone** ih pakira za Docker/samotmčenje, i **export** razmjenjuje sve značajke poslužitelja za čist statički hosting omogućava vam usklađivanje sastavke s vašom infrastrukturom — i izbjegavanje zamke `output: "export"` koja tiho prekida SSR/ISR/Server Actions.