Como usar variáveis de ambiente com arquivos .env em uma aplicação Node.js no VPS

Como usar variáveis de ambiente com arquivos .env em uma aplicação Node.js no VPS (GeHost)

Olá, querido desenvolvedor ou empreendedor! Seja bem-vindo ao seu novo guia da Sensei da GeHost — onde aprendemos juntos, com calma, paciência e um toque de carinho. Hoje vamos entender como usar .env no seu projeto Node.js, mesmo em um ambiente de hospedagem compartilhada (como o da GeHost). Sim, é possível — e vamos fazer isso passo a passo, como se fosse um chá de manhã com um amigo.

Imagine que seu aplicativo precisa de senhas, chaves de API ou configurações sensíveis. Guardar tudo no código? Isso é como deixar a chave do seu carro na porta da casa. As variáveis de ambiente são a chave segura, escondida do mundo.

Dica da Sensei: Nunca comite arquivos como .env no Git. Eles são sensíveis e podem expor dados importantes. Use .gitignore para proteger seu projeto!

Passo 1: Instalar o pacote dotenv

No seu projeto Node.js, você precisa do pacote dotenv para carregar as variáveis do arquivo .env. Abra o terminal no seu computador (ou via SSH no cPanel) e digite:

npm install dotenv

Pronto! Agora seu projeto sabe como ler o arquivo .env.

Passo 2: Criar o arquivo .env

No diretório raiz do seu projeto (onde está o package.json), crie um arquivo chamado .env. Você pode criar ele diretamente no Gerenciador de Arquivos do cPanel.

Na tela do Gerenciador de Arquivos, vá até a pasta onde está seu projeto (geralmente public_html ou uma subpasta como app ou node-app). Clique em “Criar Arquivo”, digite .env e clique em “Criar”.

Passo 3: Adicionar suas variáveis

Abra o arquivo .env no editor de texto do cPanel (ou via SSH) e adicione suas variáveis no formato:

DB_HOST=localhost
DB_USER=meu_usuario
DB_PASSWORD=minha_senha
API_KEY=123abc456def
NODE_ENV=production

Importante: não coloque espaços em volta do sinal de igual. Cada linha é uma variável.

Passo 4: Carregar as variáveis no código

No arquivo principal do seu aplicativo Node.js (ex: app.js ou server.js), adicione estas linhas no início:

require('dotenv').config();

Depois disso, você pode acessar as variáveis com process.env.NOME_DA_VARIAVEL. Exemplo:

const dbPassword = process.env.DB_PASSWORD;
console.log('Senha do banco:', dbPassword);

Passo 5: Garantir que o Node.js esteja configurado corretamente

Na GeHost, seu aplicativo Node.js roda em um ambiente de hospedagem compartilhada com cPanel. Isso significa que você não tem acesso root, mas pode rodar aplicativos via Node.js App Manager (disponível no cPanel).

Para isso:

1. Entre no cPanel (acesso via painel.gehost.com.br).
2. Procure por “Node.js App Manager” no painel.
3. Selecione seu aplicativo ou crie um novo.
4. Defina o diretório do aplicativo (onde está o package.json).
5. Defina o arquivo principal (ex: app.js).
6. Garanta que o Node.js version seja compatível com seu projeto.
7. Salve as configurações.

Seu aplicativo agora está rodando com as variáveis carregadas — e o .env está sendo lido automaticamente, desde que o dotenv esteja instalado e configurado.

Passo 6: Testar e garantir segurança

Depois de publicar, teste seu aplicativo. Verifique se ele consegue acessar as variáveis corretamente.

Dica da Sensei: Nunca exponha variáveis no código-fonte, em logs ou em URLs. Use sempre process.env e mantenha o .env fora do repositório Git.

Conclusão: Você está no caminho certo!

Parabéns! Você aprendeu a usar variáveis de ambiente com segurança, mesmo em um ambiente de hospedagem compartilhada. Isso mostra que você está evoluindo como desenvolvedor — e a GeHost está aqui com você, a cada passo.

Se tiver dúvidas, entre em contato com nosso suporte (30 dias grátis após a entrega). E lembre-se: proteger dados é cuidar do seu projeto com amor.

Com carinho,
A Sensei da GeHost
Grupo: G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)