Como configurar variáveis de ambiente para uma aplicação hospedada via SSH Print

Como configurar variáveis de ambiente para uma aplicação hospedada via SSH

Olá, viajante da web! Seja bem-vindo ao seu guia prático e acolhedor para configurar variáveis de ambiente em sua aplicação hospedada na GeHost. Aqui, você não precisa ser um gênio da programação para dominar esse passo — basta seguir com calma e atenção. Vamos juntos, passo a passo, como um verdadeiro Sensei da hospedagem!

O que são variáveis de ambiente?

Imagine que sua aplicação é como um cozinheiro: ele precisa de ingredientes (como senhas, chaves de API, caminhos de arquivos) para cozinhar bem. As variáveis de ambiente são esses ingredientes, guardados de forma segura e acessíveis apenas quando necessário. Isso evita deixar senhas no código — e isso é super importante para a segurança da sua aplicação.

Dica do Sensei: Nunca coloque senhas, chaves ou dados sensíveis diretamente no código-fonte. Use variáveis de ambiente — é o caminho certo!

Passo a passo: Configurando variáveis de ambiente via SSH

Para isso, vamos usar o acesso via SSH (um canal seguro entre seu computador e o servidor). Você já tem acesso SSH? Se sim, vamos lá!

1. Conecte-se ao servidor via SSH

   Abra seu terminal (ou Putty, se estiver no Windows) e digite:

   ssh seu_usuario@seu_servidor

   Substitua seu_usuario e seu_servidor pelos dados fornecidos no painel da GeHost. Se não souber, acesse painel.gehost.com.br e verifique suas credenciais.

2. Localize a pasta da sua aplicação

   Use o comando ls para listar as pastas. Normalmente, sua aplicação estará dentro de public_html ou em uma subpasta como app ou projeto. Navegue até lá com:

   cd public_html/seu_projeto

3. Crie um arquivo de variáveis de ambiente

   Em sua aplicação, é comum usar um arquivo chamado .env para armazenar essas variáveis. Crie-o com:

   nano .env

   Isso abrirá um editor de texto no terminal. Digite suas variáveis no formato CHAVE=valor, por exemplo:

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

   Após digitar, pressione Ctrl + X, depois Y para salvar e Enter para confirmar.

4. Garanta que o arquivo .env seja invisível para o mundo

   Como esse arquivo contém dados sensíveis, ele não deve ser acessível pela internet. A GeHost já garante isso por padrão, mas é bom saber que o arquivo .env não é servido como página web.

   Se sua aplicação precisar ler esse arquivo (como em PHP, Node.js, Python, etc.), certifique-se de que o código está configurado para carregá-lo corretamente.

5. Configure o ambiente no servidor (opcional, mas recomendado)

   Alguns sistemas precisam de variáveis de ambiente definidas diretamente no servidor. Para isso, você pode editar o arquivo de inicialização do shell (como .bashrc ou .profile), mas isso é avançado.

   Se sua aplicação for rodada por um serviço (como um cron job ou um servidor Node.js em segundo plano), é melhor definir as variáveis no script de inicialização ou no processo de deploy.

6. Teste sua aplicação

   Depois de configurar, rode sua aplicação localmente ou via SSH para ver se tudo está funcionando. Se houver erro, verifique se o arquivo .env está no lugar certo e se as chaves estão corretas.

Importante: Segurança e boas práticas

• Nunca comite o arquivo .env no Git — use um .gitignore para excluí-lo do repositório.
• Use senhas fortes — evite senhas simples como "123456" ou "admin".
• Atualize suas chaves regularmente — especialmente se suspeitar de vazamento.
• Evite deixar variáveis no código-fonte — isso é um risco enorme!

Pro tip do Sensei: Se você usar um framework como Laravel, Django ou Express, ele já tem ferramentas prontas para lidar com .env. Basta seguir a documentação oficial do seu framework.

Quer mais ajuda?

Se ficar com dúvidas, entre em contato com nosso suporte técnico — estamos aqui para ajudar, com paciência e coração. Afinal, você não está sozinho nessa jornada de desenvolvimento.

Se precisar de um passo extra, como configurar variáveis em um sistema de deploy automatizado ou usar o cPanel para gerenciar arquivos, é só pedir. A GeHost está com você, a cada passo.

Este guia faz parte da Base de Conhecimento da GeHost — hospedagem segura, simples e feita com carinho desde 2015, por Raphael Neves Koga e o grupo G e Soluções e Eventos LTDA (entexp.com.br).