Pular para o conteúdo
Documentação

Atualização

Como verificar se há versão nova do miniProxy, atualizar pelo painel a partir do minirepo e concluir o reinício do serviço.

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

A tela Atualizacao verifica se existe uma versão nova do miniProxy no minirepo e instala com um clique, sem acessar o servidor por SSH. Ela fica em Sistema > Atualizacao, e o topo mostra a versao atual em uso.

A atualização troca apenas os arquivos do painel. O HAProxy continua rodando e atendendo os sites durante todo o processo.

Verificar se há atualização

Ao abrir a tela, o painel consulta o minirepo automaticamente (enviando a versão atual e o hostname) e compara as versões. O cartão Versao mostra um destes estados:

Estado Significado
🔵 Atualizacao disponivel — vA → vB Há versão mais nova. O botão Atualizar agora fica habilitado.
🟢 Atualizado Você já está na versão mais recente.
🟠 Nao verificavel O minirepo não respondeu com uma versão. A mensagem diz o motivo, por exemplo IP nao liberado no minirepo (403).

Clique em Verificar para consultar de novo.

Atenção: o minirepo só atende IPs liberados. Se aparecer IP nao liberado no minirepo (403)., peça a liberação do IP público deste servidor antes de tentar atualizar.

Atualizar

  1. Com o estado Atualizacao disponivel, clique em Atualizar agora.
  2. Confirme a mensagem Atualizar o miniProxy agora? O painel sera reiniciado ao final.
  3. Acompanhe o cartão Progresso:
    • Baixando pacote...
    • Aplicando atualizacao (rsync, preservando dados locais)...
    • Arquivos atualizados. Agendando reinicio do servico (3s)...
    • Concluido — o painel reinicia e a página recarrega sozinha em alguns segundos.

Se algo falhar, a linha ERRO: mostra o motivo (download, pacote inválido, rsync) e o painel não é reiniciado. Se o erro ocorrer no download, nada foi alterado.

O que é preservado

A atualização substitui os arquivos do programa em /opt/haproxy-admin, mas mantém:

  • o banco stats.db (usuários, métricas e históricos);
  • o .env (endereço e porta do painel);
  • a chave de sessão (.secret_key), então ninguém é deslogado por causa da chave;
  • o virtualenv Python (venv/).

As configurações em /etc/haproxy/ (o haproxy.cfg, listas, configurações do painel, alertas) ficam fora da pasta do programa e não são tocadas.

Reinício pendente

Se os arquivos novos já estão em disco mas o serviço ainda roda a versão anterior (por exemplo, o reinício automático falhou), a tela mostra:

🟠 Atualizacao aplicada em disco, mas o servico ainda roda a versao anterior.

com a versão rodando e a versão em disco. Clique em Reiniciar agora e confirme; o navegador recarrega em seguida.

Se nem assim reiniciar, rode no servidor:

systemctl restart haproxy-admin

Configuração (avançado)

O cartão Configuracao (avancado) define de onde vêm as atualizações:

Campo O que informar
URL de versao Endereço que responde a versão mais recente.
URL do pacote (.tar.gz) Endereço do pacote do miniProxy.

Deixe os campos vazios e clique em Salvar para voltar aos endereços padrão do minirepo. Só altere se o suporte indicar outro repositório.

Dica: em ambientes com mais de um proxy, atualize primeiro um servidor de testes e confira as telas principais antes de atualizar os servidores de produção.

Veja também

  • Instalação
  • Logs: fonte Painel miniProxy para ver erros do serviço após a atualização.
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!