Como usar o npm para gerenciar projetos Node.js na GeHost (hospedagem)
Olá, querido(a) aluno(a) da GeHost! Seja bem-vindo(a) ao seu novo passo rumo ao desenvolvimento web com Node.js. Aqui, você vai aprender, de forma simples e prática, como usar o npm (Node Package Manager) para gerenciar seus projetos diretamente na nossa hospedagem — sem complicações, com apoio do cPanel e um toque de sabedoria digital. Vamos lá?
Antes de começar: entenda o que é npm
O npm é o gerenciador de pacotes padrão do Node.js. Ele ajuda você a instalar, atualizar e gerenciar as bibliotecas (ou pacotes) que seu projeto precisa — como frameworks, ferramentas de teste, compiladores, etc.
Dica do Sensei: Sempre que você usar Node.js em um projeto, o npm é seu melhor amigo. Ele evita que você baixe tudo à mão!
Passo a passo: como usar o npm na GeHost
-
Entre no cPanel da sua hospedagem
Abra seu navegador e acesse o painel de controle da GeHost. Você pode fazer isso digitando
seu-domínio.com.br/cpanelou usando o link fornecido na área do cliente.
-
Encontre a ferramenta "Terminal" no cPanel
No painel principal do cPanel (cpanel_home.png), procure pela seção “Advanced” e clique em “Terminal”. É aqui que você vai digitar comandos do Linux, incluindo o npm.
-
Verifique se o Node.js está instalado
No Terminal, digite o comando abaixo para ver se o Node.js está disponível:
node -vSe aparecer uma versão (como
v18.17.0), tudo certo! Se não, entre em contato com nosso suporte — pode ser que precise habilitar o suporte ao Node.js em seu plano. -
Crie ou acesse sua pasta de projeto
Se você já tem um projeto, vá para a pasta onde ele está. Caso contrário, crie uma nova pasta dentro de
public_html(ou na raiz do domínio) usando o Gerenciador de Arquivos.Exemplo:
public_html/meu-projeto-node
-
Inicie seu projeto com npm
No Terminal, navegue até a pasta do seu projeto:
cd public_html/meu-projeto-nodeDepois, inicialize o projeto com:
npm initResponda às perguntas (nome do projeto, versão, entrada principal, etc.) ou aperte Enter para usar os padrões.
Pronto! Agora você tem um arquivo
package.json— ele é o coração do seu projeto. -
Instale pacotes com npm
Quer usar um framework como Express? Basta digitar:
npm install expressIsso instala o Express e adiciona ao arquivo
package.json. Você também pode usar--save-devpara pacotes de desenvolvimento (como testes).Dica do Sensei: Sempre use
npm installpara instalar pacotes. Nunca baixe arquivos manualmente — o npm faz isso com segurança e controle! -
Execute seu projeto
Se seu arquivo principal for
app.js, você pode rodar com:node app.jsSe tudo estiver certo, o servidor será iniciado. Mas atenção: você só verá o site se ele estiver escutando em uma porta pública (como 80 ou 443) — em hospedagem, geralmente usamos o domínio diretamente.
-
Gerencie seus pacotes
Quer ver quais pacotes estão instalados?
npm listQuer atualizar tudo?
npm updateQuer remover um pacote?
npm uninstall nome-do-pacote
Importante: cuidado com arquivos e permissões
Seu projeto precisa estar em public_html ou em uma subpasta acessível via web. Evite colocar arquivos sensíveis (como node_modules) na raiz pública — eles podem ser acessados por outros.
Dica do Sensei: Use o arquivo.gitignore(ou.htaccess) para bloquear o acesso a pastas comonode_modulesouconfig.json.
Pronto! Você está no caminho certo
Parabéns! Agora você sabe como usar o npm na GeHost — com segurança, simplicidade e poder. Se precisar de ajuda, nosso suporte está aqui para você, como um verdadeiro Sensei digital.
Seu projeto Node.js está pronto para crescer. Vá em frente — o futuro da web está em suas mãos!