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.shsubstitui o/etc/haproxy/haproxy.cfgpor 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
- Copie a pasta do projeto para o servidor. O local final é
/opt/haproxy-admin; se você rodar o script de outra pasta, ele copiaapp.py,templates/estatic/para lá. - Entre na pasta e rode o script como root:
cd /opt/haproxy-admin
chmod +x setup.sh
./setup.sh
- 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:
- Instala o Go (se ausente) e compila o
coraza-spoa. - Baixa o OWASP CRS para
/etc/coraza-spoa/coreruleset/(se o download falhar, usa o CRS embutido no binário). - Cria o serviço
coraza-spoa, que escuta só em127.0.0.1:9000, e a rotação dos logs em/var/log/coraza-spoa/. - Liga o WAF ao HAProxy (
filter spoenoft_httpsebackend coraza-spoa), guardando antes uma cópiahaproxy.cfg.waf-bak.<data>. - Valida com
haproxy -ce 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
- Acesse
http://<IP_DO_SERVIDOR>:5000/haproxy-admin/. - Entre com o usuário admin e a senha padrão exibida no fim da instalação.
- Vá em Sistema > Usuarios e clique no ícone de chave (Alterar senha) do usuário
admin. - 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.
- 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.