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
- Com o estado Atualizacao disponivel, clique em Atualizar agora.
- Confirme a mensagem Atualizar o miniProxy agora? O painel sera reiniciado ao final.
- 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.