ACLClouds
ACLClouds

¿Cómo instalar Node.js en un VPS Ubuntu o Debian?

Instalar una versión LTS reciente de Node.js con NodeSource o nvm en Ubuntu 24.04 y Debian 12, mantener la aplicación en línea con PM2 y relanzarla al

El paquete nodejs de los repositorios oficiales instala Node.js 18 tanto en Ubuntu 24.04 como en Debian 12, una versión sin correcciones desde abril de 2025. Para una aplicación o un bot en producción, instale una versión LTS: Node.js 26 es la LTS activa a 17 de noviembre de 2026 y Node.js 24 sigue mantenida. Los comandos de esta guía se probaron en Ubuntu 24.04 y Debian 12.

Procedimiento paso a paso

  1. Elegir el método

    NodeSource añade un repositorio APT: una sola versión para todo el sistema, actualizada con apt upgrade. nvm instala Node.js en la carpeta de un usuario y permite tener varias versiones a la vez. Para un solo servicio basta NodeSource; para varios proyectos con versiones distintas, elija nvm.

  2. Instalar con NodeSource

    Como root, descargue el script setup_26.x, léalo si lo desea, ejecútelo con bash y luego lance apt install -y nodejs. El paquete ya incluye npm: no instale además el paquete npm de la distribución.

  3. O instalar con nvm

    Conectado con el usuario que ejecutará la aplicación, instale primero curl y libatomic1 y luego lance el script de instalación de nvm v0.41.0. Recargue el shell con source ~/.bashrc; después nvm install --lts instala la última LTS y la deja por defecto.

  4. Comprobar las versiones

    node -v debe mostrar v26 seguido del número de parche y npm -v una versión 11. Si node -v sigue mostrando v18, el paquete antiguo de la distribución va primero: which node muestra el binario usado.

  5. Lanzar la aplicación con PM2

    Instale PM2 con npm install -g pm2, vaya a la carpeta del proyecto y ejecute pm2 start index.js --name app. PM2 relanza el proceso si se cae; pm2 logs app muestra su salida y pm2 restart app lo reinicia tras actualizar el código.

  6. Relanzar al arrancar el VPS

    pm2 startup crea un servicio systemd; con un usuario que no es root, muestra un comando sudo env PATH= que hay que copiar tal cual. Después ejecute pm2 save para guardar la lista de procesos que PM2 restaurará tras un reinicio.

Node.js 26 LTS con NodeSource (root)

apt update && apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_26.x -o nodesource_setup.sh
bash nodesource_setup.sh
apt install -y nodejs
node -v
npm -v

Node.js con nvm (usuario de la aplicación)

sudo apt install -y curl libatomic1
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.41.0/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm install 24
nvm alias default 26
nvm ls

PM2: lanzar, seguir y relanzar al arrancar

npm install -g pm2
cd ~/app
pm2 start index.js --name app
pm2 list
pm2 logs app --lines 50
pm2 startup
pm2 save

Antes de empezar

Necesita acceso SSH al VPS y un usuario dedicado a la aplicación en lugar de root: adduser app lo crea. Si ya se ejecutó apt install nodejs, quite esa versión antigua con apt remove nodejs antes de pasar a NodeSource o nvm, para que no compitan dos binarios.

  • Una aplicación Node.js sencilla o un bot de Discord funciona con menos de 200 MB de RAM; instalar las dependencias con npm necesita más durante unos segundos.
  • El campo engines de package.json o un archivo .nvmrc indica la versión que espera el proyecto.

Varias versiones con nvm

nvm install 24 añade Node.js 24 junto a la 26, nvm use 24 cambia el shell actual y nvm alias default 26 elige la versión de los nuevos shells. En una carpeta que contiene un archivo .nvmrc con 24, nvm use sin argumento carga la versión correcta. Las versiones instaladas por nvm viven en ~/.nvm: solo existen para ese usuario, y un servicio systemd o una tarea cron debe llamar a la ruta completa del binario, o pasar por PM2.

Abrir la aplicación a Internet

Un bot de Discord no necesita ningún puerto de entrada: se conecta él mismo a Discord. Una API o un sitio, en cambio, escucha en un puerto como el 3000. Lo más limpio es dejarlo en 127.0.0.1 y poner Nginx delante, con un certificado Let’s Encrypt; si no, abra el puerto en UFW y en el firewall del panel.

Errores habituales y soluciones

La mayoría de los errores vienen de una versión de Node.js distinta de la esperada, o de un shell que no ha cargado nvm.

  • nvm: command not found justo después de instalar: el shell todavía no ha leído ~/.bashrc. Ejecute source ~/.bashrc o abra una nueva sesión SSH.
  • node: error while loading shared libraries: libatomic.so.1 con nvm: falta la biblioteca en una instalación mínima. apt install libatomic1 corrige el error sin reinstalar Node.js.
  • npm ERR! code EACCES en npm install -g: la carpeta global pertenece a root. Con NodeSource, instale las herramientas globales como root; con nvm, ejecute el comando sin sudo.
  • SyntaxError: Unexpected token o ERR_REQUIRE_ESM al arrancar: el proyecto espera una versión más reciente. Compare node -v con el campo engines de package.json.
  • La aplicación no vuelve tras reiniciar el VPS: no se ejecutó pm2 save después del último pm2 start, o no se ejecutó el comando mostrado por pm2 startup.

¿VPS o alojamiento de bots?

Para un solo bot de Discord en Node.js, el alojamiento de bots de ACLClouds evita toda esta instalación: usted sube el código, el panel instala las dependencias, ejecuta el bot 24/7 y lo reinicia si se cae. El plan gratuito (315 MB de RAM) acepta Node.js y Python; el plan Starter cuesta 2,99 € al mes, o 2,39 € al mes con un compromiso de un año (precios a 17 de noviembre de 2026).

El VPS se justifica para varias aplicaciones, una API con su base de datos o una necesidad de control total. El VPS Mini (2 vCPU, 8 GB de RAM, 40 GB de almacenamiento) cuesta 4,99 € al mes sin permanencia, o 3,99 € al mes con un compromiso de un año, con una red de hasta 1 Gbit/s.

Verificación rápida

  • node -v muestra una versión LTS (v26 o v24).
  • pm2 list muestra la aplicación en online.
  • La aplicación vuelve sola tras reiniciar el VPS.
  • La aplicación no se ejecuta como root.

Preguntas frecuentes

¿Por qué no instalar Node.js con apt install nodejs?

Los repositorios de Ubuntu 24.04 y Debian 12 ofrecen Node.js 18, cuyo soporte terminó en abril de 2025, y muchas bibliotecas recientes, como Vite 8 o ESLint 10, piden una versión más nueva. NodeSource o nvm instalan una LTS mantenida.

NodeSource o nvm: ¿cuál elegir?

NodeSource conviene a un servidor que ejecuta una sola aplicación: Node.js está disponible para todos los usuarios y se actualiza con el resto del sistema. nvm conviene cuando varios proyectos piden versiones distintas, o para probar una nueva versión sin tocar la de producción.

¿Cómo actualizar Node.js a una nueva LTS?

Con NodeSource, apt upgrade aplica las correcciones de la misma versión mayor; para cambiar de versión mayor, vuelva a lanzar el script de la nueva versión y luego apt install nodejs. Con nvm, nvm install --lts --reinstall-packages-from=current instala la nueva LTS y copia en ella los paquetes globales, PM2 incluido. Después reinicie la aplicación y revise sus registros.

¿PM2 o systemd para mantener la aplicación en línea?

Ambos reinician el proceso tras un fallo y al arrancar el VPS. PM2 es más sencillo para varias aplicaciones Node.js, con pm2 list, pm2 logs y el modo clúster; systemd no añade ninguna herramienta y conviene a un servicio único. Evite combinar ambos para la misma aplicación.