Servidor & DevOps 33 visualizações

Como configurar variáveis de ambiente para múltiplas aplicações no mesmo VPS sem conflito

Ver no WHMCS

Como configurar variáveis de ambiente para múltiplas aplicações no mesmo VPS sem conflito

Olá, querido(a) cliente da GeHost! Seja bem-vindo(a) ao seu guia de paz e produtividade no mundo da hospedagem. Aqui, você não está sozinho — sou a Sensei, e vou te guiar com calma, clareza e um toque de carinho para que você domine esse assunto sem estresse.

Imagine isso: você tem duas ou mais aplicações (como um site de blog e um sistema de pedidos) rodando no mesmo servidor, mas cada uma precisa de configurações diferentes — como senhas de banco de dados, chaves de API ou caminhos específicos. Se tudo for misturado, o caos chega rápido. Mas calma: com variáveis de ambiente, você organiza tudo direitinho — sem conflitos, sem dor de cabeça.

Na GeHost, você tem controle total do seu ambiente de desenvolvimento, mesmo em planos compartilhados. Vamos aprender juntos, passo a passo, como fazer isso com segurança e elegância.

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

Imagine uma caixinha de segredos que só sua aplicação pode abrir. Essas "caixinhas" são as variáveis de ambiente. Elas guardam informações sensíveis — como senhas, chaves de API ou caminhos — sem deixá-las visíveis no código.

Exemplo:

  • DB_PASSWORD = "s3nh4m4g1c4"
  • API_KEY = "abc123xyz"

Assim, se você precisar mudar a senha do banco, só muda aqui — não precisa mexer no código.

Dica Sensei: Nunca coloque senhas ou chaves diretamente no código. Isso é como deixar a chave da sua casa embaixo do tapete. A variável de ambiente é o seu cofre seguro.

Passo 2: Acesse o painel do cPanel

Para começar, faça login no seu painel de controle da GeHost:

Tela de LOGIN do cPanel com campos Usuário e Senha e botão Log in

Seu login é o mesmo que você usou para contratar a hospedagem. Após entrar, você estará na home do cPanel.

Passo 3: Acesse o Gerenciador de Arquivos

Na tela inicial do cPanel, localize o grupo de ferramentas Arquivos. Clique em Gerenciador de Arquivos.

Tela do Gerenciador de Arquivos com árvore de pastas e barra de ações

Selecione a pasta onde sua aplicação está hospedada (geralmente public_html ou uma subpasta como blog ou pedidos).

Passo 4: Crie arquivos .env para cada aplicação

Em cada pasta de aplicação, crie um arquivo chamado .env. Ele será o "guardião" das variáveis daquela aplicação.

Exemplo de estrutura para o blog:

DB_HOST=localhost
DB_NAME=blog_db
DB_USER=blog_user
DB_PASSWORD=senha123
API_KEY=chave_do_blog

E para o pedidos:

DB_HOST=localhost
DB_NAME=pedidos_db
DB_USER=pedidos_user
DB_PASSWORD=senha456
API_KEY=chave_dos_pedidos

⚠️ Importante: O arquivo .env NÃO deve ser acessível pela internet. Ele deve ficar dentro da pasta da aplicação, mas não pode ser acessado via URL.

Passo 5: Configure o servidor para ler as variáveis

Na GeHost, o cPanel permite que você configure variáveis de ambiente diretamente no painel. Isso é super útil para aplicações que usam PHP, Node.js ou Python.

Na tela do cPanel, vá até o grupo Software e clique em PHP Config (ou PHP Settings).

Na seção Environment Variables, você pode adicionar variáveis globais ou específicas para cada domínio.

Por exemplo:

  • APP_NAME = blog
  • DB_PASSWORD = senha123

✅ Pronto! Agora, cada aplicação pode acessar suas próprias variáveis — sem interferência mútua.

Passo 6: Evite conflitos com nomes únicos

Para garantir que nada se confunda:

  • Use nomes específicos: APP_BLOG_DB_PASSWORD em vez de apenas DB_PASSWORD.
  • Evite variáveis com nomes genéricos como KEY ou SECRET.
  • Organize por aplicação: crie uma pasta para cada app e mantenha os arquivos .env dentro delas.

Dica Sensei: Se você tiver 3 apps, mantenha 3 arquivos .env, cada um com seu nome e suas chaves. Assim, se um app falhar, o outro continua funcionando — como um grupo de amigos que respeitam o espaço do outro.

Passo 7: Teste e mantenha em segurança

Depois de configurar:

  1. Teste cada aplicação para ver se está lendo as variáveis corretamente.
  2. Use o Backup do cPanel (em Backup) para salvar suas configurações.
  3. Nunca compartilhe arquivos .env com ninguém — eles são como segredos de família.

Se precisar de ajuda, o suporte da GeHost está disponível por 30 dias após a entrega. Acesse o painel: painel.gehost.com.br e abra um ticket com detalhes.

Resumo final: a sabedoria do Sensei

Configurar variáveis de ambiente em múltiplas aplicações no mesmo servidor não é difícil — é só saber onde colocar cada coisa no lugar certo. Com organização, segurança e um toque de cuidado, você transforma um ambiente potencialmente caótico em um jardim de desenvolvimento florido.

Se você seguir esses passos, vai se sentir como um mestre do código — com calma, foco e muito mais confiança.

Com carinho,
Sensei da GeHost
*Onde o seu domínio encontra seu propósito*
G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)

Precisa de Ajuda?

Nossa equipe está pronta para resolver suas dúvidas.