Como configurar variáveis de ambiente com segurança num projeto Node.js no VPS

Como configurar variáveis de ambiente com segurança num projeto Node.js no VPS

Olá, querido(a) desenvolvedor(a)! Seja bem-vindo(a) ao seu novo passo rumo à segurança e organização no mundo da programação. Aqui, na GeHost, acreditamos que todo código deve ser protegido — especialmente quando roda em produção. Hoje, vamos aprender juntos como configurar variáveis de ambiente com segurança em um projeto Node.js hospedado no seu VPS. Não se preocupe: mesmo que você seja iniciante, comigo você vai dominar isso com calma e certeza.

Sensei diz: "A segurança começa onde o segredo começa. Nunca coloque senhas, chaves ou dados sensíveis no código. Isso é como deixar a chave da sua casa embaixo do tapete."

Passo 1: Entenda o que são variáveis de ambiente

Imagine que seu projeto Node.js é uma receita de bolo. Os ingredientes principais (como açúcar, farinha e ovos) são o código. Agora, o açúcar pode ser substituído por um tipo diferente dependendo da ocasião — por exemplo, açúcar mascavo em vez de branco. Isso é como uma variável de ambiente: ela muda o comportamento do sistema sem alterar o código principal.

Exemplos comuns:

• Chave de acesso a bancos de dados
• Token de API externa (como Google, Stripe, etc.)
• URL de ambiente (desenvolvimento vs produção)
• Senhas de administração

Colocar esses dados diretamente no código é como escrever sua senha no caderno de anotações. Nunca faça isso!

Passo 2: Crie um arquivo `.env` local (só para desenvolvimento)

No seu projeto local (no seu computador), crie um arquivo chamado .env. Ele deve ficar na raiz do seu projeto, ao lado do package.json.

Exemplo de conteúdo:

DB_HOST=localhost
DB_USER=meu_usuario
DB_PASS=senha_segura_123
API_KEY=chave_super_secreta_do_google
NODE_ENV=development

⚠️ Importante: Esse arquivo nunca deve ser enviado ao GitHub ou compartilhado com ninguém. Para isso, adicione o nome do arquivo ao arquivo .gitignore:

.env
.env.local
.env.development

Passo 3: Instale o pacote `dotenv` no seu projeto

Para que o Node.js leia o arquivo `.env`, você precisa instalar o pacote dotenv. Abra seu terminal na raiz do projeto e execute:

npm install dotenv

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

require('dotenv').config();

Pronto! Agora o Node.js vai carregar as variáveis de ambiente automaticamente.

Passo 4: Configure o ambiente no VPS com segurança

Agora vem a parte mais importante: no servidor (VPS), você NÃO deve usar um arquivo `.env` no disco. Por quê? Porque qualquer pessoa com acesso ao sistema pode ler esse arquivo. Então, vamos usar o método seguro: variáveis de ambiente do sistema.

1. Faça login no seu cPanel via painel.gehost.com.br.

2. No painel, acesse a ferramenta “Node.js App Manager” (ou “Gerenciador de Aplicativos Node.js”).

3. Encontre o seu aplicativo Node.js e clique em “Configurar”.

4. Na seção de “Environment Variables”, você verá um campo para adicionar variáveis.

Adicione cada uma das variáveis com segurança, como:

• DB_HOST → valor do seu banco de dados (ex: localhost ou IP do banco)
• DB_USER → usuário do banco
• DB_PASS → senha do banco (nunca use a mesma do cPanel!)
• API_KEY → chave da API
• NODE_ENV → production

⚠️ Atenção: Não coloque dados sensíveis como senhas de e-mail ou chaves de pagamento diretamente aqui? Sim, mas lembre-se: o acesso ao cPanel é restrito ao seu usuário. Só você tem acesso ao painel. Isso já é um bom nível de segurança.

Passo 5: Teste e valide

Depois de salvar as variáveis no cPanel, reinicie seu aplicativo Node.js. Você pode fazer isso no mesmo painel, clicando em “Reiniciar”.

Para testar se as variáveis estão funcionando, adicione um trecho no seu código:

console.log('Ambiente:', process.env.NODE_ENV);
console.log('DB Host:', process.env.DB_HOST);

Veja se os valores aparecem corretamente no log do seu aplicativo (acessível via “Logs” no cPanel).

Dicas de segurança que o Sensei te dá:

• Nunca comite um arquivo `.env` no Git.
• Use senhas fortes e únicas para cada serviço (não repita a senha do cPanel).
• Evite usar o mesmo nome de usuário do banco de dados do cPanel.
• Atualize as chaves de API regularmente (ex: a cada 3 meses).
• Se precisar de ajuda, entre em contato com o suporte da GeHost — estamos aqui para te ajudar com carinho.

Quer saber mais?

Se você quer ir além, pode usar ferramentas como PM2 para gerenciar seu aplicativo Node.js com mais controle. Mas lembre-se: mesmo com PM2, as variáveis devem ser configuradas no sistema ou no cPanel — nunca no código.

Se tiver dúvidas, não hesite. A GeHost está aqui com você, com todo o cuidado que um bom desenvolvedor merece. E lembre-se: segurança não é uma opção — é uma obrigação.

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