Como configurar variáveis de ambiente para uma aplicação em um VPS imprimir

Como configurar variáveis de ambiente para uma aplicação em um VPS

Oi! Aqui é a Sensei da GeHost 🥋 Se você tem uma aplicação rodando em um VPS (seja um sistema em Node.js, Python, PHP ou qualquer outra stack), provavelmente já ouviu falar de "variáveis de ambiente" — e hoje eu vou te ensinar a mexer nelas com tranquilidade, sem medo de quebrar nada.

Variáveis de ambiente são aquelas informações de configuração que a sua aplicação precisa pra funcionar (chave de API, senha de banco de dados, modo de execução etc.), mas que não devem ficar escritas direto no código. Isso deixa seu projeto mais seguro e mais fácil de manter — você troca um valor sem precisar mexer em uma linha sequer do sistema.

💡 Dica da Sensei: nunca coloque senhas, tokens ou chaves de API direto no código-fonte. Se esse código for parar num repositório público (tipo GitHub), qualquer pessoa pode ver — e isso já causou muita dor de cabeça por aí.

1. Acesse seu VPS via SSH

O primeiro passo é entrar no servidor. No seu terminal (Linux/Mac) ou PowerShell/PuTTY (Windows), conecte usando o usuário e o endereço do seu servidor:

1. Abra o terminal;
2. Digite ssh usuario@seu-servidor (troque pelos dados do seu acesso);
3. Informe a senha ou use sua chave SSH, se já tiver configurado uma.

Se você tem dúvida sobre qual usuário ou credencial usar, dá uma olhada no seu contrato ou fale com a gente pelo painel.gehost.com.br — a equipe te ajuda a confirmar isso com segurança.

2. Escolha onde as variáveis vão viver

Existem algumas formas comuns de definir variáveis de ambiente. Vou te mostrar as três mais usadas — escolha a que combina com o seu projeto:

2.1. Arquivo .env (a forma mais popular)

A maioria das aplicações modernas (Node.js, Laravel, Django etc.) usa um arquivo chamado .env na raiz do projeto. Ele funciona assim:

1. Entre na pasta da sua aplicação: cd /caminho/da/sua/aplicacao;
2. Crie (ou edite) o arquivo com nano .env;
3. Adicione uma variável por linha, no formato NOME_DA_VARIAVEL=valor, por exemplo:
   • DATABASE_URL=sua_string_de_conexao
   • API_KEY=sua_chave_secreta
   • APP_ENV=production
4. Salve o arquivo (no nano: Ctrl+O, Enter, depois Ctrl+X pra sair);
5. Verifique se a sua aplicação já usa uma biblioteca pra ler o .env automaticamente (como o "dotenv" no Node.js, ou o suporte nativo do Laravel/Django) — a maioria dos frameworks já vem com isso pronto.

💡 Dica da Sensei: sempre adicione o arquivo .env no seu .gitignore. Assim ele nunca é enviado sem querer pro seu repositório de código — mantendo seus segredos só onde eles devem estar: no servidor.

2.2. Exportando direto no terminal (temporário)

Se você só precisa testar uma variável rapidinho, sem persistir depois de reiniciar o servidor, pode usar o comando export:

1. Digite: export NOME_DA_VARIAVEL=valor;
2. Rode sua aplicação normalmente na mesma sessão do terminal.

Repare que essa variável some assim que você fecha o terminal ou reinicia o servidor — é ótimo pra testes, mas não é a forma ideal pra produção.

2.3. Definindo no serviço (systemd)

Se a sua aplicação roda como um serviço do sistema (systemd), você pode declarar as variáveis direto no arquivo de serviço:

1. Edite o serviço com sudo nano /etc/systemd/system/sua-aplicacao.service;
2. Na seção [Service], adicione uma linha para cada variável: Environment=NOME_DA_VARIAVEL=valor;
3. Salve o arquivo e recarregue as configurações com sudo systemctl daemon-reload;
4. Reinicie o serviço com sudo systemctl restart sua-aplicacao.

3. Reinicie a aplicação

Esse é um passo que muita gente esquece: depois de criar ou alterar uma variável de ambiente, a aplicação precisa ser reiniciada pra "enxergar" o novo valor. Se você usa um gerenciador de processos (como PM2, para Node.js), o comando geralmente é algo como pm2 restart nome-da-aplicacao. Se for um serviço systemd, use o systemctl restart que te mostrei acima.

4. Confira se deu certo

Depois de reiniciar, verifique os logs da sua aplicação pra confirmar que ela subiu sem erros e está lendo as variáveis certinho. Se algo não carregar como esperado, revise:

• Se o nome da variável está exatamente igual ao que o código espera (maiúsculas/minúsculas importam!);
• Se não sobrou espaço em branco antes ou depois do sinal de igual;
• Se o arquivo .env está mesmo na pasta raiz da aplicação;
• Se a aplicação foi realmente reiniciada após a mudança.

💡 Dica da Sensei: guarde uma cópia segura (fora do servidor) das suas variáveis mais importantes, tipo num cofre de senhas. Se um dia precisar reconfigurar do zero, você não fica na mão.

Precisa de uma força?

Se você preferir não mexer direto no terminal, ou travou em algum passo, é só chamar a gente pelo painel.gehost.com.br — toda entrega da GeHost já vem com suporte gratuito por 30 dias, e depois disso a equipe também pode te ajudar sob consulta. Bora deixar sua aplicação rodando redondinha! 🚀