Instalar Node.js e npm num VPS Linux

Este guia explica como instalar Node.js (runtime JavaScript) e npm (gestor de pacotes) num VPS Ubuntu ou Debian para executar aplicações web (Express, NestJS, ferramentas de build, etc.).

Pré-requisitos

• VPS Linux com acesso SSH sudo ou root
• Ubuntu 20.04+ ou Debian 11+ (64 bits)
• Ligação SSH funcional

Recomendação

Para builds frequentes (npm install, compilações), prefira um VPS com armazenamento rápido como o nosso VPS NVMe.

Método recomendado: NodeSource (LTS)

1. Atualizar o sistema

Bash
sudo apt update && sudo apt upgrade -y

2. Instalar pré-requisitos

Bash
sudo apt install -y ca-certificates curl gnupg

3. Adicionar chave e repositório NodeSource (exemplo: Node.js 22.x LTS)

Substitua 22.x pela versão LTS desejada consultando a documentação NodeSource.

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

4. Instalar Node.js

Bash
sudo apt install -y nodejs

5. Verificar

Bash
node -v
npm -v

Alternativa rápida: pacotes da distro

Bash
sudo apt install -y nodejs npm

As versões podem ser mais antigas que com NodeSource. Para produção, prefira NodeSource ou um gestor de versões (nvm).

Atualizar npm (opcional)

Bash
sudo npm install -g npm@latest

Boas práticas

• Evite executar npm do projeto como root: use um utilizador dedicado ou sudo -u myuser.
• Em produção, considere PM2 ou uma unidade systemd para reiniciar a app no arranque.
• Abra apenas as portas necessárias (firewall, proxy inverso Nginx à frente da app).

Resolução de problemas

• Permission denied em npm install -g: configure um diretório global ao nível do utilizador ou use nvm.
• Command not found após instalação: reconecte SSH ou abra um novo shell.

Próximos passos: proteger SSH e Nginx + Certbot para HTTPS.