Como configurar Node.js num VPS da GeHost para rodar uma aplicação

Como configurar Node.js num VPS da GeHost para rodar sua aplicação

Oi! Aqui é a Sensei da GeHost 🧘‍♀️ Se você chegou até aqui, provavelmente já tem (ou está prestes a receber) um VPS pra rodar sua aplicação em Node.js — e quer fazer isso com o pé direito, sem gambiarra. Relaxa, vou te guiar passo a passo, do jeitinho que eu explicaria pra alguém que nunca mexeu num terminal antes. Bora lá?

Se em algum momento você travar ou preferir que a gente faça essa configuração pra você, é só abrir um chamado no painel (painel.gehost.com.br). Sem vergonha nenhuma em pedir ajuda — é pra isso que a gente está aqui.

O que você vai precisar antes de começar

• O acesso ao seu VPS (endereço, usuário e senha ou chave SSH) — isso você recebe da nossa equipe ou encontra no seu painel de contratação.
• Um programa de terminal no seu computador (no Windows pode ser o PowerShell ou o app Terminal; no Mac/Linux, o próprio Terminal já serve).
• Os arquivos da sua aplicação Node.js prontos (ou o link do repositório, se você usa Git).
• Um pouquinho de paciência na primeira vez — depois que você configura uma vez, o resto é moleza. 😉

Passo 1 — Acessando seu VPS via SSH

O SSH é a "porta de entrada" segura do seu servidor. Abra seu terminal e digite:

ssh usuario@endereco-do-seu-servidor

Troque usuario e endereco-do-seu-servidor pelos dados que você recebeu da GeHost. Na primeira vez, o terminal pode perguntar se você confia na conexão — pode digitar yes e apertar Enter. Em seguida, informe a senha (ou, se você configurou chave SSH, ele entra direto).

Passo 2 — Instalando o Node.js no servidor

Com o servidor "aberto" na sua frente, vamos instalar o Node.js. A forma mais tranquila e organizada é usando o NVM (um gerenciador de versões do Node), porque ele te permite trocar de versão sem dor de cabeça no futuro.

1. Instale o NVM:

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

2. Recarregue o terminal (feche e abra de novo, ou rode source ~/.bashrc).
3. Instale a versão do Node que sua aplicação precisa (se não souber, a LTS mais recente costuma ser uma aposta segura):

   nvm install --lts

4. Confira se deu certo:

   node -v
   npm -v

Se apareceram os números das versões, parabéns — o Node.js já está instalado no seu VPS! 🎉

Passo 3 — Enviando sua aplicação pro servidor

Agora é hora de colocar o código da sua aplicação dentro do servidor. Você pode fazer isso de duas formas:

• Via Git (mais prático, se seu projeto está num repositório):

  git clone https://link-do-seu-repositorio.git

• Via envio de arquivos (SCP, SFTP ou um cliente como o FileZilla), se você prefere copiar a pasta do seu computador direto pro servidor.

Entre na pasta da sua aplicação com cd nome-da-pasta antes do próximo passo.

Passo 4 — Instalando as dependências e testando

Dentro da pasta da sua aplicação, instale tudo que ela precisa pra rodar:

npm install

Depois, dê um teste rápido pra ver se sobe sem erro:

node app.js

(Troque app.js pelo arquivo principal da sua aplicação — pode ser index.js, server.js, etc.) Se aparecer alguma mensagem tipo "servidor rodando na porta 3000", ótimo sinal! Aperte Ctrl+C pra parar por enquanto, porque no próximo passo vamos deixar isso rodando de um jeito mais profissional.

Passo 5 — Mantendo a aplicação rodando sempre (com PM2)

Se você fechar o terminal agora, sua aplicação para de rodar. Pra evitar isso — e pra ela reiniciar sozinha se cair ou se o servidor reiniciar —, usamos um gerenciador de processos chamado PM2.

1. Instale o PM2 globalmente:

   npm install -g pm2

2. Inicie sua aplicação com ele:

   pm2 start app.js --name minha-aplicacao

3. Configure pra iniciar automaticamente quando o servidor reiniciar:

   pm2 startup
   pm2 save

Dica da Sensei: use pm2 status pra ver se sua aplicação está de pé, e pm2 logs minha-aplicacao pra acompanhar os registros em tempo real quando algo parecer estranho.

Passo 6 — Deixando sua aplicação acessível pela internet

Sua aplicação Node.js normalmente roda numa porta interna (tipo 3000), mas o ideal é que quem visita seu site acesse pela porta padrão (80/443) e pelo seu domínio. Pra isso, usamos um servidor web como o Nginx como "ponte" (reverse proxy) entre a internet e sua aplicação.

1. Instale o Nginx (o comando varia conforme o sistema do seu VPS; em distribuições baseadas em Debian/Ubuntu costuma ser apt install nginx).
2. Configure um arquivo de site apontando para a porta da sua aplicação, algo como:

   server {
       listen 80;
       server_name seudominio.com.br;
   
       location / {
           proxy_pass http://localhost:3000;
           proxy_http_version 1.1;
           proxy_set_header Upgrade $http_upgrade;
           proxy_set_header Connection 'upgrade';
           proxy_set_header Host $host;
           proxy_cache_bypass $http_upgrade;
       }
   }

3. Reinicie o Nginx pra aplicar a configuração.

Depois disso, é só apontar o domínio pro seu servidor (essa configuração de DNS a gente também te ajuda a fazer pelo painel, se precisar).

Passo 7 — Ativando HTTPS (cadeado de segurança)

Com o domínio já apontando pro servidor, o próximo passo é ativar um certificado SSL gratuito, como o Let's Encrypt, usando a ferramenta certbot. Ela conversa com o Nginx e configura o HTTPS automaticamente pra você, deixando seu site com aquele cadeadinho verde que passa confiança pros visitantes.

Pronto! E agora?

Com esses passos, sua aplicação Node.js está rodando, se mantendo de pé sozinha e acessível pelo seu domínio com segurança. 🚀

Ficou travado em algum passo ou algo não funcionou como esperado? Não force a barra sozinho — abra um chamado no painel.gehost.com.br que nosso time dá uma força. E lembra: se essa implantação foi feita pela nossa equipe, você conta com 30 dias de suporte gratuito após a entrega.

Bons deploys! 💛

— Sensei da GeHost