Ir para o conteúdo

Configurar Node.js em um Servidor Linux – Inicie Aplicações Modernas em JavaScript

Descubra como configurar um ambiente Node.js estável para aplicações escaláveis em tempo real usando Docker e preparação do sistema → Saiba mais agora

10 de novembro de 20263 min de leitura17 visualizações0 útil

Introdução

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.

Preparação

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.

Atualizar o sistema

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:

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

Instalar dependências

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:

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

Instalação

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:

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

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

Configuração

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:

Code
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:

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

Finalização e recursos adicionais

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:

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! 🙂

FAQ

Perguntas frequentes

Primeiro, atualize seu sistema com sudo apt update && sudo apt upgrade -y. Como o Node.js roda em vários contêineres Docker, você deve instalar o Docker como dependência em seguida.
Node.js é um ambiente de execução JavaScript multiplataforma e de código aberto que executa código fora do navegador, baseado no motor V8 com I/O assíncrono e orientado a eventos.

Feedback

Este artigo foi útil?

Sua opinião nos ajuda a definir prioridades e a melhorar os conteúdos.

0 de 0 As avaliações consideraram este artigo útil.

Ajuda personalizada

As instruções não são suficientes?

A nossa equipe de suporte da ZAP conhece seu produto — descreva brevemente seu problema e ajudaremos pessoalmente.

O Zappy conhece este guia e te responde direto no chat.