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.