Como configurar o Supervisor para manter um processo Node.js sempre no ar
Olá, viajante da web! Se você está aqui, provavelmente já tem um aplicativo Node.js rodando no seu servidor da GeHost e quer garantir que ele nunca pare — nem por um instante. Que bom que você pensou nisso! 🌟
No mundo da hospedagem, um processo pode parar por motivos como reinicialização do servidor, erro de código ou até uma falha momentânea na rede. É aí que entra o Supervisor: uma ferramenta poderosa que monitora seu processo e o reinicia automaticamente, como um guardião digital.
Passo a passo para configurar o Supervisor no seu servidor GeHost
Antes de começar, lembre-se: todos os passos aqui são feitos via SSH (acesso por terminal), que está disponível em todos os planos GeHost com acesso completo ao servidor (como os planos Básico, Médio e Plus).
-
Conecte-se ao servidor via SSH
Use um cliente como Putty (Windows) ou o terminal nativo (Linux/Mac). Acesse o painel do cliente em painel.gehost.com.br e encontre as credenciais SSH na seção "Acesso SSH".
Se não tiver acesso SSH ativado, entre em contato com o suporte — é só um clique no painel!
-
Instale o Supervisor
Abra o terminal e execute este comando:
sudo apt update && sudo apt install -y supervisor
Esse comando atualiza o sistema e instala o Supervisor. Ele será usado para gerenciar seu processo Node.js.
-
Crie um arquivo de configuração para seu processo
O Supervisor precisa saber o que rodar, onde e como reiniciar. Vamos criar um arquivo de configuração:
sudo nano /etc/supervisor/conf.d/seu-app.conf
Substitua
seu-app.confpor um nome que lembre seu projeto (ex:blog-node.conf).Depois, cole o seguinte conteúdo no editor:
[program:meu-node-app]
command=node /home/usuario/public_html/seu-projeto/app.js
directory=/home/usuario/public_html/seu-projeto
user=usuario
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/home/usuario/logs/app.logAtenção: Substitua
usuariopelo seu nome de usuário do cPanel eseu-projetopela pasta onde está seu projeto Node.js. O caminho do arquivoapp.jsdeve ser exato. -
Salve e feche o arquivo
No Nano (editor de texto), pressione Ctrl + O para salvar, depois Enter. Depois, Ctrl + X para sair.
-
Atualize o Supervisor
Execute este comando para que o Supervisor leia a nova configuração:
sudo supervisorctl reread
Depois, carregue as novas configurações:
sudo supervisorctl update
-
Inicie seu processo
Use este comando para iniciar seu aplicativo:
sudo supervisorctl start meu-node-app
Substitua
meu-node-apppelo nome que você usou no arquivo de configuração. -
Verifique o status
Para ver se está rodando, execute:
sudo supervisorctl status
Se tudo estiver certo, você verá algo como:
meu-node-app RUNNING pid 1234, uptime 0:05:30
Parabéns! Seu app está no ar e será reiniciado automaticamente se parar.
Dicas práticas para não se perder
- Use o cPanel para localizar sua pasta: Acesse o painel → Arquivos → Gerenciador de Arquivos. Lá você encontra a pasta
public_htmlcom o caminho exato do seu projeto. - Logs são amigos: Se algo der errado, veja o arquivo
app.logcriado no diretóriologs. Ele mostra erros do seu código ou falhas de inicialização. - Reinicie o Supervisor com cuidado: Se precisar reiniciar o serviço, use
sudo supervisorctl restart meu-node-app— nunca o serviço inteiro, a menos que precise.
Importante: Todo o processo descrito aqui é compatível com os planos GeHost que oferecem acesso SSH. Se você não tem acesso, consulte seu plano no painel ou entre em contato com o suporte.
Pronto! Seu app está de guarda 24/7
Com o Supervisor configurado, seu aplicativo Node.js agora é resiliente. Ele se reinicia sozinho, mesmo que o servidor reinicie ou o processo falhe. É como ter um amigo que nunca dorme ao seu lado, cuidando do seu projeto.
Se precisar de ajuda, lembre-se: o suporte da GeHost está aqui para você — e ele é grátis por 30 dias após a entrega. Basta entrar no painel e abrir um chamado.
Até a próxima, e que seu código sempre esteja no ar!