Como subir uma aplicação Node.js Print

Como Subir uma Aplicação Node.js na GeHost

Bem-vindo! 🚀

Se você tem uma aplicação Node.js pronta e quer colocá-la no ar, chegou ao lugar certo. Esse guia vai te guiar passo a passo — de forma simples, mesmo que você não seja um dev experiente. Vamos lá!

O que é Node.js (resumão)?

Node.js é um ambiente que permite rodar código JavaScript no servidor — o mesmo JavaScript que roda no navegador, mas agora executando no seu servidor da GeHost. É perfeito para criar APIs, aplicações web dinâmicas e sistemas que precisam de processamento real.

Pré-requisitos

Antes de começar, você precisa de:

• Uma aplicação Node.js pronta — o código da sua aplicação (pode estar em um diretório local no seu computador).
• Acesso cPanel — você consegue fazer login no painel de controle da sua hospedagem.
• Um cliente FTP ou SSH — para enviar seus arquivos pro servidor. Recomendamos FileZilla (grátis) ou usar SSH diretamente no terminal.
• Um arquivo package.json — sua aplicação Node.js deve ter esse arquivo na raiz, listando todas as dependências.

Passo 1: Preparar sua Aplicação Localmente

Antes de enviar nada pro servidor, confira se sua aplicação está funcionando direitinho no seu computador:

1. Abra o terminal/prompt de comando no diretório da sua aplicação.
2. Rode npm install para instalar as dependências localmente (criar a pasta node_modules).
3. Teste executando npm start (ou node app.js, dependendo de como sua aplicação inicia).
4. Se rodar sem erros, ótimo! A aplicação está pronta. Você NÃO precisa fazer upload da pasta node_modules — o servidor instala tudo sozinho.

💡 Dica: Sempre mantenha um arquivo .gitignore (ou apenas saiba quais arquivos ignorar) — node_modules, arquivos temporários e credenciais sensíveis NÃO devem ir pro servidor.

Passo 2: Upload dos Arquivos para o Servidor

Agora vamos enviar sua aplicação pro servidor GeHost:

1. Acesse o cPanel da sua hospedagem com seu login e senha.
2. Procure por "Gerenciador de Arquivos" (ou use FTP/SFTP com um cliente como FileZilla).
3. Navegue até a pasta public_html (ou a pasta raiz da sua hospedagem).
4. Crie uma subpasta para sua aplicação Node.js (ex.: minhaapp).
5. Faça upload de TODOS os arquivos e pastas da sua aplicação, EXCETO node_modules.
6. Certifique-se de que o arquivo package.json está na raiz da pasta que você criou.

📝 Lembre: Use FTP/SFTP para arquivos (mais rápido) — o Gerenciador de Arquivos do cPanel funciona, mas é mais lento para muitos arquivos.

Passo 3: Instalar Dependências no Servidor

Agora que seus arquivos estão lá, é hora de instalar as dependências:

1. Acesse o cPanel e procure por "Terminal" (ou use SSH — peça as credenciais ao suporte da GeHost se não tiver).
2. Navegue até sua pasta de aplicação:
   cd public_html/minhaapp (substitua minhaapp pelo nome da sua pasta).
3. Execute: npm install
4. Aguarde — o servidor vai baixar e instalar todas as dependências listadas no package.json.

⚠️ Aviso: O comando npm install pode demorar alguns minutos, dependendo do tamanho das dependências. Não cancele — deixe rodar.

Passo 4: Configurar o Servidor (Node.js Application Manager)

A GeHost oferece um Node.js Application Manager no cPanel para gerenciar sua aplicação. Veja como usar:

1. No cPanel, procure por "Node.js Application Manager" (ou "Node.js Apps").
2. Clique em "Create Application" (ou "Nova Aplicação").
3. Preencha os dados:
   • App Name: dê um nome (ex.: minhaapp) — qualquer coisa é válida.
   • Node.js Version: escolha a versão recomendada (geralmente a mais recente estável — 18, 20 ou 22).
   • Application Root: aponte para a pasta onde seus arquivos estão (ex.: public_html/minhaapp).
   • Application Entry Point / Startup File: o arquivo que inicia sua aplicação (ex.: app.js, server.js, index.js — depende do seu projeto).
   • Application URL: vai gerar um domínio temporário (ou você aponta um domínio próprio).
4. Clique em "Create" e aguarde — o servidor está configurando tudo.

💡 Dica: Se sua aplicação usa um arquivo de configuração (ex.: .env com senhas/chaves de API), NUNCA faça upload via FTP. Ao invés, crie o arquivo diretamente no cPanel > Gerenciador de Arquivos ou use SSH para escrever os valores seguros.

Passo 5: Iniciar sua Aplicação

Se a configuração foi bem-sucedida:

1. Volte ao Node.js Application Manager.
2. Procure sua aplicação na lista e clique em "Start" (ou o ícone de play).
3. Aguarde poucos segundos — a aplicação vai iniciar.
4. Acesse a URL gerada (o Node.js Application Manager vai mostrar) — sua aplicação deve estar no ar! 🎉

⚠️ Atenção: Se a aplicação não iniciar, veja o log de erros no Node.js Application Manager — ele mostra exatamente qual foi o problema. Verifique se o arquivo de entrada (app.js etc.) existe e está correto.

Passo 6: Conectar seu Domínio Próprio (Opcional)

Se você quer usar seu domínio próprio (ex.: minhaapp.com.br) ao invés do domínio temporário do servidor:

1. No Node.js Application Manager, procure a opção de "Edit" na sua aplicação.
2. Mude a Application URL para seu domínio próprio.
3. Confira se o domínio já está apontando para a GeHost nos DNS (essa parte o suporte da GeHost ajuda se precisar).
4. Aguarde alguns minutos para o SSL/certificado atualizar.

Troubleshooting — Se Algo Não Funcionar

Aplicação não inicia:

• Cheque o log de erros no Node.js Application Manager — ele diz exatamente qual é o problema.
• Confira se o arquivo de entrada (app.js, server.js) existe mesmo.
• Verifique se npm install rodou com sucesso (procure pela pasta node_modules no servidor).

Erro de porta já em uso:

• Node.js Applications rodam em portas específicas gerenciadas pelo cPanel — você não precisa se preocupar com isso. Mas se sua aplicação tenta ouvir numa porta fixa, mude o código para usar a variável de ambiente process.env.PORT.

Dependências não encontradas (erro npm ERR!):

• Rode npm install novamente — pode ter falhado na primeira vez.
• Confira se o arquivo package.json está correto e na raiz da aplicação.

Aplicação funciona localmente mas não no servidor:

• Diferenças de versão do Node.js — ajuste a versão no Node.js Application Manager pra ficar igual à do seu computador.
• Variáveis de ambiente — confira se seu arquivo .env (ou de configuração) está no servidor com os valores certos.
• Permissões de arquivo — se usou SSH, garanta que os arquivos têm permissão de leitura (geralmente 644 para arquivos, 755 para diretórios).

📞 Não resolveu? Abra um ticket de suporte GeHost — a equipe pode olhar os logs do servidor e ajudar a diagnosticar o problema. Tenha em mãos: nome da aplicação, versão do Node.js que está tentando usar, e a mensagem de erro completa.

Dicas Finais (Ouro Puro 💎)

• Sempre use variáveis de ambiente para senhas, chaves de API e dados sensíveis — NUNCA deixe hardcoded no código.
• Mantenha sua aplicação atualizada — periodicamente rode npm update no servidor para atualizar dependências.
• Monitore logs regularmente — erros podem aparecer depois que tudo parece estar funcionando.
• Faça backup do seu código antes de fazer mudanças grandes — use Git ou baixe uma cópia local.
• Teste mudanças localmente primeiro — só envie pro servidor quando tiver certeza de que funciona.

Parabéns! 🚀

Sua aplicação Node.js está no ar! Se tiver dúvidas ou algo sair do esperado, nossa equipe de suporte está sempre pronta pra ajudar. Boa sorte com seu projeto!