Cén bhfuil ar a gcumas Next.js a sholáthar agus cén aschur tógála a thugann sé ar fáil?

Question

Accepted Answer

Tacaíonn Next.js le roinnt spriocanna dáilte, agus rudaí á rialú go páirteach ag an gcumraigh **`output`**. Braitheann an rogha cheart ar cibé acu atá gá agat don fhreastalaí Node, do dhóiríonn, nó do óstáil thúr statach.

## Na móid aschuir tógála

```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. Réamhshocrú (freastalaí Node) — gach gné

Rithíonn freastalaí Node.js, agus faigheann tú **gach rud**: SSR, ISR, Server Actions, Route Handlers, optamhú íomhá, middleware. Is iad na ardáin ar nós **Vercel** (an t-oidhreachóir ar Next.js, nialas-cumraitheoireachta) agus na fóstaithe Node a úsáideann sé seo.

## 2. output: "standalone" — do Docker / féin-óstáil

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

Táirgeann `standalone` foldúr íosta le spleáchais ar leith, díreach na dochroí a úsáidtear i ndáiríre, oiriúnach do dhóiríonn beaga Docker ar AWS, GCP, do fhreastalaithe féin, etc. Coimeádann tú gach gné freastalaí.

## 3. output: "export" — iomlán statach

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

Tugann an t-export statach an óstáil is saoire agus is simplí, ach **díchumasaíonn sé géaranna freastalaí**: gan SSR, gan ISR, gan Route Handlers, gan Server Actions, gan optamhú íomhá ar an bhealach. Ní oiriúnach ach do shuíomhanna iomlán statach.

## Rogha a dhéanamh

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

## Breithníuithe eile

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

## Cén fáth a bhíonn tábhacht ag baint leis

Ní dhéanfaidh an dáileadh a bheith i gceist do gach duine ar an mbealach céanna: socraíonn an mód `output` cé hiad na géaranna Next.js a bheidh ann.

Ar eolas agat go gcoimeádann an t-aschuir **réamhshocrútha/Node** gach cumas freastalaí, go bpacálaíonn **standalone** iad do Docker/féin-óstáil, agus go ndíonn **export** gach géare freastalaí ar an dóigh sin d'óstáil thúr statach go díreach tugann duit cumhacht an tógála a bhogadh chuig do bhonneagar — agus an ghaistí a sheachaint go bhfuil `output: "export"` ag briseadh SSR/ISR/Server Actions go fúilte go cinnte.