{"id":36960,"date":"2024-12-16T12:28:33","date_gmt":"2024-12-16T15:28:33","guid":{"rendered":"https:\/\/www.locaweb.com.br\/ajuda\/?post_type=ht_kb&#038;p=36960"},"modified":"2025-08-06T11:24:20","modified_gmt":"2025-08-06T14:24:20","slug":"instalar-node","status":"publish","type":"ht_kb","link":"https:\/\/www.locaweb.com.br\/ajuda\/wiki\/instalar-node\/","title":{"rendered":"Saiba como instalar Node.js"},"content":{"rendered":"<p>Saber<strong> instalar o<\/strong> <strong>Node.js<\/strong>, plataforma de desenvolvimento que permite a execu\u00e7\u00e3o de c\u00f3digos JavaScrip, \u00e9 fundamental para quem trabalha com essa linguagem de programa\u00e7\u00e3o.<\/p>\n<p data-start=\"186\" data-end=\"425\">Se voc\u00ea busca praticidade, vale conhecer a hospedagem especializada da KingHost, otimizada especialmente para esse ambiente.<br data-start=\"350\" data-end=\"353\" \/><a class=\"\" href=\"https:\/\/king.host\/node-js\" target=\"_new\" rel=\"noopener\" data-start=\"356\" data-end=\"425\">Conhe\u00e7a a hospedagem Node.js da KingHost<\/a><\/p>\n<p data-start=\"427\" data-end=\"575\">Mas se preferir realizar a instala\u00e7\u00e3o manual do Node.js em sua hospedagem Linux na Locaweb, veja abaixo como pode ser feita em diferentes sistemas operacionais, al\u00e9m de dicas para solucionar os principais erros que podem acontecer durante esse processo.<\/p>\n<h2>Como instalar o Node.js?<\/h2>\n<p>A instala\u00e7\u00e3o do Node.js \u00e9 um processo simples e r\u00e1pido, e permite que voc\u00ea comece a desenvolver aplica\u00e7\u00f5es em <a href=\"https:\/\/www.locaweb.com.br\/blog\/temas\/codigo-aberto\/o-que-e-javascript\/\" target=\"_blank\" rel=\"noopener noreferrer\">JavaScript<\/a> no lado do servidor.<\/p>\n<h3>Confira como fazer a instala\u00e7\u00e3o do Node.js no Windows<\/h3>\n<ul>\n<li>Baixe o instalador no <a href=\"http:\/\/Node.js\" target=\"_blank\" rel=\"noopener noreferrer\">site oficial do Node.js<\/a>;<img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-36962 size-large\" src=\"https:\/\/www.locaweb.com.br\/ajuda\/wp-content\/uploads\/2024\/12\/Download-node-1024x479.png\" alt=\"instalador node\" width=\"643\" height=\"301\" srcset=\"https:\/\/www.locaweb.com.br\/ajuda\/wp-content\/uploads\/2024\/12\/Download-node-1024x479.png 1024w, https:\/\/www.locaweb.com.br\/ajuda\/wp-content\/uploads\/2024\/12\/Download-node-300x140.png 300w, https:\/\/www.locaweb.com.br\/ajuda\/wp-content\/uploads\/2024\/12\/Download-node-768x359.png 768w, https:\/\/www.locaweb.com.br\/ajuda\/wp-content\/uploads\/2024\/12\/Download-node-50x23.png 50w, https:\/\/www.locaweb.com.br\/ajuda\/wp-content\/uploads\/2024\/12\/Download-node-1536x719.png 1536w, https:\/\/www.locaweb.com.br\/ajuda\/wp-content\/uploads\/2024\/12\/Download-node-60x28.png 60w, https:\/\/www.locaweb.com.br\/ajuda\/wp-content\/uploads\/2024\/12\/Download-node-100x47.png 100w, https:\/\/www.locaweb.com.br\/ajuda\/wp-content\/uploads\/2024\/12\/Download-node.png 1894w\" sizes=\"auto, (max-width: 643px) 100vw, 643px\" \/><\/li>\n<li>Em seguida, voc\u00ea ver\u00e1 duas vers\u00f5es dispon\u00edveis: LTS (Long Term Support) \u2014 que \u00e9 recomendada para a maioria \u2014 e a vers\u00e3o atual \u2014 que apresenta as \u00faltimas funcionalidades;<\/li>\n<li>Recomendamos que voc\u00ea <strong>escolha a LTS para garantir estabilidade<\/strong>;<\/li>\n<li>Localize o arquivo .msi execut\u00e1vel e clique duas vezes para abri-lo;<\/li>\n<li>Aceite os termos de uso e avance nas etapas;<\/li>\n<\/ul>\n<p><strong>Observa\u00e7\u00e3o<\/strong>: durante o download voc\u00ea pode optar por instalar o NPM (Node Package Manager), inclu\u00eddo por padr\u00e3o e que <strong>permite gerenciar pacotes e bibliotecas<\/strong>.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-36963 size-full\" src=\"https:\/\/www.locaweb.com.br\/ajuda\/wp-content\/uploads\/2024\/12\/instalacao-node.png\" alt=\"instalador do node\" width=\"491\" height=\"385\" srcset=\"https:\/\/www.locaweb.com.br\/ajuda\/wp-content\/uploads\/2024\/12\/instalacao-node.png 491w, https:\/\/www.locaweb.com.br\/ajuda\/wp-content\/uploads\/2024\/12\/instalacao-node-300x235.png 300w, https:\/\/www.locaweb.com.br\/ajuda\/wp-content\/uploads\/2024\/12\/instalacao-node-50x39.png 50w, https:\/\/www.locaweb.com.br\/ajuda\/wp-content\/uploads\/2024\/12\/instalacao-node-60x47.png 60w, https:\/\/www.locaweb.com.br\/ajuda\/wp-content\/uploads\/2024\/12\/instalacao-node-100x78.png 100w\" sizes=\"auto, (max-width: 491px) 100vw, 491px\" \/><\/p>\n<ol>\n<li style=\"list-style-type: none;\">\n<ol>\n<li>Ap\u00f3s a conclus\u00e3o da instala\u00e7\u00e3o, abra o prompt de comando (cmd) e digite:\n<pre><em> node -v<\/em><\/pre>\n<p>\u2014 isso permitir\u00e1 que voc\u00ea verifique se o Node.js j\u00e1 foi instalado corretamente e qual \u00e9 a sua vers\u00e3o;<\/li>\n<li>Para verificar o NPM, use:\n<pre><em>npm -v.<\/em><\/pre>\n<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<h3>Instala\u00e7\u00e3o do Node.js no Linux<\/h3>\n<p>Se voc\u00ea utiliza o sistema operacional Linux o processo acontece de forma um pouquinho diferente, mas igualmente simples:<\/p>\n<ol>\n<li style=\"list-style-type: none;\">\n<ol>\n<li>Para atualizar os pacotes do sistema, abra o terminal e execute o seguinte comando:\n<pre><em>sudo apt update <\/em><em>&amp;&amp; sudo<\/em><em> apt upgrade;<\/em><\/pre>\n<\/li>\n<li>Adicione o reposit\u00f3rio oficial para garantir que voc\u00ea tem a vers\u00e3o mais recente do Node.js, por meio do seguinte comando para adicionar a chave GPG:\n<pre><em>curl -fsSL https:\/\/deb.nodesource.com\/setup_lts.x | sudo -E bash -;<\/em><\/pre>\n<\/li>\n<li>Execute o seguinte comando para instalar o Node.js:\n<pre><em>sudo apt install -y nodejs<\/em><\/pre>\n<p>\u2014 ele instala automaticamente o NPM e \u00e9 indispens\u00e1vel para gerenciar pacotes JavaScript;<\/li>\n<li>Verifique se o Node.js foi instalado corretamente e qual em qual vers\u00e3o por meio do comando:\n<pre><em>node -v;<\/em><\/pre>\n<\/li>\n<li>Verifique o NPM com o comando:\n<pre><em>npm -v.<\/em><\/pre>\n<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<h3>Instala\u00e7\u00e3o do Node.js no macOS<\/h3>\n<p>Existem diversas formas de fazer esse processo no Mac, mas vamos mostrar os passos por meio do Homebrew, o gerenciador de pacotes que facilita a instala\u00e7\u00e3o de softwares no sistema.<\/p>\n<ol>\n<li style=\"list-style-type: none;\">\n<ol>\n<li>Se voc\u00ea ainda n\u00e3o tem o Homebrew instalado na sua m\u00e1quina, abra o terminal e execute o seguinte comando para instal\u00e1-lo:<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<pre><em>\/bin\/bash -c \"$(curl -fsSL https:\/\/raw.githubusercontent.com\/Homebrew\/install\/HEAD\/install.sh)\";<\/em><\/pre>\n<ol>\n<li style=\"list-style-type: none;\">\n<ol>\n<li>Caso j\u00e1 tenha o Homebrew, \u00e9 recomend\u00e1vel atualiz\u00e1-lo \u2014 \u00e9 s\u00f3 digitar este c\u00f3digo no seu terminal:\n<pre><em>brew update;<\/em><\/pre>\n<\/li>\n<li>Agora, voc\u00ea pode <strong>instalar o Node.js<\/strong> com o seguinte comando:\n<pre><em>brew install node<\/em><\/pre>\n<p>\u2014 assim como no Linux, esse comando tamb\u00e9m instala automaticamente o NPM;<\/li>\n<li>Verifique se o Node.js foi baixado corretamente ao digitar no terminal:\n<pre><em>node -v;<\/em><\/pre>\n<\/li>\n<li>Para verificar o NPM, o c\u00f3digo \u00e9 o seguinte:\n<pre><em>npm -v.<\/em><\/pre>\n<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<h2>Como resolver os erros de instala\u00e7\u00e3o do Node.js?<\/h2>\n<p>Saiba como resolver os principais problemas durante a instala\u00e7\u00e3o do Node.js.<\/p>\n<h3>Permiss\u00f5es insuficientes<\/h3>\n<p>Ao instalar o Node.js, especialmente no Linux ou no macOS, pode aparecer um erro de permiss\u00e3o negada. Isso acontece quando voc\u00ea tenta instalar pacotes globalmente sem permiss\u00f5es adequadas.<\/p>\n<p>A solu\u00e7\u00e3o \u00e9 <strong>usar o comando &#8220;sudo&#8221;<\/strong> para conceder permiss\u00f5es administrativas:<\/p>\n<pre><em>sudo npm install -g .<\/em><\/pre>\n<p>Voc\u00ea tamb\u00e9m pode <strong>configurar o NPM<\/strong> para evitar permiss\u00f5es elevadas:<\/p>\n<pre><em>npm config set prefix ~\/.npm-global.<\/em><\/pre>\n<h3>PATH n\u00e3o configurado corretamente<\/h3>\n<p>Ap\u00f3s a instala\u00e7\u00e3o, pode ser que os comandos \u201cNode\u201d ou \u201cNPM\u201d n\u00e3o sejam reconhecidos no terminal. Isso costuma acontecer quando o diret\u00f3rio de download n\u00e3o \u00e9 adicionado ao PATH do sistema.<\/p>\n<p>Para resolver, <strong>adicione o caminho do Node.js manualmente ao arquivo<\/strong> de configura\u00e7\u00e3o do seu shell (como .bashrc ou .zshrc):<\/p>\n<pre><em>export PATH=$PATH:\/usr\/local\/bin\/node.<\/em><\/pre>\n<h3>Conflito de vers\u00f5es do Node.js<\/h3>\n<p>Caso existam v\u00e1rias vers\u00f5es do Node.js instaladas, isso pode causar problemas na execu\u00e7\u00e3o de scripts. A solu\u00e7\u00e3o \u00e9<strong> usar o Node Version Manager (NVM)<\/strong> para gerenciar vers\u00f5es:<\/p>\n<pre><em>nvm install <\/em>\r\n\r\n<em>nvm use <\/em><\/pre>\n<h3>Problemas na instala\u00e7\u00e3o via NPM<\/h3>\n<p>Ao instalar pacotes via NPM, pode surgir o erro ERR!. Para resolver, <strong>limpar o cache do NPM<\/strong> pode funcionar. Para isso, use o comando:<\/p>\n<pre><em>npm cache clean --force.<\/em><\/pre>\n<h2>O que \u00e9 o Node.js?<\/h2>\n    \t\t<div class=\"hts-toggle  \"  >\r\n    \t\t\t<div class=\"hts-toggle__title\">Clique aqui: O que \u00e9 o Node.js?<\/div>\r\n    \t\t\t<div class=\"hts-toggle__content\">\r\n    \t\t\t\t<div class=\"hts-toggle__contentwrap\">\r\n    \t\t\t\t\t<\/p>\n<p>O Node.js \u00e9 uma <strong>plataforma de desenvolvimento que permite a execu\u00e7\u00e3o de c\u00f3digos JavaScript no lado do servidor <\/strong><strong>VPS<\/strong>, fora do ambiente tradicional do navegador.<\/p>\n<p>Ele foi criado por Ryan Dahl no ano de 2009 e utiliza o mecanismo V8 do Google Chrome para compilar e executar a linguagem JS de maneira extremamente eficiente.<\/p>\n<p>A plataforma \u00e9 bastante conhecida por ser <strong>r\u00e1pida, escal\u00e1vel e orientada a eventos<\/strong>, o que a torna uma excelente escolha para criar aplica\u00e7\u00f5es de alto desempenho e em tempo real.<\/p>\n<p>Uma das suas principais caracter\u00edsticas \u00e9 o seu <strong>modelo de execu\u00e7\u00e3o ass\u00edncrono e n\u00e3o bloqueante<\/strong>, que permite que v\u00e1rias opera\u00e7\u00f5es sejam realizadas simultaneamente sem travar o sistema.<\/p>\n<p>Al\u00e9m disso, o Node.js vem com NPM, um sistema de gerenciamento de pacotes que facilita o compartilhamento, a instala\u00e7\u00e3o e a atualiza\u00e7\u00e3o de bibliotecas e m\u00f3dulos de terceiros.<\/p>\n<p>A plataforma \u00e9 amplamente utilizada para <strong>construir aplica\u00e7\u00f5es de back end<\/strong>, como servidores web, microsservi\u00e7os, sistema de chat e streaming de dados. Inclusive, ela \u00e9 usada por grandes empresas como Netflix, Uber e LinkedIn, que a utilizam para criar sistemas escal\u00e1veis e de alta performance.<\/p>\n<p>\n    \t\t\t\t<\/div>\r\n    \t\t\t<\/div><!-- \/ht-toggle-content -->\r\n    \t\t<\/div>\r\n    \t\t\n<h2>Como usar o Node.js na pr\u00e1tica?<\/h2>\n    \t\t<div class=\"hts-toggle  \"  >\r\n    \t\t\t<div class=\"hts-toggle__title\">Clique aqui: Como usar o Node.js na pr\u00e1tica?<\/div>\r\n    \t\t\t<div class=\"hts-toggle__content\">\r\n    \t\t\t\t<div class=\"hts-toggle__contentwrap\">\r\n    \t\t\t\t\t<\/p>\n<p>Veja o que pode ser desenvolvido por meio do Node.js.<\/p>\n<h3>Servidores web<\/h3>\n<p>O Node.js \u00e9 amplamente usado para criar servidores web eficientes e escal\u00e1veis. Gra\u00e7as ao seu modelo ass\u00edncrono e n\u00e3o bloqueante, ele consegue <strong>lidar com v\u00e1rias conex\u00f5es simultaneamente<\/strong>, o que o torna ideal para sistemas de alta demanda, como redes sociais, sites de e-commerce e sistemas de streaming de v\u00eddeo.<\/p>\n<h3>APIs e Microsservi\u00e7os<\/h3>\n<p>Node.js \u00e9 excelente para a cria\u00e7\u00e3o de APIs RESTful e microsservi\u00e7os, o que <strong>permite que diferentes partes de uma aplica\u00e7\u00e3o se comuniquem de forma eficiente<\/strong>. Muitas empresas usam a plataforma para construir suas APIs por sua performance e facilidade de integra\u00e7\u00e3o com outros servi\u00e7os.<\/p>\n<h3>Aplica\u00e7\u00f5es em tempo real<\/h3>\n<p>O Node.js \u00e9 uma \u00f3tima escolha para desenvolver aplica\u00e7\u00f5es que exigem comunica\u00e7\u00e3o em tempo real, como <strong>chats, jogos multiplayer e plataformas de videoconfer\u00eancia<\/strong>. Ele facilita o uso de tecnologias, como WebSockets, que permitem uma troca cont\u00ednua de dados entre o cliente e o servidor.<\/p>\n<h3>Automa\u00e7\u00e3o e Scripts<\/h3>\n<p>Voc\u00ea tamb\u00e9m pode usar o Node.js para criar scripts automatizados, como<strong> tarefas de build, testes autom\u00e1ticos e deploy de aplica\u00e7\u00f5es<\/strong>. Ferramentas como Gulp e Grunt s\u00e3o baseadas nessa plataforma e ajudam a automatizar tarefas repetitivas no desenvolvimento.<\/p>\n<h3>Desenvolvimento Full-Stack<\/h3>\n<p>Com o Node.js, pessoas desenvolvedoras podem<strong> utilizar JavaScript tanto no front-end quanto no backend<\/strong>, o que facilita o desenvolvimento full-stack. Isso permite que equipes trabalhem de forma mais coesa ao utilizar uma \u00fanica linguagem de programa\u00e7\u00e3o.<\/p>\n<p>\n    \t\t\t\t<\/div>\r\n    \t\t\t<\/div><!-- \/ht-toggle-content -->\r\n    \t\t<\/div>\r\n    \t\t\n<h2>Outras vers\u00f5es do Node.js<\/h2>\n<p>O Node.js possui duas vers\u00f5es principais para atender \u00e0s diversas necessidades das pessoas desenvolvedoras, com foco em estabilidade, inova\u00e7\u00e3o e seguran\u00e7a: Current (Atual) e LTS (Long Term Support).<\/p>\n<h3>Vers\u00e3o Current<\/h3>\n<p>\u00c9 a <strong>mais recente<\/strong> e cont\u00e9m recursos e melhorias mais novos. Ela \u00e9 voltada para pessoas desenvolvedoras que desejam experimentar as funcionalidades mais recentes da plataforma e n\u00e3o t\u00eam problemas em lidar com poss\u00edveis instabilidades.<\/p>\n<p>Essa vers\u00e3o \u00e9 atualizada frequentemente e oferece acesso \u00e0s inova\u00e7\u00f5es mais recentes no ecossistema JavaScript. Entretanto, <strong>n\u00e3o \u00e9 recomendada para produ\u00e7\u00e3o<\/strong>, pois n\u00e3o recebe suporte prolongado e pode ter quebras em vers\u00f5es futuras.<\/p>\n<h3>Vers\u00e3o LTS (Long Term Support)<\/h3>\n<p>Essa \u00e9 a op\u00e7\u00e3o mais recomendada para a maioria dos casos, especialmente para ambientes de produ\u00e7\u00e3o. LTS significa &#8220;Suporte a Longo Prazo&#8221;, e essas vers\u00f5es <strong>recebem atualiza\u00e7\u00f5es de seguran\u00e7a e corre\u00e7\u00f5es de bugs por um per\u00edodo mais longo<\/strong>, geralmente de tr\u00eas anos.<\/p>\n<p>A vers\u00e3o LTS \u00e9 est\u00e1vel e confi\u00e1vel, o que garante que mudan\u00e7as cr\u00edticas sejam testadas antes de serem implementadas. Tamb\u00e9m \u00e9 recomendada para empresas e pessoas desenvolvedoras que precisam de estabilidade e suporte cont\u00ednuo.<\/p>\n<h3>Vers\u00f5es intermedi\u00e1rias<\/h3>\n<p>Al\u00e9m dessas, existem <strong>vers\u00f5es intermedi\u00e1rias que podem ser lan\u00e7adas para corrigir falhas pontuais e cr\u00edticas de seguran\u00e7a ou bugs importantes<\/strong>. Essas vers\u00f5es seguem o ciclo de lan\u00e7amento semestral, com uma edi\u00e7\u00e3o Current promovida para LTS uma vez por ano, geralmente no m\u00eas de outubro.<\/p>\n<h2>Conclus\u00e3o<\/h2>\n<p>O Node.js \u00e9 uma plataforma de desenvolvimento que permite executar JavaScript no lado do servidor, fora do navegador, e utiliza o motor V8 do Google Chrome. Ele \u00e9 amplamente utilizado para criar aplica\u00e7\u00f5es web r\u00e1pidas, escal\u00e1veis e em tempo real.<\/p>\n<p>A plataforma se destaca por seu modelo ass\u00edncrono e n\u00e3o bloqueante e permite que m\u00faltiplas opera\u00e7\u00f5es sejam processadas simultaneamente sem sobrecarregar o servidor. Esse fator a torna ideal para aplica\u00e7\u00f5es que demandam alto desempenho, como sistemas de chat, streaming de dados e APIs.<\/p>\n<p>Al\u00e9m disso, o Node.js tem uma vasta comunidade e conta com o NPM (Node Package Manager), que oferece milhares de bibliotecas e m\u00f3dulos para agilizar o desenvolvimento de projetos, o que permite a reutiliza\u00e7\u00e3o de c\u00f3digos e a integra\u00e7\u00e3o de novas funcionalidades de forma r\u00e1pida.<\/p>\n<p>Se gostou do conte\u00fado, aproveite e leia tamb\u00e9m o nosso material completo sobre <a href=\"https:\/\/www.locaweb.com.br\/blog\/temas\/codigo-aberto\/bash\/\" target=\"_blank\" rel=\"noopener noreferrer\">bash<\/a>!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Saber instalar o Node.js, plataforma de desenvolvimento que permite a execu\u00e7\u00e3o de c\u00f3digos JavaScrip, \u00e9 fundamental para quem trabalha com essa linguagem de programa\u00e7\u00e3o. Se voc\u00ea busca praticidade, vale conhecer a hospedagem especializada da KingHost, otimizada especialmente para esse ambiente.Conhe\u00e7a a hospedagem Node.js da KingHost Mas se preferir realizar a&#8230;<\/p>\n","protected":false},"author":48,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[119],"ht-kb-tag":[],"class_list":["post-36960","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-hospedagem-de-sites"],"_links":{"self":[{"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb\/36960","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/users\/48"}],"replies":[{"embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/comments?post=36960"}],"version-history":[{"count":4,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb\/36960\/revisions"}],"predecessor-version":[{"id":38205,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb\/36960\/revisions\/38205"}],"wp:attachment":[{"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/media?parent=36960"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb-category?post=36960"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb-tag?post=36960"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}