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
- Vá em Configuracoes e abra a aba HAProxy.
- Ligue Habilitado.
- 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 |
- Clique em Testar Conexao. A mensagem Conexao com HAProxy API OK! confirma o acesso.
- 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.
- Clique em Provisionar Dominio.
- 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 |
- 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.