Cómo instalar Node.js en Ubuntu: Guía completa con APT, NodeSource y nvm

1. Introducción: ¿Por qué usar Node.js en Ubuntu?

Excelente compatibilidad entre Ubuntu y Node.js

Node.js es una plataforma para ejecutar JavaScript del lado del servidor y se usa ampliamente para aplicaciones web y desarrollo de herramientas. Ubuntu, por otro lado, es una distribución Linux en la que confían muchos desarrolladores y administradores de servidores. Al combinar ambos, puedes crear un entorno de desarrollo que sobresale en estabilidad, flexibilidad y velocidad.

Instalar Node.js en Ubuntu proporciona las siguientes ventajas:

• Un sistema operativo ligero con una sobrecarga mínima, lo que permite un uso eficiente de los recursos del sistema
• Un entorno unificado basado en Linux, desde el desarrollo hasta las pruebas y la producción
• Alta compatibilidad con Node.js e integración fluida con herramientas como npm y nvm

Por estas razones, la combinación de Ubuntu y Node.js es sumamente atractiva como entorno de desarrollo tanto para frontend como para backend.

Público objetivo y propósito de este artículo

Este artículo está escrito para los siguientes lectores:

• Quienes desean usar Node.js en Ubuntu por primera vez
• Quienes quieren saber cuál método de instalación es el mejor
• Quienes desean usar la última versión de Node.js pero no están seguros de la configuración

Al leer este artículo, podrás comparar tres diferentes métodos de instalación de Node.js en Ubuntu y elegir el enfoque más adecuado según tus objetivos y nivel de habilidad. Además, esta guía cubre herramientas relacionadas como npm y yarn, así como soluciones a errores comunes, ayudándote a usar con confianza un entorno Node.js.

2. Visión general de los métodos de instalación de Node.js en Ubuntu

Tres métodos de instalación, cada uno con sus propias características

Existen tres formas principales de instalar Node.js en Ubuntu:

1. Instalar el paquete estándar mediante APT (Advanced Package Tool)
2. Instalar mediante NodeSource PPA (Personal Package Archive)
3. Usar nvm (Node Version Manager) para una gestión flexible de versiones

Cada método tiene sus propias ventajas y desventajas, y la mejor elección depende de tu caso de uso y la configuración del sistema. La tabla siguiente resume sus características.

Tabla comparativa de los métodos de instalación de Node.js

¿Por qué es importante la comparación?

Ubuntu prioriza la estabilidad, lo que significa que las versiones de software en el repositorio APT tienden a ser conservadoras. Como resultado, los usuarios que desean las últimas funciones de Node.js o necesitan probar múltiples versiones deberían considerar opciones distintas a APT.

Por otro lado, si tu objetivo es simplemente probar Node.js rápidamente o evitar configuraciones adicionales en un servidor de producción, el método APT puede ser suficiente.

¿Cuál deberías elegir?

En conclusión, para desarrolladores o cualquier persona que planee usar Node.js a largo plazo, instalar mediante nvm es el enfoque más recomendado. Las razones incluyen:

• Cambio sencillo entre la versión más reciente y versiones anteriores
• npm se instala automáticamente
• Menos problemas de permisos (no se requiere sudo)

3. Método ①: Instalar Node.js fácilmente con APT (Ubuntu oficial)

¿Qué es APT? El sistema de gestión de paquetes estándar en Ubuntu

APT (Advanced Package Tool) es el sistema de gestión de paquetes estándar utilizado por Ubuntu y otras distribuciones Linux basadas en Debian. Con APT, puedes instalar, actualizar y eliminar software fácilmente con un solo comando.

El repositorio oficial de Ubuntu incluye paquetes de Node.js, lo que significa que puedes instalar Node.js de inmediato sin ninguna preparación especial.

Pasos de instalación

1. Actualiza la lista de paquetes de APT.

   sudo apt update
   

2. Instala Node.js y npm.

   sudo apt install nodejs npm
   

3. Verifica la instalación.

   node -v
   npm -v
   

Si se muestra la información de la versión, la instalación fue exitosa.

Ventajas: Simple y seguro

• Altamente fiable al usar el repositorio oficial de Ubuntu
• Comandos simples que son fáciles para principiantes
• Integrado con las actualizaciones del sistema a través de APT

Desventajas: La versión puede estar desactualizada

Porque APT prioriza la estabilidad, la versión de Node.js disponible puede estar varias generaciones atrás.

Por ejemplo, en Ubuntu 22.04, la versión de Node.js instalada mediante APT podría ser la 12 o la 14, lo que significa que las funciones más recientes y las mejoras de seguridad pueden no estar incluidas.

Este método tampoco es adecuado si necesitas usar múltiples versiones de Node.js en diferentes proyectos.

A quién le conviene este método

• Principiantes que quieren probar Node.js de inmediato
• Entornos de producción donde una versión estable es suficiente
• Usuarios que no necesitan varias versiones de Node.js

4. Método ②: Instalar la última versión con el PPA de NodeSource

¿Qué es NodeSource?

NodeSource es un proveedor de confianza que entrega versiones estables y recientes de Node.js rápidamente, de forma independiente del equipo oficial de Node.js. Es especialmente útil para usuarios de Ubuntu y Debian que desean instalar versiones más nuevas de Node.js mientras continúan usando APT.

Este método está recomendado en el sitio web oficial de Node.js y es ampliamente usado en entornos empresariales.

Pasos de instalación (Ejemplo: Node.js 18.x)

1. Actualiza la lista de paquetes.

   sudo apt update
   

2. Instala curl si aún no está instalado.

   sudo apt install curl
   

3. Ejecuta el script de configuración de NodeSource.

   curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
   

4. Instala Node.js.

   sudo apt install -y nodejs
   

5. Verifica la instalación.

   node -v
   npm -v
   

Ventajas: Usa la última versión con APT

• Instalación sencilla de la versión estable más reciente de Node.js
• Gestión familiar basada en APT
• npm se instala automáticamente

Desventajas: Requiere añadir un PPA

• Unos pasos adicionales en comparación con la instalación estándar de APT
• Es necesario evaluar la confiabilidad de la fuente (NodeSource suele ser segura)

A quién le conviene este método

• Desarrolladores que quieren una versión estable y actualizada de Node.js
• Usuarios que consideran insuficiente el repositorio de Ubuntu pero no desean usar nvm
• Aquellos que quieren mantener una gestión centralizada de paquetes basada en APT

5. Método ③: Gestión flexible de versiones con nvm (Recomendado)

¿Qué es nvm? Una herramienta potente para gestionar versiones de Node.js

nvm (Node Version Manager) es una herramienta de línea de comandos que permite gestionar y cambiar entre múltiples versiones de Node.js. Es especialmente útil para desarrolladores que necesitan distintas versiones por proyecto o que quieren probar tanto las versiones más recientes como las LTS.

Con nvm puedes crear un entorno de desarrollo flexible completamente dentro de tu cuenta de usuario, sin instalar Node.js a nivel del sistema.

Instalación de nvm

1. Ejecuta el script de instalación usando curl.

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
   

2. Recarga tu archivo de configuración de shell.

   source ~/.bashrc
   

O, si utilizas Zsh:

source ~/.zshrc

3. Verifica que nvm esté instalado.

   command -v nvm
   

Si se muestra nvm, la instalación fue exitosa.

Instalación de Node.js con nvm

1. Instala la versión LTS:

   nvm install --lts
   

2. Instala una versión específica:

   nvm install 18
   

3. Cambia a la versión activa:

   nvm use 18
   

4. Establece la versión predeterminada:

   nvm alias default 18
   

5. Consulta las versiones instaladas:

   node -v
   npm -v
   

Ventajas: Máxima flexibilidad y control

• Múltiples versiones pueden coexistir y cambiarse al instante
• npm se instala automáticamente
• No se requiere sudo, lo que reduce problemas de permisos
• No modifica el entorno del sistema, ideal para desarrollo

Desventajas: La configuración inicial requiere atención

• nvm no funcionará si los archivos de configuración del shell no se cargan correctamente
• Se instala por usuario, no a nivel del sistema

A quién le conviene este método

• Desarrolladores que necesitan cambiar entre versiones de Node.js
• Usuarios que gestionan múltiples proyectos con diferentes requisitos
• Principiantes que quieren evitar problemas relacionados con permisos

6. Uso de npm y yarn

¿Qué es npm?

npm (Node Package Manager) es una herramienta esencial para gestionar paquetes de Node.js. Permite instalar y gestionar fácilmente bibliotecas y herramientas publicadas por desarrolladores de todo el mundo.

Cuando Node.js se instala a través de APT, NodeSource o nvm, npm generalmente se instala automáticamente.

Verificar la versión:

npm -v

Comandos básicos de npm

¿Qué es yarn?

yarn es una alternativa a npm desarrollada por Facebook, diseñada para una gestión de paquetes más rápida y confiable. Sus comandos son en gran medida compatibles con npm.

Instalación de yarn (a través de npm)

npm install -g yarn

Verificar la instalación:

yarn -v

Comandos básicos de yarn

npm vs yarn: ¿Cuál deberías usar?

El npm moderno (v7 y posteriores) ha mejorado significativamente, por lo que cualquiera de las opciones es generalmente adecuada. Es mejor seguir lo que ya usa tu proyecto o equipo.

7. Errores comunes y solución de problemas

Problemas comunes y soluciones

■ node: command not found

Causa:
Node.js no está instalado correctamente, o el PATH no está configurado. Esto ocurre a menudo después de instalar nvm sin recargar la configuración del shell.

Solución:

• Recargar el archivo de configuración del shell:

  source ~/.bashrc
  

• Si el problema persiste, cierra sesión y vuelve a iniciar sesión o reinicia

■ E: Unable to locate package nodejs

Causa:
La lista de paquetes APT está desactualizada o no se ha agregado el PPA correcto.

Solución:

• Actualizar la lista de APT:

  sudo apt update
  

• Si usas NodeSource, vuelve a ejecutar el script de configuración

■ npm ERR! permission denied

Causa:
Permisos insuficientes al instalar paquetes npm globales.

Solución:

• Usar sudo (no siempre recomendado):

  sudo npm install -g <package-name>
  

• Usar nvm es la mejor práctica para evitar problemas de permisos

■ nvm: command not found

Causa:
nvm está instalado, pero la configuración del shell no se ha cargado.

Solución:

• Asegúrate de que nvm esté incluido en tu archivo de configuración del shell
• Cárgalo manualmente:

  export NVM_DIR="$HOME/.nvm"
  [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
  

Mejores prácticas para evitar problemas

• Siempre verifica la configuración de PATH
• Usar nvm ayuda a evitar la mayoría de los problemas relacionados con el entorno
• Presta atención a la compatibilidad entre las versiones de Ubuntu y Node.js

8. Preguntas frecuentes (FAQ)

P1. ¿Cómo puedo verificar la versión de Node.js?

R. Ejecuta el siguiente comando en la terminal:

node -v

Para verificar npm también:

npm -v

P2. ¿Cómo puedo usar múltiples versiones de Node.js en Ubuntu?

R. Usar nvm es el enfoque más fácil y seguro. Después de la instalación, puedes cambiar versiones así:

nvm install 16
nvm use 16

P3. Node.js instalado a través de nvm no está activo. ¿Por qué?

R. En la mayoría de los casos, el archivo de configuración del shell no se ha cargado. Ejecuta:

source ~/.bashrc

O, para Zsh:

source ~/.zshrc

P4. ¿Cuál es la diferencia entre npm y yarn?

R. Su funcionalidad principal es similar, pero yarn ofrece instalaciones más rápidas usando caché y bloqueo explícito de dependencias a través de yarn.lock. El npm moderno ha mejorado significativamente, por lo que cualquiera de las opciones funciona bien.

P5. ¿En qué se diferencian Node.js, Deno y Bun?

R. Deno y Bun son runtimes alternativos diseñados para abordar las limitaciones de Node.js.

• Deno : Soporte nativo para TypeScript, seguridad mejorada, biblioteca estándar integrada
• Bun : Ejecución más rápida y gestión de paquetes integrada

Sin embargo, Node.js sigue siendo la opción más práctica debido a su vasto ecosistema npm.

9. Conclusión: Elige el método de instalación adecuado para tus necesidades

Hay múltiples formas de instalar Node.js en Ubuntu, cada una con claras fortalezas y casos de uso. Este artículo presentó tres métodos representativos y explicó cómo elegir el más adecuado.

APT (Ubuntu Oficial)

• Ventajas: Más fácil y seguro
• Desventajas: La versión puede estar desactualizada
• Recomendado para: Principiantes que quieran un inicio rápido

NodeSource PPA

• Ventajas: Instalar versiones más nuevas mientras se usa APT
• Desventajas: Requiere agregar un PPA
• Recomendado para: Desarrolladores que quieran una versión reciente estable

nvm (Node Version Manager)

• Ventajas: Cambio flexible de versiones y entorno limpio
• Desventajas: Configuración ligeramente más compleja
• Recomendado para: Desarrolladores que manejen múltiples proyectos

Esta guía también cubrió npm, yarn y consejos comunes de resolución de problemas. Aunque la instalación de Node.js puede parecer compleja al principio, elegir el método correcto facilita la construcción de un entorno de desarrollo estable en Ubuntu.

Si planeas expandir tus proyectos más allá, usar nvm como base te ayudará a escalar hacia el desarrollo en equipo y flujos de trabajo de CI/CD.