Node.js é um ambiente de execução JavaScript multiplataforma e de código aberto que executa código JavaScript fora do navegador, por exemplo, em servidores ou ferramentas de linha de comando. Baseado no motor V8, ele suporta I/O assíncrono e orientado a eventos, tornando-o extremamente eficiente para construir aplicações de rede escaláveis e em tempo real.
O paradigma “JavaScript em todo lugar” permite que desenvolvedores usem uma única linguagem tanto no backend quanto no frontend.
Antes de configurar o Node.js, você deve preparar seu sistema. Isso inclui atualizar seu sistema operacional para a versão mais recente e instalar todas as dependências necessárias. Essa preparação garante um ambiente estável e ajuda a evitar problemas durante ou após a instalação.
Para garantir que seu sistema esteja executando o software mais recente e as atualizações de segurança, sempre faça uma atualização do sistema primeiro. Execute o seguinte comando:
sudo apt update && sudo apt upgrade -y
Isso assegura que seu sistema tenha os patches de segurança e versões de software mais recentes antes de prosseguir com a instalação.
Após a atualização, você pode continuar instalando as dependências. O Node.js será executado em vários contêineres Docker no seu sistema. Portanto, o Docker precisa estar instalado primeiro. Execute o seguinte comando:
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
Um guia detalhado passo a passo para instalar e usar o Docker está disponível em nosso tutorial Docker.
Com todos os pré-requisitos atendidos e a preparação concluída, você pode iniciar a instalação da aplicação Node.js.
Para usar o Node.js em um ambiente isolado, primeiro baixe a imagem oficial baseada no Alpine. Execute o comando abaixo para puxar a imagem mais recente do Node.js 22 para seu sistema e prepará-la para deploys em contêineres:
docker pull node:22-alpine
Em seguida, você pode iniciar um contêiner baseado nessa imagem e abrir uma sessão shell nele. Use o comando abaixo para iniciar o contêiner interativamente. A opção --rm garante que o contêiner seja removido automaticamente ao sair, mantendo seu host limpo.
docker run -it --rm --entrypoint sh node:22-alpine
Dentro do contêiner, verifique a versão instalada do Node.js com node -v, que deve mostrar v22.19.0. A versão do npm pode ser verificada com npm -v, que deve mostrar 10.9.3. Isso confirma que a imagem fornece as versões corretas do Node.js e npm, prontas para uso imediato.
Após iniciar o contêiner Node.js, é recomendável configurar as principais definições do Node.js diretamente no ambiente. Uma forma comum é definir variáveis de ambiente, por exemplo:
export NODE_ENV=production
Isso ativa o modo de produção, habilita otimizações de desempenho e ajusta o logging. Para desenvolvimento, você pode definir NODE_ENV=development para obter mensagens de erro detalhadas e recursos de depuração.
Uma estrutura de pastas bem organizada é importante, começando com um arquivo de configuração que você pode criar com o comando:
npm init -y
Isso gera um arquivo package.json que define dependências, scripts e metadados do seu projeto. É o arquivo central de configuração para qualquer aplicação Node.js.
Você pode instalar dependências com npm install <package>, enquanto dependências de desenvolvimento são adicionadas com npm install <package> --save-dev. A seção scripts no package.json permite definir comandos personalizados como npm start ou npm run build para facilitar a execução e gerenciamento do projeto.
Para configurações avançadas, o Node.js pode ser ajustado com arquivos .npmrc ou .nvmrc para usar registries privados, opções de cache ou forçar uma versão específica do Node.js. Isso garante que sua aplicação rode de forma consistente em diferentes ambientes.
Parabéns! Você instalou e configurou com sucesso o Node.js no seu VPS/Servidor Dedicado. Recomendamos também conferir os seguintes recursos que podem ajudar na configuração do servidor:
- nodejs.org – Site oficial
- nodejs.org/en/docs – Documentação do Node.js
Tem dúvidas específicas que não foram respondidas aqui? Nossa equipe está disponível diariamente para suporte — não hesite em nos contatar! 🙂