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

Acesse o painel do cliente

Entre no seu painel em painel.gehost.com.br. Use seu e-mail e senha de acesso.
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.
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.
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.
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.
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.
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).
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)*

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