Pular para o conteúdo
Documentação

Integração com o HAProxy

Como conectar o miniCP à API do HAProxy para publicar domínios, gerar SSL, gerenciar servidores do backend e bloquear IPs.

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

A integração com o HAProxy permite publicar os domínios deste servidor no balanceador da frente e gerar o certificado SSL lá, sem sair do miniCP. Ela funciona com a API de administração do HAProxy usada pela miniDC.

Como funciona

Com o HAProxy na frente, os visitantes chegam ao HAProxy, que termina o SSL e encaminha a requisição para este servidor.

Visitante → HAProxy (SSL) → backend deste servidor → Apache/NGINX → PHP-FPM

Cada servidor miniCP tem o próprio backend no HAProxy, com o nome bk_ seguido do hostname do servidor. Provisionar um domínio é cadastrar o domínio nesse backend e, se quiser, gerar o certificado Let's Encrypt no HAProxy.

Configurar a conexão

  1. Vá em Configuracoes e abra a aba HAProxy.
  2. Ligue Habilitado.
  3. Preencha os campos:
Campo O que informar
Host / IP Endereço do HAProxy na rede
Porta Porta da API (padrão 5000)
Path da API Caminho da API (padrão /haproxy-admin/api)
Usuario e Senha Credenciais da API. Deixe a senha vazia para manter a atual
  1. Clique em Testar Conexao. A mensagem Conexao com HAProxy API OK! confirma o acesso.
  2. Clique em Salvar Configuracoes.

Abaixo dos campos aparece a URL completa montada a partir dos dados.

Ao habilitar o HAProxy, o painel também ajusta o Apache e o NGINX para registrar o IP real do visitante, e não o IP do HAProxy.

Dica: preencha também o E-mail padrao (Let's Encrypt) em Configuracoes → Geral. Ele é usado nos certificados gerados ao criar domínios.

Com a integração ligada, aparece o item HAProxy em Rede & SSL.

A tela HAProxy

O topo mostra este servidor (hostname e IP), o nome do backend e os totais de domínios, certificados e servidores.

Provisionar Dominio

É o jeito mais rápido de publicar um domínio que já existe no miniCP.

  1. Clique em Provisionar Dominio.
  2. Preencha:
Campo Uso
Dominio Ex.: loja.exemplo.com.br
E-mail (para Let's Encrypt) Já vem com o e-mail padrão
Incluir www.dominio Cadastra também o www
Gerar certificado SSL (Let's Encrypt) Marcado por padrão
Criar registro DNS na Cloudflare Aparece com a Cloudflare ligada. Cria o registro A apontando para o IP do servidor
Ativar proxy (nuvem laranja) Liga o proxy da Cloudflare no registro
  1. Clique em Provisionar.

O que acontece depois:

  • Com Cloudflare marcada: o registro DNS é criado na hora e o HAProxy + SSL é agendado para cerca de 1 minuto depois, tempo para o DNS propagar.
  • Só com SSL: o provisionamento roda em segundo plano, porque a emissão pode passar de 1 minuto.
  • Sem SSL: o domínio é cadastrado no backend na hora.

Provisionamentos agendados / recentes

Mostra os provisionamentos em segundo plano, com o selo Aguardando DNS... enquanto houver algum pendente. A tabela se atualiza sozinha.

Status Significado
Agendado (~Ns) Aguardando, com contagem regressiva
Provisionando Cadastrando no HAProxy e emitindo o certificado
Concluido Domínio publicado
Erro Falhou. A coluna Detalhe mostra o motivo

O painel guarda os 30 provisionamentos mais recentes.

Se o painel reiniciar (atualização, reinício do serviço ou do servidor) antes de um provisionamento terminar, ele é retomado sozinho poucos segundos depois que o painel volta, com o detalhe "retomado apos reinicio do painel". Provisionamentos criados em versões antigas do painel, que não guardavam os dados necessários, passam para Erro com o detalhe "interrompido por reinicio do painel; provisione de novo". Nesse caso, clique em Provisionar Dominio e faça de novo.

Dominios

Lista os domínios cadastrados no backend deste servidor, com o selo SSL quando há certificado.

  • Adicionar: cadastra o domínio no backend, sem gerar certificado. Pode criar o registro na Cloudflare junto.
  • Ícone de cadeado: aparece em domínios sem certificado e abre o Gerar Certificado SSL já preenchido.
  • Lixeira: remove o domínio do HAProxy.

Certificados SSL

  • Gerar: emite um certificado Let's Encrypt no HAProxy para um domínio, com ou sem www.
  • Renovar Todos: pede ao HAProxy a renovação dos certificados.
  • Lixeira: remove o arquivo do certificado.

Atenção: para o certificado ser emitido, o DNS do domínio já precisa apontar para o HAProxy. Se gerar antes de o DNS propagar, a validação do Let's Encrypt falha.

Backend: servidores

Lista os servidores do backend deste miniCP. O servidor atual tem o selo ESTE; servidores reserva têm o selo BACKUP.

Ação Efeito
+ Servidor Adiciona um servidor: nome, endereço IP, porta (padrão 80), MaxConn e opção Servidor de backup
Pausar Coloca o servidor em manutenção (MAINT). O HAProxy para de enviar tráfego para ele
Habilitar Volta o servidor para UP
Lixeira Remove o servidor do backend

Atenção: colocar em manutenção ou remover o único servidor do backend tira todos os sites deste servidor do ar.

Bloqueio de IPs e User-Agents

O HAProxy mantém uma lista de bloqueio que vale para todo o tráfego. No miniCP ela é usada em dois lugares:

  • Monitoramento → Dominios, botão Gerenciar bloqueios: bloqueia ou libera manualmente um IP (ou faixa CIDR) e um trecho de User-Agent.
  • Rede & SSL → Protecao contra bots: bloqueia automaticamente IPs com excesso de requisições. Veja Proteção contra bots.

Próximo passo

Veja o passo a passo completo em Publicar um site novo com SSL.

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!