Ποιες επιλογές ανάπτυξης και εξόδους builds υποστηρίζει το Next.js;

Question

Accepted Answer

Το Next.js υποστηρίζει αρκετούς στόχους ανάπτυξης, που ελέγχονται εν μέρει από τη διαμόρφωση **`output`**. Η σωστή επιλογή εξαρτάται από το εάν χρειάζεστε τον Node server, containers ή καθαρή στατική φιλοξενία.

## Οι λειτουργίες εξόδου build

```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. Προεπιλογή (Node server) — πλήρες σύνολο δυνατοτήτων

Εκτελεί ένα Node.js server, επομένως παίρνετε **όλα**: SSR, ISR, Server Actions, Route Handlers, βελτιστοποίηση εικόνας, middleware. Αυτό είναι αυτό που χρησιμοποιούν πλατφόρμες όπως **Vercel** (ο κατασκευαστής του Next.js, χωρίς ρύθμιση) και 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, τους δικούς σας servers, κτλ. Διατηρείτε όλες τις δυνατότητες του server.

## 3. output: "export" — εντελώς στατικό

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

Η στατική εξαγωγή δίνει την πιο φτηνή, απλούστερη φιλοξενία, αλλά **απενεργοποιεί τις δυνατότητες του server**: χωρίς SSR, χωρίς ISR, χωρίς Route Handlers, χωρίς Server Actions, χωρίς βελτιστοποίηση εικόνας on-the-fly. Κατάλληλο μόνο για εντελώς στατικές ιστοσελίδες.

## Επιλογή

```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** διατηρεί όλες τις δυνατότητες του server, η **standalone** τις συσκευάζει για Docker/self-hosting, και η **export** ανταλλάσσει όλες τις δυνατότητες του server για καθαρή στατική φιλοξενία σας επιτρέπει να ταιριάξετε τη build με την υποδομή σας — και αποφύγετε την παγίδα του `output: "export"` που σιωπηλά σπάει SSR/ISR/Server Actions.