Guía extrema: Cómo optimizar el build de Next.js en servidores VPS con recursos limitados

Si has intentado compilar una aplicación mediana o grande de Next.js en un VPS básico (por ejemplo, con 1 o 2 GB de RAM), es muy probable que hayas sufrido un congelamiento completo del servidor. Esto ocurre porque Next.js, por defecto, intenta utilizar todos los hilos de CPU y toda la RAM disponible para paralelizar las tareas de optimización de código.

A continuación, te explico los ajustes clave que utilizo en mis proyectos de Sinergia para mantener las compilaciones seguras y estables en cualquier VPS.

1. Ajustes en `next.config.ts` La configuración más crítica es limitar los hilos de trabajo y la asignación de procesadores virtuales. Agrega esto en tu archivo de configuración:

import type { NextConfig } from "next";

const nextConfig: NextConfig = { experimental: { workerThreads: false, // Desactiva la paralelización extrema cpus: 1, // Limita a un único core el proceso de compilación }, };

export default nextConfig; ```

2. Limitar el uso de memoria en Node Podemos controlar la memoria máxima asignada a Node usando las opciones de variables de entorno al ejecutar el comando de build:

NODE_OPTIONS="--max-old-space-size=1024" npm run build

Esto evitará que el proceso sufra un error *Out of Memory* o sature la swap del sistema, manteniendo el servidor estable para el resto de webs.