Milyen telepítési lehetőségeket és buildkimeneteket támogat a Next.js?

Question

Accepted Answer

A Next.js több telepítési célt támogat, részben a **`output`** config által vezérelve. A helyes választás attól függ, hogy szükséged van-e Node szervernél, konténerekhez vagy tiszta statikus hostinghoz.

## A build kimenet módjai

```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. Alapértelmezett (Node szerver) — teljes funkcionalitás

Node.js szervert futtat, így megkapod az **összeset**: SSR, ISR, Server Actions, Route Handlers, képoptimalizálás, middleware. Ez az, amit olyan platformok használnak, mint a **Vercel** (a Next.js készítője, nulla konfigurációval) és a Node hosztok.

## 2. output: "standalone" — Docker-hez / saját hosztinghoz

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

A `standalone` egy minimális mappát hoz létre csak a ténylegesen használt függőségekkel, ideális a kis Docker képekhez az AWS-en, GCP-n, saját szervereiden stb. Megtartod az összes szerver funkcionalitást.

## 3. output: "export" — teljesen statikus

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

A statikus export a legolcsóbb, legegyszerűbb hosztingot nyújtja, de **letiltja a szerverüzemi funkciókat**: nincs SSR, nincs ISR, nincs Route Handlers, nincs Server Actions, nincs valós idejű képoptimalizálás. Csak teljesen statikus webhelyekhez alkalmazható.

## Választás

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

## Egyéb szempontok

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

## Miért fontos

A telepítés nem egy méret mindenkire: az `output` mód határozza meg, mely Next.js funkciók maradnak meg.

Az az ismeret, hogy az **alapértelmezett/Node** kimenet megtartja az összes szerveroldali képességet, az **standalone** csomagol őket Docker/saját hosztinghoz, és az **export** cserél az összes szerveroldali funkcióért a tiszta statikus hosztingban lehetővé teszi, hogy a buildet az infrastruktúrádhoz igazítsd — és elkerüld azt a csapdát, hogy az `output: "export"` csendesen tönkreteszi az SSR/ISR/Server Actions-t.