Como configurar variáveis de ambiente no seu VPS para uma aplicação Node.js

Como configurar variáveis de ambiente no seu VPS para uma aplicação Node.js

Olá, viajante do código! Seja bem-vindo ao seu guia de configuração de variáveis de ambiente no VPS com a GeHost. Aqui, você vai aprender, passo a passo, como preparar seu ambiente para que sua aplicação Node.js funcione com segurança e flexibilidade. Não se preocupe — mesmo que seja sua primeira vez com SSH, eu estou aqui com você, como um verdadeiro Sensei da GeHost.

O que são variáveis de ambiente?

Imagine que você tem uma aplicação que precisa de senhas, chaves de API ou caminhos de arquivos. Em vez de deixar essas informações expostas no código (o que é perigoso!), você as guarda em variáveis de ambiente. É como um cofrinho secreto no seu servidor — só quem tem acesso pode ver o que está dentro.

Dica do Sensei: Nunca coloque senhas ou chaves de API diretamente no código-fonte. Isso é como deixar a porta da sua casa aberta para o mundo.

Pré-requisitos

Antes de começar, verifique se você tem:

• Seu acesso SSH ao VPS (gerado no painel da GeHost).
• Seu usuário e senha para SSH (não confunda com cPanel).
• Seu projeto Node.js já enviado ao servidor (via FTP, SCP ou Git).
• Conhecimento básico de terminal (não se preocupe, vamos fazer tudo com calma).

Passo a passo: Configurando variáveis de ambiente no VPS

1. Conecte-se ao seu VPS via SSH

   Abra seu terminal (no Linux/Mac) ou o Putty (no Windows), e digite:

   ssh seu_usuario@seu_ip_do_vps

   Substitua seu_usuario pelo nome de usuário fornecido pela GeHost e seu_ip_do_vps pelo endereço IP do seu servidor (disponível no painel).

2. Localize a pasta do seu projeto

   Use o comando ls para ver as pastas. Geralmente, seus arquivos ficam em /home/seu_usuario/public_html ou em uma pasta específica como /home/seu_usuario/app. Navegue até ela com:

   cd /home/seu_usuario/app

   Se não tiver certeza, use ls para listar e identificar a pasta correta.

3. Crie um arquivo de variáveis de ambiente

   Em sua pasta de aplicação, crie um arquivo chamado .env:

   touch .env

   Abra o arquivo com um editor de texto como nano:

   nano .env

   Adicione suas variáveis no formato CHAVE=valor. Exemplo:

         NODE_ENV=production
         DATABASE_URL=postgres://usuario:senha@localhost:5432/meu_banco
         JWT_SECRET=chave_segura_muito_longa
       

   Pressione Ctrl + O para salvar, depois Enter, e Ctrl + X para sair.

4. Instale o pacote dotenv (se necessário)

   Se sua aplicação Node.js não estiver usando o pacote dotenv, instale-o:

   npm install dotenv

   Depois, no início do seu arquivo principal (ex: server.js ou app.js), adicione:

   require('dotenv').config();

   Isso permite que o Node.js leia as variáveis do arquivo .env.

5. Teste o ambiente

   Para garantir que tudo está funcionando, crie um pequeno script de teste. Crie um arquivo chamado test-env.js:

   touch test-env.js

   Abra com nano e adicione:

         const dotenv = require('dotenv');
         dotenv.config();
   
         console.log('NODE_ENV:', process.env.NODE_ENV);
         console.log('JWT_SECRET:', process.env.JWT_SECRET);
       

   Execute com:

   node test-env.js

   Se aparecerem os valores corretos, parabéns! Você configurou tudo certo.

6. Proteja o arquivo .env

   Para evitar que o arquivo seja acessado por outros, configure permissões:

   chmod 600 .env

   Isso garante que apenas o dono do arquivo pode ler ou escrever nele.

7. Reinicie sua aplicação

   Se estiver usando um processo como pm2, reinicie com:

   pm2 restart seu_nome_do_processo

   Se não estiver usando pm2, reinicie o servidor Node.js manualmente.

Importante: Segurança e boas práticas

• Nunca comite o arquivo .env no Git. Use .gitignore para excluí-lo.
• Evite usar variáveis de ambiente com valores muito simples ou previsíveis.
• Se estiver usando um sistema de CI/CD, configure as variáveis no ambiente de deploy, não no código.

Leitura do Sensei: Um servidor bem configurado é como um jardim bem cuidado — cada planta tem seu lugar, e o segredo está na atenção ao detalhe.

Pronto! Você está no caminho certo.

Com isso, sua aplicação Node.js agora está usando variáveis de ambiente com segurança. Não se esqueça de que a GeHost está aqui para te ajudar — se precisar, entre em contato com nosso suporte (disponível por 30 dias após a entrega).

Se quiser, você pode revisar seu plano no painel do cliente para verificar os recursos disponíveis para seu VPS.

Até a próxima, e lembre-se: o código é arte — e o ambiente é seu palco.