Como configurar variáveis de ambiente (.env) num projeto hospedado no VPS

Como configurar variáveis de ambiente (.env) num projeto hospedado no VPS — Guia para iniciantes (Sensei da GeHost)

Olá, querido(a) desenvolvedor(a) ou empreendedor digital! Se você está aqui, é porque quer deixar seu projeto mais seguro, organizado e flexível — e isso é excelente. Vamos juntos aprender como configurar o arquivo .env no seu projeto hospedado no VPS, com calma, passo a passo. Não se preocupe: não precisa ser expert. Aqui, todo mundo começa do zero. 💛

Dica do Sensei: O arquivo .env é como um "segredo pessoal" do seu projeto — ele guarda informações sensíveis (como senhas, chaves de API, URLs de banco de dados) sem deixá-las visíveis no código. Isso evita riscos de segurança!

Antes de começar: entenda o que é o VPS na GeHost

Seu projeto está hospedado em um VPS (servidor virtual) da GeHost. Isso significa que você tem mais controle do que em uma hospedagem tradicional — como se tivesse um "quarto" no servidor, só seu. Com isso, você pode instalar ferramentas, configurar servidores, e sim, gerenciar arquivos como o .env com liberdade.

⚠️ Importante: mesmo com controle, não é permitido acessar o sistema como root ou alterar configurações do sistema sem autorização. Siga os passos com cuidado — e se tiver dúvidas, o suporte da GeHost está aí pra ajudar!

Passo a passo: como configurar o .env no seu projeto

1. Acesse o painel do cliente

   Entre no seu painel em painel.gehost.com.br. Use seu e-mail e senha de acesso.

2. Encontre o acesso ao servidor (SSH)

   No painel, procure por "Acesso SSH" ou "Terminal". Seu plano inclui acesso via SSH, que é o caminho para entrar no servidor e manipular arquivos diretamente.

   ⚠️ Não use o cPanel para editar o .env diretamente — ele é feito para arquivos no diretório público, e o .env deve ser protegido.

3. Conecte-se ao servidor via SSH

   Use um cliente SSH como Putty (Windows), Terminal (macOS/Linux) ou Termius. Digite o comando:

   ssh usuario@seu-servidor.com.br

   Substitua usuario pelo seu nome de usuário no servidor (geralmente é o nome da conta no cPanel) e seu-servidor.com.br pelo domínio ou IP fornecido no painel.

4. Localize a pasta do seu projeto

   Depois de logado, navegue até a pasta onde seu projeto está instalado. Normalmente, isso é dentro de /home/usuario/public_html ou em uma subpasta como /home/usuario/projetos/seu-site.

   Use o comando:

   cd /home/usuario/public_html/seu-projeto

   Substitua os nomes pelos seus reais.

5. Crie o arquivo .env

   Use o editor de texto nano (leve e fácil) para criar o arquivo:

   nano .env

   Isso abrirá um editor de texto no terminal. Agora, digite suas variáveis. Exemplo:

   DB_HOST=localhost
   DB_NAME=meu_banco
   DB_USER=usuario_banco
   DB_PASS=senha_segura
   API_KEY=chave123abc
   

   Salve o arquivo com Ctrl + O, depois Enter. Saia com Ctrl + X.

6. Proteja o arquivo .env

   Arquivos como .env não devem ser acessíveis pela internet. Use o comando para remover permissões de leitura para outros:

   chmod 600 .env

   Isso garante que só você (o dono do arquivo) possa vê-lo.

7. Configure seu código para ler o .env

   Dependendo da linguagem do seu projeto (Node.js, PHP, Python etc.), você precisará de uma biblioteca para ler o arquivo.

   • Node.js: use dotenv — instale com npm install dotenv e importe no início do código com require('dotenv').config();
   • PHP: use phpdotenv ou crie um script simples para carregar as variáveis.
   • Python: use python-dotenv — instale com pip install python-dotenv.

   Depois disso, seu código poderá acessar as variáveis como process.env.DB_HOST (Node) ou os.getenv("DB_HOST") (Python).

8. Teste o projeto

   Reinicie seu servidor ou aplicação e veja se tudo funciona. Se o erro for sobre "variável não definida", verifique se o arquivo .env está no lugar certo e se o nome da variável está escrito exatamente como no arquivo.

Imagens que te ajudam a visualizar

Como você está manipulando arquivos no servidor, o acesso via SSH é essencial. Veja como o terminal pode parecer:

Se precisar de ajuda com o SSH, o painel do cliente tem um guia interno com os dados de acesso. Não se preocupe — você não está sozinho.

Dicas finais do Sensei

• Nunca suba o .env para o GitHub — isso é um erro comum. Use .gitignore para impedir que ele seja enviado.
• Use nomes claros para as variáveis, como DB_HOST ou MAIL_API_KEY, para facilitar a leitura.
• Evite deixar senhas no código — sempre use o .env para isso.
• Se algo não funcionar, verifique os logs do seu aplicativo ou peça ajuda ao suporte da GeHost.

Leve do Sensei: Segurança não é um luxo — é uma obrigação. O .env é seu primeiro escudo. Cuide dele como cuida de um segredo bem guardado. 🌟

Se precisar de ajuda, basta entrar em contato com o suporte da GeHost. Estamos aqui, com carinho, para te ajudar a construir o seu projeto com confiança.

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