Como configurar variáveis de ambiente permanentes no seu VPS imprimir

Como configurar variáveis de ambiente permanentes na sua hospedagem

Oi! Aqui é a Sensei da GeHost. 🌱 Se você chegou até aqui, provavelmente está rodando um script, uma aplicação Node.js ou uma automação que precisa guardar uma informação sensível — tipo uma chave de API, uma senha de banco de dados ou uma configuração — sem deixar isso "hardcoded" (escrito direto) no código. É exatamente pra isso que servem as variáveis de ambiente. Vamos configurar isso juntos, com calma, passo a passo.

O que são variáveis de ambiente (e por que usar)

Pense nelas como "post-its" que o sistema operacional guarda na memória e qualquer programa pode consultar. Em vez de escrever senha = "123456" dentro do seu código, você escreve senha = process.env.MINHA_SENHA e define o valor real fora do código, no ambiente do servidor. Isso deixa seu projeto mais seguro e mais fácil de mudar sem precisar editar arquivos toda hora.

Dica da Sensei: nunca coloque senhas ou chaves de API direto no código que vai pro GitHub ou pro public_html. Se o repositório for público (ou vazar), qualquer pessoa pode ler. Variável de ambiente resolve isso.

Antes de começar

• Verifique no seu painel do cliente (painel.gehost.com.br) se o acesso SSH está habilitado para a sua hospedagem — nem todo plano tem esse recurso ativado por padrão, então confirme por lá ou com o suporte.
• Tenha em mãos um cliente de terminal (no Windows, o PowerShell ou o PuTTY funcionam bem; no Mac/Linux, o Terminal já vem pronto).
• Saiba qual é o seu usuário de acesso — os dados de conexão ficam disponíveis no seu painel.

Passo 1: Conectando via SSH

1. Abra o terminal do seu computador.
2. Digite o comando de conexão que você recebeu no painel (algo no formato ssh seu_usuario@seu-dominio.com.br), substituindo pelos seus dados reais.
3. Informe a senha quando solicitado. Se tudo der certo, você verá o "prompt" do servidor esperando comandos.

Passo 2: criando a variável de forma permanente

Se você usar o comando export MINHA_VARIAVEL=valor direto no terminal, ela funciona — mas some assim que você fechar a sessão SSH. Para deixá-la permanente, o segredo é salvá-la em um arquivo de configuração que roda toda vez que você entra no servidor: o ~/.bashrc (ou, em alguns ambientes, o ~/.bash_profile).

1. Ainda conectado via SSH, abra o arquivo com um editor de texto simples, por exemplo: nano ~/.bashrc
2. Vá até o final do arquivo e adicione uma linha para cada variável que você precisa, assim: export MINHA_VARIAVEL="valor-aqui"
3. Salve o arquivo (no nano, é Ctrl+O para gravar e Ctrl+X para sair).
4. Para a variável valer na sessão atual sem precisar reconectar, rode: source ~/.bashrc
5. Teste se funcionou digitando: echo $MINHA_VARIAVEL — se aparecer o valor que você definiu, prontinho! 🎉

Dica da Sensei: a partir de agora, toda nova sessão SSH (e scripts que rodam com esse mesmo usuário) vão enxergar essas variáveis automaticamente, porque o ~/.bashrc é lido sempre que uma sessão começa.

Se sua aplicação for Node.js: use o "Configurar App Node.js" do cPanel

Se o seu projeto é uma aplicação Node.js gerenciada pelo cPanel, existe um jeito ainda mais simples: dentro da ferramenta de configuração de app Node.js do próprio painel há uma seção específica para adicionar variáveis de ambiente pela interface gráfica, sem precisar mexer em arquivo nenhum. É uma ótima opção se você quer manter tudo organizado num só lugar.

Não tem acesso a terminal ainda? Dá pra editar pelo Gerenciador de Arquivos

Se o SSH da sua hospedagem ainda não foi liberado, você também pode editar o ~/.bashrc (ou o arquivo de configuração da sua aplicação) diretamente pelo Gerenciador de Arquivos do cPanel: ative a opção para mostrar arquivos ocultos, localize o arquivo na raiz da sua conta e edite pelo editor de código embutido.

Erros comuns (e como evitar)

• "Minha variável some quando fecho o terminal": você provavelmente usou só export direto no terminal, sem salvar no ~/.bashrc. Refaça o Passo 2.
• "Editei o arquivo mas não mudou nada": lembre de rodar source ~/.bashrc depois de salvar, ou simplesmente abra uma nova sessão SSH.
• "Coloquei espaços em volta do sinal de igual": em export, não pode ter espaço antes ou depois do =. O certo é export NOME=valor, sem espaços.

Precisa de uma mãozinha?

Se travar em algum passo, sem problema — fala com a nossa equipe de suporte pelo painel do cliente que a gente te ajuda a configurar certinho. 💛