Como usar variáveis de ambiente no cPanel para aplicações Node.js

Como usar variáveis de ambiente no cPanel para aplicações Node.js

Oi! Eu sou a Sensei da GeHost 🧘‍♀️ e hoje vou te ensinar um truque que todo projeto Node.js sério usa: as variáveis de ambiente. Elas servem pra guardar informações sensíveis ou que mudam de ambiente pra ambiente — como chave de API, URL de banco de dados, token de e-mail — sem deixar esses dados escritos direto no código. Isso é mais seguro e evita dor de cabeça quando você precisa trocar um valor sem mexer no seu código-fonte.

Vamos passo a passo, com calma, do jeitinho que a Sensei gosta 😉

Passo 1 — Acesse o cPanel

Entre no cPanel da sua hospedagem com o usuário e senha que você recebeu no e-mail de boas-vindas (ou peça a 2ª via no painel.gehost.com.br se não lembrar).

Passo 2 — Encontre o "Setup Node.js App"

Já dentro do cPanel, procure (use a barra de busca do painel se preferir) pela ferramenta de configuração de aplicações Node.js — geralmente aparece como "Setup Node.js App" na área de ferramentas de desenvolvimento/software.

Passo 3 — Selecione sua aplicação

Se você já criou sua aplicação Node.js por lá, clique nela (ou no ícone de edição/lápis) pra abrir os detalhes. Se ainda não criou nenhuma aplicação, é preciso criar primeiro — nesse caso, fale com nosso suporte que a gente te orienta certinho.

Passo 4 — Adicione as variáveis de ambiente

Dentro da tela de configuração da sua aplicação, procure a seção chamada algo como "Environment Variables" (Variáveis de Ambiente). Lá você vai:

1. Clicar em "Add Variable" (Adicionar Variável).
2. Preencher o Name (nome da variável, ex.: DB_PASSWORD, API_KEY) — de preferência em letras maiúsculas.
3. Preencher o Value (o valor correspondente).
4. Repetir para cada variável que sua aplicação precisar.
5. Clicar em Save (Salvar) ao final.

💡 Dica da Sensei: no seu código Node.js, você acessa cada variável assim: process.env.NOME_DA_VARIAVEL. Nunca escreva senha ou chave direto no código — sempre pelo process.env!

Passo 5 — Reinicie a aplicação

Depois de salvar as variáveis, é essencial clicar no botão de "Restart" (Reiniciar) da aplicação para que as mudanças entrem em vigor. Sem reiniciar, o Node.js continua rodando com os valores antigos.

Usando um arquivo .env (alternativa para quem já usa esse padrão)

Se o seu projeto já usa uma biblioteca como o dotenv para ler variáveis de um arquivo .env, você pode criar ou editar esse arquivo diretamente pelo Gerenciador de Arquivos do cPanel, dentro da pasta da sua aplicação.

⚠️ Atenção: se o arquivo .env ficar dentro de uma pasta pública (como public_html), qualquer pessoa pode tentar acessá-lo pela internet. Prefira sempre a opção "Setup Node.js App" (Passo 4) quando possível — ela é mais segura porque as variáveis não ficam num arquivo exposto.

Recapitulando

• Variáveis de ambiente guardam dados sensíveis fora do código-fonte.
• No cPanel, configure pela tela "Setup Node.js App" → seção Environment Variables.
• Sempre reinicie a aplicação após qualquer alteração.
• Acesse os valores no código com process.env.NOME_DA_VARIAVEL.

Se der qualquer dúvida no meio do caminho, é só chamar a gente pelo painel.gehost.com.br — lembrando que toda entrega GeHost já vem com suporte gratuito nos primeiros 30 dias. Boa configuração! 🌱