Como configurar variáveis de ambiente (.env) de forma segura numa aplicação no VPS

Como configurar variáveis de ambiente (.env) de forma segura numa aplicação no VPS

Olá, querido(a) cliente da GeHost! Seja bem-vindo(a) ao seu guia de confiança, escrito com carinho por quem entende de servidor e desenvolvimento — o seu Sensei da hospedagem.

Hoje vamos falar de algo essencial, mas muitas vezes mal compreendido: como configurar variáveis de ambiente (.env) de forma segura em um aplicativo rodando no seu VPS. Se você está começando ou quer deixar sua aplicação mais segura, este guia é pra você.

💡 Dica do Sensei: Nunca, em hipótese alguma, deixe senhas, chaves de API ou dados sensíveis no código-fonte. O .env é a solução certa — desde que usado com cuidado.

Passo 1: Entenda o que é o .env

O arquivo .env é um arquivo simples que armazena variáveis de ambiente — como senhas, URLs de banco de dados ou chaves de API — de forma organizada e segura.

Exemplo de conteúdo do arquivo:

DB_HOST=localhost
DB_USER=meu_usuario
DB_PASS=senha_segura_123
API_KEY=abc123xyz

Esse arquivo não deve ser enviado para o GitHub ou compartilhado publicamente. Ele é para uso local ou em servidores privados.

Passo 2: Crie o arquivo .env no seu VPS

Use o terminal (SSH) para acessar seu servidor. Se você não sabe como fazer isso, consulte o painel do cliente e procure por "acesso SSH" no seu plano.

No terminal, navegue até o diretório da sua aplicação:

cd /home/seu_usuario/public_html/seu_projeto

Crie o arquivo .env:

touch .env

Abra o arquivo com um editor de texto como nano:

nano .env

Adicione suas variáveis, uma por linha, no formato CHAVE=valor. Exemplo:

APP_ENV=production
DB_HOST=localhost
DB_NAME=meu_banco
DB_USER=usuario_db
DB_PASS=senha_muito_segura
JWT_SECRET=chave_super_secreta_2025

Salve e feche o arquivo:

• No nano, pressione Ctrl + O para salvar, depois Enter.
• Depois, pressione Ctrl + X para sair.

Passo 3: Proteja o arquivo .env

Esse é o passo mais importante: o .env não deve ser acessível por ninguém que não deva ver.

Configure as permissões corretas no servidor:

chmod 600 .env

Isso garante que apenas o dono do arquivo (você) pode ler ou escrever nele.

💡 Dica do Sensei: Nunca deixe o .env no diretório público como public_html. Ele deve ficar em um local protegido, fora da raiz da web.

Passo 4: Configure o seu aplicativo para ler o .env

Se você está usando um framework como Laravel, Node.js, Django ou outro, ele provavelmente já tem um sistema para carregar variáveis do .env.

Por exemplo, em um aplicativo Node.js com dotenv:

require('dotenv').config();

Isso carrega automaticamente as variáveis do arquivo .env no ambiente da aplicação.

Se não souber como fazer isso, verifique a documentação do seu framework. A GeHost não faz isso por você — mas o suporte está disponível para ajudar!

Passo 5: Evite o .env no controle de versão

Se você usa Git, nunca comite o arquivo .env.

Adicione o arquivo ao .gitignore:

echo ".env" >> .gitignore

Isso garante que o arquivo sensível não será enviado para o GitHub ou qualquer outro repositório público.

Passo 6: Use um arquivo .env.example para ajuda

É uma boa prática criar um arquivo chamado .env.example com os nomes das variáveis, mas sem os valores reais:

APP_ENV=production
DB_HOST=localhost
DB_NAME=meu_banco
DB_USER=usuario_db
DB_PASS=senha_muito_segura
JWT_SECRET=chave_super_secreta_2025

Esse arquivo pode ser comitado no Git, para que outros desenvolvedores saibam quais variáveis são necessárias — sem expor senhas reais.

Passo 7: Teste com segurança

Depois de configurar, teste sua aplicação em modo de produção. Verifique se as variáveis estão sendo lidas corretamente.

💡 Dica do Sensei: Nunca teste senhas reais em ambiente público. Use apenas ambientes de desenvolvimento ou testes com dados fictícios.

Imagens de apoio

Para te ajudar a visualizar o processo no cPanel (se você usar a interface gráfica):

Na tela acima, você pode ver como navegar até o diretório da sua aplicação e criar o arquivo .env com o botão Criar ou usando o terminal.

Conclusão: Segurança começa com você

Configurar variáveis de ambiente com segurança não é só técnica — é hábito de cuidado. Com o .env bem usado, você protege sua aplicação, seus dados e sua reputação.

Se tiver dúvidas, lembre-se: o suporte da GeHost está aqui para te ajudar — e está disponível nos primeiros 30 dias após a entrega do serviço.

Seu sucesso é o nosso sucesso. 💚

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