Pular para o conteúdo
Documentação

Instalação

Como instalar o miniProxy em um Debian 13 limpo com o setup.sh, ativar o WAF opcional com o setup-waf.sh, ajustar o .env e fazer o primeiro login.

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

A instalação do miniProxy é feita por um script (setup.sh) que prepara um servidor Debian 13 limpo: instala o HAProxy e o certbot, cria uma configuração base do HAProxy, ajusta o kernel para muitas conexões e sobe o painel como serviço. O WAF OWASP é opcional e tem um script próprio (setup-waf.sh).

Antes de começar

  • Servidor com Debian 13 recém-instalado (o script recusa outras distribuições).
  • Acesso root.
  • As portas 80 e 443 livres e liberadas no firewall da rede, apontadas para este servidor.
  • Os arquivos do projeto do miniProxy (pasta com app.py, templates/, static/, setup.sh).

Atenção: o setup.sh substitui o /etc/haproxy/haproxy.cfg por uma configuração base. Na primeira execução ele guarda o arquivo original em /etc/haproxy/haproxy.cfg.original, mas nas seguintes não. Não rode o script em um servidor que já atende tráfego: para atualizar o painel use a tela Atualizacao (veja Atualização).

Instalar com o setup.sh

  1. Copie a pasta do projeto para o servidor. O local final é /opt/haproxy-admin; se você rodar o script de outra pasta, ele copia app.py, templates/ e static/ para lá.
  2. Entre na pasta e rode o script como root:
cd /opt/haproxy-admin
chmod +x setup.sh
./setup.sh
  1. Aguarde o fim. O script mostra a seção Validacao com o estado dos serviços e, ao final, o endereço do painel e o login inicial.

O que o script faz

Etapa O que acontece
Pacotes Instala haproxy, certbot, python3, python3-venv, python3-pip, socat, curl e rsync.
Diretórios Cria /etc/haproxy/certs e /etc/haproxy/backups.
Python Cria o virtualenv em /opt/haproxy-admin/venv e instala Flask e bcrypt.
Certificado padrão Gera um certificado autoassinado em /etc/haproxy/certs/default.pem (usado até existir um certificado real).
haproxy.cfg base Frontend HTTP (ft_http, porta 80) que redireciona para HTTPS e atende o desafio do Let's Encrypt; frontend HTTPS (ft_https, porta 443) com HTTP/2, HSTS, log de acesso por domínio e limite básico de requisições; backends bk_letsencrypt e bk_default.
Limites Eleva o limite de arquivos abertos do HAProxy para 2 milhões (systemd e limits.conf).
Kernel Grava /etc/sysctl.d/99-haproxy.conf com ajustes de rede para alta concorrência.
Serviço do painel Cria o serviço haproxy-admin (reinicia sozinho em caso de falha) e o arquivo .env com valores padrão.
Renovação de certificados Instala hooks do certbot que publicam o certificado renovado no HAProxy e recarregam o HAProxy uma vez (só se o haproxy -c passar), e ativa o certbot.timer.

Ao final, os serviços haproxy e haproxy-admin ficam habilitados e iniciados.

WAF OWASP (opcional): setup-waf.sh

O WAF é o firewall de aplicação OWASP Coraza com o Core Rule Set. Ele só é necessário se você for usar a tela WAF e o botão WAF dos domínios.

cd /opt/haproxy-admin
./setup-waf.sh

O script pode ser rodado mais de uma vez e:

  1. Instala o Go (se ausente) e compila o coraza-spoa.
  2. Baixa o OWASP CRS para /etc/coraza-spoa/coreruleset/ (se o download falhar, usa o CRS embutido no binário).
  3. Cria o serviço coraza-spoa, que escuta só em 127.0.0.1:9000, e a rotação dos logs em /var/log/coraza-spoa/.
  4. Liga o WAF ao HAProxy (filter spoe no ft_https e backend coraza-spoa), guardando antes uma cópia haproxy.cfg.waf-bak.<data>.
  5. Valida com haproxy -c e recarrega o HAProxy.

Dica: instalar o WAF não protege nenhum domínio sozinho. Depois da instalação, ative por domínio começando em Deteccao (só registra) e passe para Bloqueio depois de revisar os eventos.

Ajustar o .env

O arquivo /opt/haproxy-admin/.env define onde o painel escuta:

# /opt/haproxy-admin/.env
HAPROXY_ADMIN_HOST=0.0.0.0
HAPROXY_ADMIN_PORT=5000
Variável O que informar
HAPROXY_ADMIN_HOST IP em que o painel escuta. 0.0.0.0 = todas as interfaces; use o IP interno (ex.: 192.0.2.5) ou 127.0.0.1 para não expor o painel na interface pública.
HAPROXY_ADMIN_PORT Porta do painel (padrão 5000).
HAPROXY_ADMIN_HTTPS Opcional. Use true quando o painel for acessado via HTTPS (por exemplo, publicado como um domínio atrás do próprio HAProxy): o cookie de sessão passa a trafegar só em conexão segura.

Depois de editar, reinicie o painel:

systemctl restart haproxy-admin

Atenção: o painel em si fala HTTP puro. Não deixe a porta 5000 aberta para a internet: restrinja por firewall ou publique o painel como um domínio em HTTPS no HAProxy e limite o acesso aos seus IPs no campo Restringir por IP da tela do domínio.

Portas usadas

Porta Quem usa Exposição
80 HAProxy (ft_http): redirecionamento para HTTPS e desafio Let's Encrypt Pública
443 HAProxy (ft_https): todos os sites Pública
5000 Painel miniProxy (ajustável no .env) Restrita à sua rede
8888 certbot durante a emissão (backend bk_letsencrypt) Local
9000 coraza-spoa (só com o WAF instalado) Local (127.0.0.1)

As Portas TCP que você criar no painel também passam a escutar no servidor; libere no firewall só as que forem usadas.

Primeiro login e troca de senha

  1. Acesse http://<IP_DO_SERVIDOR>:5000/haproxy-admin/.
  2. Entre com o usuário admin e a senha padrão exibida no fim da instalação.
  3. Vá em Sistema > Usuarios e clique no ícone de chave (Alterar senha) do usuário admin.
  4. Informe a Nova Senha (mínimo 6 caracteres) e clique em Salvar.

Atenção: a senha padrão é a mesma em todas as instalações. Troque-a no primeiro acesso, ou crie um usuário próprio e remova o admin.

  1. Em Sistema > Configs, preencha Nome do servidor e Email do responsavel em Geral do painel. O e-mail é usado na emissão dos certificados Let's Encrypt.

Conferir os serviços

systemctl status haproxy          # HAProxy
systemctl status haproxy-admin    # Painel
systemctl status coraza-spoa      # WAF (se instalado)
journalctl -u haproxy-admin -f    # Log do painel

Próximo passo

Conheça a tela inicial em Acesso e Dashboard e depois ajuste as Configs do painel.

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!