Como configurar variáveis de ambiente para uma aplicação rodando no VPS imprimir

Como configurar variáveis de ambiente para sua aplicação no servidor

Oi! Eu sou a Sensei da GeHost 🌱 e hoje vou te ensinar, com calma e sem juridiquês, como configurar as chamadas variáveis de ambiente para uma aplicação que roda no seu servidor via SSH. Pode parecer assunto de gente avançada — e é mesmo! — mas prometo explicar cada passo como se estivéssemos tomando um café juntos.

O que são variáveis de ambiente (e por que elas importam)?

Pense nas variáveis de ambiente como post-its de configuração que ficam colados no ambiente do servidor, fora do código da sua aplicação. Coisas como chave de API, senha de banco de dados, modo de execução (produção ou desenvolvimento) e outras informações sensíveis costumam morar ali — em vez de ficarem escritas "duras" no código.

As vantagens de fazer isso direito:

• Segurança: dados sensíveis não ficam expostos dentro do código-fonte.
• Organização: você troca uma configuração sem precisar editar e reenviar arquivos de código.
• Boas práticas: é o jeito recomendado pela grande maioria dos frameworks modernos (Node.js, PHP, Python etc.).

💡 Dica da Sensei: nunca coloque senhas ou chaves de API direto no código que você sobe para o Git ou para o servidor. Se um dia esse código vazar, tudo que estiver "hardcoded" vaza junto.

Passo 1 — Acesse seu servidor via SSH

1. Abra o terminal do seu computador (ou um cliente SSH, como PuTTY, se você usa Windows).
2. Conecte-se com o comando que você já usa normalmente para acessar sua conta, algo como:
   ssh seu_usuario@seu-dominio.com.br
3. Se não tiver certeza do usuário, host ou porta de acesso SSH, confira no painel.gehost.com.br ou fale com o nosso suporte — cada conta tem seus próprios dados de acesso.

Passo 2 — Escolha onde vão morar suas variáveis

Existem alguns jeitos comuns de configurar variáveis de ambiente. Vou te mostrar os mais usados, do mais simples ao mais "definitivo":

Opção A: Arquivo .env na raiz da aplicação

É o método mais popular, principalmente em projetos Node.js, PHP (Laravel) e Python (Django/Flask). Você cria um arquivo chamado .env dentro da pasta da sua aplicação, com uma variável por linha:

DB_HOST=localhost
DB_USER=meu_usuario
DB_PASS=minha_senha_segura
APP_ENV=production

Você pode criar e editar esse arquivo direto pelo terminal SSH, usando um editor como nano:

1. Navegue até a pasta da sua aplicação: cd ~/public_html/minha-app (ajuste o caminho para o seu caso).
2. Crie/edite o arquivo: nano .env
3. Digite suas variáveis, uma por linha, no formato NOME=valor.
4. Salve com Ctrl+O, depois Enter, e saia com Ctrl+X.

Se preferir, também é possível criar e editar esse arquivo pelo Gerenciador de Arquivos do cPanel, ativando a opção de mostrar arquivos ocultos:

⚠️ Atenção: proteja o arquivo .env para que só o dono consiga lê-lo, com o comando chmod 600 .env. E, se seu projeto usa Git, adicione o .env ao arquivo .gitignore para que ele nunca seja enviado a repositórios públicos.

Opção B: Exportar direto no shell (temporário)

Útil para testes rápidos, mas atenção: essa variável some quando você fecha a sessão SSH.

export NOME_DA_VARIAVEL=valor

Para conferir se funcionou, use:

echo $NOME_DA_VARIAVEL

Opção C: Interface de aplicações do cPanel (quando disponível)

Se sua hospedagem tiver a ferramenta de configuração de aplicações (como "Setup Node.js App") disponível no cPanel, ela costuma trazer um campo próprio para cadastrar variáveis de ambiente por uma tela visual — sem precisar mexer em arquivo nenhum. Se você tiver essa ferramenta disponível, prefira usá-la: ela já integra a variável ao processo da aplicação automaticamente.

Passo 3 — Faça sua aplicação ler as variáveis

De nada adianta criar o arquivo se a sua aplicação não sabe que ele existe! Isso depende da linguagem/framework:

• Node.js: normalmente se usa um pacote como dotenv, carregado no início do código.
• PHP (Laravel): o próprio framework já lê o .env automaticamente.
• Python: pacotes como python-dotenv cumprem esse papel.

Se você não tem certeza de como sua aplicação específica lê essas variáveis, vale checar a documentação do framework que você está usando — cada um tem seu jeitinho.

Passo 4 — Reinicie a aplicação

Depois de criar ou alterar variáveis, é preciso reiniciar o processo da aplicação para que as mudanças tenham efeito. Isso pode ser feito reiniciando o processo pelo terminal (dependendo de como sua aplicação está configurada para rodar) ou pela própria interface de gerenciamento de aplicações do cPanel, se você utiliza uma.

Boas práticas para fechar com chave de ouro

• Nunca compartilhe o conteúdo do seu .env por e-mail, chat ou print.
• Use senhas e chaves diferentes entre ambiente de teste e produção.
• Revise periodicamente quais variáveis ainda são realmente usadas — arquivo de configuração "bagunçado" é fonte de dor de cabeça.

🌱 Sensei diz: se em algum momento você se sentir inseguro mexendo em SSH ou tiver dúvida sobre o caminho da sua aplicação, chame nosso suporte. É melhor perguntar antes do que reverter um problema depois!

Ficou com alguma dúvida nesse processo? Nosso time está à disposição pelo painel do cliente para te ajudar em qualquer etapa. 💚