Como instalar o Node.js num VPS Ubuntu ou Debian?
Instalar uma versão LTS recente do Node.js com NodeSource ou nvm no Ubuntu 24.04 e no Debian 12, manter a aplicação online com o PM2 e reiniciá-la no
O pacote nodejs dos repositórios oficiais instala o Node.js 18 tanto no Ubuntu 24.04 como no Debian 12, uma versão sem correções desde abril de 2025. Para uma aplicação ou um bot em produção, instale uma versão LTS: o Node.js 26 é a LTS ativa a 17 de novembro de 2026 e o Node.js 24 continua mantido. Os comandos deste guia foram testados no Ubuntu 24.04 e no Debian 12.
Procedimento passo a passo
-
Escolher o método
O NodeSource acrescenta um repositório APT: uma só versão para todo o sistema, atualizada com apt upgrade. O nvm instala o Node.js na pasta de um utilizador e permite ter várias versões lado a lado. Para um só serviço, o NodeSource chega; para vários projetos com versões diferentes, escolha o nvm.
-
Instalar com o NodeSource
Como root, descarregue o script setup_26.x, leia-o se quiser, execute-o com bash e depois apt install -y nodejs. O pacote já inclui o npm: não instale também o pacote npm da distribuição.
-
Ou instalar com o nvm
Com a sessão do utilizador que vai executar a aplicação, instale primeiro o curl e a libatomic1 e depois execute o script de instalação do nvm v0.41.0. Recarregue a shell com source ~/.bashrc; em seguida nvm install --lts instala a LTS mais recente e torna-a a predefinida.
-
Verificar as versões
node -v deve mostrar v26 seguido do número de correção e npm -v uma versão 11. Se node -v ainda mostrar v18, o pacote antigo da distribuição tem prioridade: which node mostra o binário usado.
-
Executar a aplicação com o PM2
Instale o PM2 com npm install -g pm2, entre na pasta do projeto e execute pm2 start index.js --name app. O PM2 reinicia o processo se falhar; pm2 logs app mostra a sua saída e pm2 restart app reinicia-o depois de atualizar o código.
-
Reiniciar no arranque do VPS
pm2 startup cria um serviço systemd; com um utilizador que não é root, mostra um comando sudo env PATH= para copiar tal como está. Execute depois pm2 save para guardar a lista de processos que o PM2 vai repor após um reinício.
Node.js 26 LTS com o 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 com o nvm (utilizador da aplicação)
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: iniciar, acompanhar e reiniciar no arranque
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 começar
Precisa de acesso SSH ao VPS e de um utilizador dedicado à aplicação em vez de root: adduser app cria-o. Se apt install nodejs já foi executado, remova essa versão antiga com apt remove nodejs antes de passar ao NodeSource ou ao nvm, para que dois binários não entrem em conflito.
- Uma aplicação Node.js simples ou um bot do Discord funciona com menos de 200 MB de RAM; instalar as dependências com o npm precisa de mais durante alguns segundos.
- O campo engines de package.json ou um ficheiro .nvmrc indica a versão esperada pelo projeto.
Várias versões com o nvm
nvm install 24 acrescenta o Node.js 24 ao lado do 26, nvm use 24 muda a shell atual e nvm alias default 26 escolhe a versão das novas shells. Numa pasta que contém um ficheiro .nvmrc com 24, nvm use sem argumento carrega a versão certa. As versões instaladas pelo nvm ficam em ~/.nvm: só existem para esse utilizador, e um serviço systemd ou uma tarefa cron tem de chamar o caminho completo do binário, ou passar pelo PM2.
Abrir a aplicação à Internet
Um bot do Discord não precisa de nenhuma porta de entrada: liga-se ele próprio ao Discord. Uma API ou um site, pelo contrário, escuta numa porta como a 3000. O mais limpo é deixá-lo em 127.0.0.1 e colocar o Nginx à frente, com um certificado Let’s Encrypt; caso contrário, abra a porta no UFW e na firewall do painel.
Erros comuns e soluções
A maioria dos erros vem de uma versão do Node.js diferente da esperada, ou de uma shell que não carregou o nvm.
- nvm: command not found logo após a instalação: a shell ainda não leu ~/.bashrc. Execute source ~/.bashrc ou abra uma nova sessão SSH.
- node: error while loading shared libraries: libatomic.so.1 com o nvm: a biblioteca falta numa instalação mínima. apt install libatomic1 corrige o erro, sem reinstalar o Node.js.
- npm ERR! code EACCES em npm install -g: a pasta global pertence ao root. Com o NodeSource, instale as ferramentas globais como root; com o nvm, execute o comando sem sudo.
- SyntaxError: Unexpected token ou ERR_REQUIRE_ESM no arranque: o projeto espera uma versão mais recente. Compare node -v com o campo engines de package.json.
- A aplicação não volta depois de reiniciar o VPS: pm2 save não foi executado após o último pm2 start, ou o comando mostrado por pm2 startup não foi executado.
VPS ou alojamento de bots?
Para um só bot do Discord em Node.js, o alojamento de bots da ACLClouds evita toda esta instalação: envia o código, o painel instala as dependências, executa o bot 24/7 e reinicia-o se falhar. O plano gratuito (315 MB de RAM) aceita Node.js e Python; o plano Starter custa 2,99 € por mês, ou 2,39 € por mês com uma fidelização de 1 ano (preços a 17 de novembro de 2026).
O VPS justifica-se para várias aplicações, uma API com a sua base de dados ou uma necessidade de controlo total. O VPS Mini (2 vCPU, 8 GB de RAM, 40 GB de armazenamento) custa 4,99 € por mês sem fidelização, ou 3,99 € por mês com uma fidelização de 1 ano, com uma rede até 1 Gbit/s.
Verificação rápida
- node -v mostra uma versão LTS (v26 ou v24).
- pm2 list mostra a aplicação em online.
- A aplicação volta sozinha depois de reiniciar o VPS.
- A aplicação não corre como root.
Perguntas frequentes
Porque não instalar o Node.js com apt install nodejs?
Os repositórios do Ubuntu 24.04 e do Debian 12 fornecem o Node.js 18, cujo suporte terminou em abril de 2025, e muitas bibliotecas recentes, como o Vite 8 ou o ESLint 10, pedem uma versão mais nova. O NodeSource ou o nvm instalam uma LTS mantida.
NodeSource ou nvm: qual escolher?
O NodeSource serve para um servidor que executa uma só aplicação: o Node.js fica disponível para todos os utilizadores e atualiza-se com o resto do sistema. O nvm serve quando vários projetos pedem versões diferentes, ou para testar uma nova versão sem mexer na de produção.
Como atualizar o Node.js para uma nova LTS?
Com o NodeSource, apt upgrade aplica as correções da mesma versão principal; para mudar de versão principal, volte a executar o script da nova versão e depois apt install nodejs. Com o nvm, nvm install --lts --reinstall-packages-from=current instala a nova LTS e copia para ela os pacotes globais, incluindo o PM2. Reinicie depois a aplicação e verifique os registos.
PM2 ou systemd para manter a aplicação online?
Ambos reiniciam o processo após uma falha e no arranque do VPS. O PM2 é mais simples para várias aplicações Node.js, com pm2 list, pm2 logs e o modo cluster; o systemd não acrescenta nenhuma ferramenta e serve para um serviço único. Evite combinar os dois para a mesma aplicação.