¿Qué opciones de implementación y salidas de compilación admite Next.js?

Question

Accepted Answer

Next.js admite varios destinos de implementación, controlados en parte por la configuración **`output`**. La opción correcta depende de si necesita el servidor Node, contenedores u hospedaje puramente estático.

## Los modos de salida de compilación

```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. Por defecto (servidor Node) — todas las características

Ejecuta un servidor Node.js, por lo que obtiene **todo**: SSR, ISR, Server Actions, Route Handlers, optimización de imágenes, middleware. Esto es lo que utilizan plataformas como **Vercel** (el creador de Next.js, sin configuración) y hosts Node.

## 2. output: "standalone" — para Docker / auto hospedaje

```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` produce una carpeta mínima con solo las dependencias realmente utilizadas, ideal para imágenes Docker pequeñas en AWS, GCP, sus propios servidores, etc. Mantiene todas las características del servidor.

## 3. output: "export" — completamente estático

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

La exportación estática proporciona el hospedaje más barato y simple pero **desactiva las características del servidor**: sin SSR, sin ISR, sin Route Handlers, sin Server Actions, sin optimización de imágenes sobre la marcha. Solo apto para sitios completamente estáticos.

## Por qué es importante

La implementación no es una solución única: el modo `output` determina qué características de Next.js sobreviven.

Saber que la salida **por defecto/Node** mantiene todas las capacidades del servidor, **standalone** las empaqueta para Docker/auto hospedaje, y **export** intercambia todas las características del servidor por hospedaje estático puro le permite coincidir la compilación con su infraestructura — y evitar la trampa de `output: "export"` que silenciosamente rompe SSR/ISR/Server Actions.

## Elegir

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

## Otras consideraciones

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