Pular para o conteúdo
Documentação

O que é o miniProxy

Visão geral do miniProxy, o painel web que gerencia o HAProxy na frente das lojas e sites, e o mapa de todas as telas do menu.

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

O miniProxy é um painel web para administrar um servidor HAProxy que fica na frente das suas lojas e sites. Em vez de editar o haproxy.cfg na mão, você cadastra domínios, backends, certificados e regras de segurança pela interface, e o painel gera a configuração, valida com haproxy -c e recarrega o HAProxy.

Como ele se encaixa na sua infraestrutura

O HAProxy recebe todo o tráfego público (portas 80 e 443) e encaminha cada requisição para o servidor certo, de acordo com o domínio acessado:

Visitante ──> HAProxy (este servidor, :80/:443) ──> backend da loja.exemplo.com.br (ex.: 192.0.2.10:80)
                     │                          └─> backend do site.exemplo.com.br (ex.: 192.0.2.20:80)
                     └── painel miniProxy (:5000/haproxy-admin/)

Com isso, o HAProxy concentra em um só lugar:

  • SSL: os certificados Let's Encrypt ficam no HAProxy, e os backends podem responder em HTTP simples.
  • Roteamento: cada domínio (e seus aliases) aponta para um backend com um ou mais servidores.
  • Proteção: blocklist, regras por país/path/User-Agent, limite de requisições, WAF OWASP, paths isca e listas de ameaças são aplicados antes de a requisição chegar à aplicação.
  • Visibilidade: logs de acesso por domínio, gráficos de tráfego e saúde dos domínios.

O que o painel gerencia

Item Onde fica
Configuração do HAProxy /etc/haproxy/haproxy.cfg (com backup automático a cada alteração em /etc/haproxy/backups/)
Certificados /etc/haproxy/certs/ (gerados pelo certbot)
Configurações do painel, listas e estados arquivos em /etc/haproxy/
Usuários e métricas banco SQLite /opt/haproxy-admin/stats.db
Serviço do painel haproxy-admin (systemd)

Dica: toda alteração feita pelo painel é validada antes de ser gravada. Se a configuração resultante for inválida, nada é aplicado e a tela mostra o erro do haproxy -c.

Mapa do menu

O menu lateral é dividido em blocos. Abaixo, uma linha por tela.

Dashboard — resumo do servidor: estado do HAProxy, tráfego agora, backends, gráficos e logs ao vivo. Veja Acesso e Dashboard.

Infraestrutura

Tela Para que serve
Trafego por dominio Requisições, status HTTP, latência, banda e visitantes online por domínio, com histórico.
Backends Cria e edita backends e seus servidores (balanceamento, sessão fixa, health check, HTTPS no backend).
Dominios Cadastra domínios e aliases, liga cada um a um backend, restringe acesso por IP, ativa WAF e Cloudflare por domínio.
Saude (uptime) Testa cada domínio periodicamente e mostra status, latência, uptime e última queda.
Portas TCP Encaminha portas não HTTP (MySQL, SSH, FTP, Redis...) para servidores internos.
Cache e persistencia Cache de arquivos estáticos, manter as tabelas (bloqueios, limites) no reload, health-check passivo e subida gradual dos servidores.
Diagnostico Confere DNS, certificado e saúde de cada host configurado e aponta problemas.
Certificados SSL Gera, renova e remove certificados Let's Encrypt (inclusive por DNS-01 via Cloudflare).
Cloudflare Ajustes globais para domínios atrás do Cloudflare: faixas de IP, IP real do visitante e bloqueio de acesso direto.

Segurança

Tela Para que serve
Visao geral Reúne os contadores de proteção, top IPs bloqueados, domínios/paths com 403 e eventos recentes.
WAF Firewall de aplicação OWASP (Coraza): política, exclusões por domínio, eventos e triagem de falso-positivo.
Regras Regras por domínio (Condicoes, Listas de UA, Listas de dominio, Whitelist, Blocklist global, Limite por dominio).
Protecao avancada Proteção por comportamento, desafio ("modo sob ataque") por domínio e cabeçalhos de segurança.
Investigar IP Mostra o que um IP fez nos logs e permite bloqueá-lo.
Paths isca Prende por um tempo quem acessa caminhos típicos de scanner (/.env, /wp-login.php...).
Listas de ameacas Bloqueio por listas públicas de IPs maliciosos, atualizadas automaticamente.
GeoIP Escolhe a fonte das faixas de IP por país (ipdeny ou MaxMind GeoLite2) usadas nas regras por país.
Trafego & limites Requisições recentes por IP e bloqueio temporário de IPs com duração e motivo.
Bloqueios Histórico de ações de bloqueio e eventos 403 (requisições barradas) ao vivo.

Sistema

O bloco Sistema fica recolhido; clique no título para abrir.

Tela Para que serve
Logs Visualizador de todos os logs do servidor, download e retenção. Veja Logs.
Configs Identificação do painel, tempo de login, retenção, alertas, gateway de saída e parâmetros globais do HAProxy. Veja Configs.
Config Raw Editor do haproxy.cfg com validação antes de salvar. Veja Config Raw e Backups.
Backups Versões anteriores do haproxy.cfg para baixar ou restaurar.
Usuarios Contas de acesso ao painel. Veja Usuários.
Atualizacao Verifica e aplica novas versões do miniProxy. Veja Atualização.

No rodapé do menu ficam Sair, o botão Tema claro / Tema escuro e a versão instalada do painel (ex.: v2.36.1).

Próximo passo

Instale o miniProxy em um servidor novo seguindo Instalaçã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!