Desplegar Next.js

Despliega una app Next.js existente como proceso Node.js persistente. Las páginas estáticas, las rutas renderizadas en el servidor y las rutas de API pueden publicarse en la misma aplicación.

Usa el Página de despliegue de Next.js para revisar su idoneidad para producción, los precios, las plantillas y las comprobaciones de lanzamiento antes de seguir los pasos de implementación que aparecen a continuación.

¿Empiezas desde una carpeta vacía? Sigue el tutorial completo de compilación y despliegue de Next.js, o usa el Flujo de trabajo de creación de apps con ayuda de IA para Codex, ChatGPT, Gemini, y Claude.

Prerrequisitos

• Un proyecto Next.js que instala dependencias y compila desde una copia limpia del repositorio
• Un script de inicio de producción, como next start
• El Adios CLI instalados y autenticados

1. Añadir una ruta de comprobación de estado

Para un proyecto App Router, añade app/api/health/route.js:

export function GET() {
  return Response.json({ status: "ok" });
}

La ruta debe devolver una respuesta correcta cuando la aplicación esté lista para recibir tráfico. Si depende de una base de datos u otro servicio necesario, decide si la respuesta de estado debe verificar también esa dependencia.

2. Configurar el entorno de ejecución

Crea adios.yaml en la raíz del proyecto:

name: my-nextjs-app
region: de
replicas: 1

build_cmd: npm ci && npm run build
start_cmd: npm start

runtime:
  name: node@24
  port: 3000
  health_path: /api/health
  memory_mb: 1024

Mantén el gestor de paquetes y el archivo de bloqueo que ya utiliza tu proyecto. Para pnpm, sustituye los campos de comando por los comandos pnpm equivalentes:

build_cmd: pnpm install --frozen-lockfile && pnpm build
start_cmd: pnpm start

Ajusta la versión de Node.js, el puerto, la memoria, la región y la ruta de comprobación de estado para que coincidan con la aplicación. Consulta el referencia del manifiesto para todos los campos admitidos.

Elige el compilador

Adios ejecuta el comando de compilación de tu proyecto. Puedes utilizar webpack o Turbopack. Para proyectos Next.js compatibles, recomendamos probar Turbopack para reducir el tiempo de compilación. Selecciónalo en el package.json:

{
  "scripts": {
    "build": "next build --turbopack"
  }
}

Mantén next build --webpack si tu aplicación depende de plugins o configuración de webpack. Comprueba Compatibilidad de Next.js y prueba tus páginas, rutas de API y archivos generados antes de cambiar.

Si despliegas .next/standalone/server.js, mantén output: "standalone" en tu configuración de Next.js. El rastreo de dependencias identifica los archivos necesarios para ese paquete de servidor; Turbopack sigue generando esas dependencias mediante su propia ruta de compilación. Eliminar la salida independiente no desactiva automáticamente el rastreo de Next.js y requiere un paquete de despliegue distinto.

3. Agregar configuración y secretos

La configuración pública de ejecución se puede declarar en el manifiesto. Mantén los valores sensibles fuera de Git y referencia sus nombres:

env:
  NEXT_PUBLIC_APP_URL: https://app.example.com
  DATABASE_URL: secret://DATABASE_URL
  AUTH_SECRET: secret://AUTH_SECRET

Crea los valores de secretos referenciados con la CLI o el IDE web antes de que la app los necesite durante la ejecución.

4. Desplegar

Ejecuta el despliegue desde la raíz del proyecto:

adios up

Adios sube el código fuente actual, ejecuta el comando de compilación, inicia el proceso de producción y comprueba /api/health, y promueve la versión cuando informa de que está en buen estado. El despliegue devuelve una ruta HTTPS generada.

5. Inspeccionar y verificar

Distingue la salida de compilación de la salida del proceso en ejecución:

adios logs --build
adios logs --runtime

Abre la ruta generada y verifica una página estática, una página renderizada en el servidor y cualquier ruta de API de la que dependa la aplicación. Si falla la compilación o la comprobación de estado, utiliza la transmisión de registros correspondiente antes de desplegar la siguiente versión.

Dominios personalizados

Cuando funcione la ruta generada, añade y verifica el nombre de host de producción. Adios gestiona TLS para el dominio verificado y lo mantiene conectado a la versión promovida. Sigue Dominios y redirecciones para el orden de DNS y verificación.

Comienza desde una plantilla

Si no tienes un repositorio existente, elige una plantilla inicial oficial de Next.js en JavaScript o TypeScript con npm o pnpm en el catálogo de plantillas.