Pular para o conteúdo
Documentação

Serviços em segundo plano

Crie serviços que ficam sempre rodando, como filas do Laravel, Horizon, consumidores do Magento e aplicações Node.js ou Python, usando os modelos prontos.

R Regis Manze 20/11/2026 4 min de leitura

A tela Servicos cria processos que ficam rodando o tempo todo na sua conta e voltam sozinhos se pararem. Use para filas do Laravel, Horizon, WebSockets, consumidores de fila do Magento e aplicações Node.js ou Python.

Diferença em relação ao cron: o cron roda um comando em horários definidos e termina; o serviço fica ligado continuamente.

Lista de serviços

Coluna O que mostra
Status Ativo, Parado ou Falhou
Nome Nome curto do serviço. A etiqueta desabilitado indica que ele não sobe sozinho quando o servidor reinicia
Descricao Texto livre que você definiu
Comando O comando executado
Acoes Reiniciar, Parar ou Iniciar, Ver Logs e Excluir

Modelos prontos (Templates Rapidos)

Clique em um modelo para abrir o formulário já preenchido com o caminho da sua conta:

Modelo O que roda
Laravel Queue artisan queue:work na fila default
Laravel Scheduler artisan schedule:run a cada 60 segundos (alternativa ao cron)
Laravel Horizon artisan horizon
Laravel Reverb artisan reverb:start (WebSockets)
Magento Consumer bin/magento queue:consumers:start async.operations.all
Node.js App node public_html/server.js
Python App python3 public_html/app.py

Os modelos supõem que o projeto está em public_html. Ajuste o caminho no Comando se o seu estiver em outra pasta.

Criar um serviço

  1. Clique em Novo Servico ou em um dos Templates Rapidos.
  2. Preencha o formulário:
Campo Como preencher
Nome do Servico Identificador único, só letras minúsculas, números, - e _ (até 40 caracteres). Ex.: queue-default
Descricao Texto para você reconhecer o serviço
Comando Comando completo, com caminhos absolutos. Não pode começar com +, !, @, - ou : (o painel recusa com "O comando nao pode comecar com + ! @ - ou :.")
Versao PHP Ao trocar, o painel ajusta o caminho do PHP no comando. Escolha Nenhum (nao usa PHP) para Node.js ou Python
Restart Sempre (always), Apenas em falha (on-failure) ou Nunca (no)
Restart delay (seg) Espera antes de religar, de 1 a 300 segundos
  1. Clique em Criar e Iniciar.

O serviço roda com o seu usuário, dentro da pasta public_html, sem poder ganhar privilégios extras (NoNewPrivileges), e já fica configurado para subir junto com o servidor.

A saída do programa vai sempre para ~/logs/<nome>.log e os erros para ~/logs/<nome>-error.log. Não há mais campos para escolher outros arquivos.

Passo a passo: worker de fila do Laravel

  1. Em Templates Rapidos, clique em Laravel Queue.
  2. Confira a Versao PHP (a mesma do seu domínio).
  3. Se usar outra fila além de default, ajuste --queue=default no Comando (ex.: --queue=high,default).
  4. Clique em Criar e Iniciar.
  5. Confira se o Status ficou Ativo.

Atenção: o worker carrega o código na memória. Depois de cada deploy, clique em Reiniciar no serviço para ele usar o código novo.

Passo a passo: consumidor de fila do Magento

  1. Clique em Magento Consumer. O Comando já vem com o consumidor async.operations.all:

    /usr/bin/php8.3 /home/cliente/public_html/bin/magento queue:consumers:start async.operations.all --max-messages=1000
    
  2. Para outro consumidor, troque async.operations.all no Comando pelo nome dele.

  3. Mude o Nome do Servico para algo como magento-async.

  4. Clique em Criar e Iniciar. Crie um serviço para cada consumidor de que a loja precisa.

Passo a passo: aplicação Node.js

  1. Clique em Node.js App.
  2. Ajuste o Comando para o arquivo de entrada da sua aplicação (ex.: /usr/bin/node /home/cliente/public_html/dist/server.js).
  3. Em Versao PHP, escolha Nenhum (nao usa PHP).
  4. Clique em Criar e Iniciar.

Dica: para o domínio entregar a aplicação Node.js ou o Reverb, o servidor web precisa encaminhar o tráfego para a porta da aplicação. Combine a porta com o administrador antes.

Acompanhar e corrigir

  • Ver Logs mostra as últimas 100 linhas do registro do sistema para o serviço: quando iniciou, parou ou falhou.
  • A saída do seu programa vai para ~/logs/<nome>.log e ~/logs/<nome>-error.log. Esses arquivos são somente leitura para você (veja Logs dos seus domínios). Leia-os em Meus Arquivos ou no Terminal com tail -f ~/logs/queue-default-error.log.
  • Se o status ficar Falhou, teste o mesmo comando no Terminal para ver o erro.

Para mudar o comando de um serviço existente, exclua-o e crie de novo com os novos dados.

Atenção: Excluir para o serviço e apaga a configuração dele. Os arquivos de log permanecem.

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!