ACLClouds
ACLClouds

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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.