Какие опции развертывания и выходные данные сборки поддерживает Next.js?

Question

Accepted Answer

Next.js поддерживает несколько целей развертывания, частично контролируемых конфигурацией **`output`**. Правильный выбор зависит от того, нужен ли вам сервер Node, контейнеры или чистый статический хостинг.

## Режимы выходных данных сборки

```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) — все возможности

Запускает сервер Node.js, поэтому вы получаете **всё**: SSR, ISR, Server Actions, Route Handlers, оптимизацию изображений, middleware. Это то, что используют платформы типа **Vercel** (создатель Next.js, zero-config) и хосты Node.

## 2. output: "standalone" — для Docker / самостоятельного хостинга

```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, собственных серверах и т. д. Вы сохраняете все возможности сервера.

## 3. output: "export" — полностью статический

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

Статический экспорт даёт самый дешёвый, самый простой хостинг, но **отключает функции сервера**: нет SSR, нет ISR, нет Route Handlers, нет Server Actions, нет оптимизации изображений на лету. Подходит только для полностью статических сайтов.

## Выбор

```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 сохранятся.

Зная, что выходные данные **по умолчанию/Node** сохраняют все возможности сервера, **standalone** упаковывает их для самостоятельного хостинга/Docker, а **export** обменивает все функции сервера на чистый статический хостинг, вы можете подобрать сборку к своей инфраструктуре — и избежать ловушки, когда `output: "export"` скрытно нарушает SSR/ISR/Server Actions.