Como configurar variáveis de ambiente para uma aplicação Node.js no VPS imprimir

Como configurar variáveis de ambiente para uma aplicação Node.js no VPS

Olá, querido(a) desenvolvedor(a) ou empreendedor digital! Seja bem-vindo(a) ao guia da GeHost, seu parceiro de confiança na jornada digital. Hoje vamos aprender juntos como configurar variáveis de ambiente para uma aplicação Node.js em seu servidor VPS — um passo essencial para manter seus dados seguros e seu projeto flexível.

Se você está aqui, provavelmente já tem seu projeto rodando no servidor e quer deixar os dados sensíveis (como chaves de API, senhas de banco de dados ou URLs de ambiente) fora do código. Perfeito! Isso é exatamente o que as variáveis de ambiente fazem.

Como você é cliente da GeHost, seu servidor já está pronto para receber seu aplicativo. Vamos lá, com calma, passo a passo — como se fosse um treinamento de verdade, comigo como seu Sensei do mundo da hospedagem.

Passo 1: Acesse o painel do cPanel

Para começar, faça login no painel do cliente da GeHost:

• Visite painel.gehost.com.br
• Digite seu usuário e senha (os mesmos que você usou para se cadastrar)
• Confirme o login

Passo 2: Acesse o Gerenciador de Arquivos

Uma vez dentro do cPanel, vamos localizar o diretório onde sua aplicação Node.js está hospedada. Geralmente, isso é a pasta public_html ou uma subpasta dentro dela.

Na barra lateral do cPanel, localize e clique em Gerenciador de Arquivos.

Passo 3: Crie o arquivo .env

Na pasta raiz da sua aplicação (por exemplo, dentro de public_html/seu-projeto), crie um novo arquivo chamado .env.

Este arquivo será onde você armazenará todas as suas variáveis de ambiente. Ele não deve ser enviado ao repositório público (como GitHub), pois contém dados sensíveis.

Para criar o arquivo:

1. Localize a pasta da sua aplicação no Gerenciador de Arquivos
2. Clique com o botão direito sobre a pasta e selecione Novo Arquivo
3. Digite o nome: .env
4. Clique em Salvar

Passo 4: Adicione suas variáveis

Abra o arquivo .env com o editor do cPanel (clicando duas vezes nele). Agora, insira as variáveis no formato CHAVE=valor, uma por linha:

PORT=3000
DB_HOST=localhost
DB_NAME=meu_banco
DB_USER=usuario_db
DB_PASS=senha_segura
API_KEY=chave_123abc
NODE_ENV=production

⚠️ Dica importante: Nunca coloque senhas reais, chaves de API públicas ou dados sensíveis diretamente no código. Use sempre o .env para isso.

Passo 5: Instale o pacote dotenv (se ainda não estiver instalado)

Seu aplicativo Node.js precisa saber como ler o arquivo .env. Para isso, instale o pacote dotenv no seu projeto:

No terminal do servidor (ou via SSH, se tiver acesso), execute:

npm install dotenv

Depois disso, no início do seu arquivo principal (geralmente app.js ou server.js), adicione esta linha:

require('dotenv').config();

Isso carrega as variáveis do arquivo .env para o ambiente do Node.js.

Passo 6: Acesse as variáveis no código

Agora, no seu código, você pode acessar as variáveis como:

const port = process.env.PORT;
const dbPassword = process.env.DB_PASS;
const apiKey = process.env.API_KEY;

Pronto! Seu aplicativo já está lendo as variáveis de ambiente com segurança.

Passo 7: Teste com segurança

Depois de configurar, reinicie seu servidor Node.js (ou reinicie o processo no PM2, se estiver usando).

Verifique se o aplicativo está rodando corretamente. Se algo der errado, confira:

• O nome do arquivo está exatamente .env (com ponto na frente)
• O arquivo está na pasta correta (raiz da aplicação)
• O pacote dotenv está instalado
• As variáveis estão com o nome exato (case-sensitive)

💡 Dica do Sensei: Se algo não funcionar, não se preocupe! Isso é parte da jornada. Acesse o painel do cliente e entre em contato com o suporte — estamos aqui para ajudar, sempre.

Conclusão

Parabéns! Você acabou de aprender como configurar variáveis de ambiente para uma aplicação Node.js no seu servidor da GeHost. Agora, seus dados estão seguros, seu código está limpo e seu projeto está mais profissional do que nunca.

Se precisar de ajuda com SSH, PM2, SSL ou qualquer outro tema de DevOps, é só pedir. A GeHost está com você em cada passo da jornada.

Com carinho,
Seu Sensei da GeHost
*G e Soluções e Eventos LTDA – CNPJ: 46.647.904/0001-04*