Quando um site usa o proxy da Cloudflare (nuvem laranja), as conexões chegam ao HAProxy vindas dos servidores da Cloudflare, e não do visitante. A tela Cloudflare configura o miniProxy para recuperar o IP real de quem acessa, atender sites em SSL Flexible sem loop de redirecionamento e, se você quiser, recusar quem tenta acessar o servidor sem passar pela Cloudflare.
O que o painel faz (e o que não faz) com a Cloudflare
O miniProxy não altera nada na sua conta Cloudflare: não cria nem muda registros DNS, não mexe em modo SSL nem em regras de firewall. Ele atua só no HAProxy:
- baixa as faixas de IP oficiais da Cloudflare (
cloudflare.com/ips-v4e/ips-v6); - usa essas faixas para confiar no cabeçalho
CF-Connecting-IP(o IP real do visitante) apenas quando a conexão vem mesmo da Cloudflare; - trata os domínios marcados como Cloudflare (SSL Flexible e bloqueio de acesso direto).
O único uso da API da Cloudflare é a validação DNS-01 de certificados, que usa um API token configurado na tela Certificados SSL (veja a seção "Token da Cloudflare para certificados", mais abaixo).
Por que o IP real importa
Sem esse ajuste, o HAProxy enxerga o IP da Cloudflare em todas as requisições. Na prática:
- logs, Investigar IP e estatísticas mostram IPs da Cloudflare em vez dos visitantes;
- limites por IP, blocklist e regras atingem a Cloudflare inteira, e não o visitante abusivo.
Com o IP real recuperado, todas essas funções passam a enxergar o visitante.
Faixas de IP da Cloudflare
O card Faixas de IP do Cloudflare mostra quantas faixas estão carregadas (IPv4 + IPv6) e quando foram atualizadas. A lista é baixada automaticamente ao marcar o primeiro domínio ou ligar o modo global e gravada em /etc/haproxy/cloudflare_ips.lst.
Clique em Atualizar IPs para baixar a lista de novo. Faça isso de tempos em tempos, porque a Cloudflare ocasionalmente adiciona faixas novas.
Ajustes globais
No card Ajustes globais:
| Opção | O que faz |
|---|---|
| Modo global (Flexible sempre ativo) | Recupera o IP real do visitante para qualquer domínio cujo tráfego venha de um IP da Cloudflare, sem precisar marcar domínio por domínio. Cobre sites em SSL Full ou Full (strict), que são a maioria. É seguro contra falsificação: o cabeçalho só é aceito se a conexão vier das faixas da Cloudflare. |
| Recusar acesso fora do Cloudflare aos dominios marcados | Responde 403 a quem acessar um domínio marcado como Cloudflare sem vir das faixas da Cloudflare, impedindo o acesso direto ao servidor de origem. Vale só para os domínios marcados, mesmo com o modo global ligado. Domínios diretos e o desafio da Let's Encrypt não são afetados. |
Clique em Salvar. O painel valida a configuração e recarrega o HAProxy.
Dica: se todos os seus sites com Cloudflare usam SSL Full ou Full (strict), ligar o Modo global costuma bastar para ter o IP real em todos eles.
Marcar um domínio como Cloudflare
A marcação é feita por domínio:
- Abra o domínio em Dominios.
- No card Seguranca, na linha Cloudflare, clique em Marcar como Cloudflare.
- A linha passa a mostrar Atras do Cloudflare (IP real via CF-Connecting-IP) e o domínio ganha a etiqueta CF na lista.
Para desfazer, clique em Marcar como direto.
Um domínio marcado recebe:
- IP real do visitante pelo
CF-Connecting-IP, mesmo sem o modo global; - atendimento na porta 80 em SSL Flexible: quando a Cloudflare fala HTTP com o servidor (modo Flexible), o miniProxy serve o site normalmente, em vez de redirecionar para HTTPS e causar loop de redirecionamento;
- bloqueio de acesso direto, se a opção Recusar acesso fora do Cloudflare aos dominios marcados estiver ligada.
Marque domínio por domínio principalmente os sites em SSL Flexible: esse tratamento nunca é aplicado globalmente.
O card Dominios atras do Cloudflare lista os domínios marcados, com seus hosts e o nome da ACL.
Atenção: só ligue a recusa de acesso direto em domínios que de fato estão com a nuvem laranja na Cloudflare. Se o registro estiver como DNS only (nuvem cinza), os visitantes chegam direto ao servidor e passam a receber 403.
Token da Cloudflare para certificados
Para emitir certificados por DNS-01 (útil quando o domínio está com a nuvem laranja ou para certificado curinga), o miniProxy precisa de um API token da Cloudflare com permissão Zone → DNS → Edit nas zonas dos seus domínios. Ele é configurado em Certificados SSL, no card Validacao DNS-01 (Cloudflare), campo de token e botão Salvar token. O token fica em /etc/haproxy/cloudflare-dns.ini, com permissão restrita.
Detalhes em Certificados SSL.
Dica: crie um token exclusivo para o miniProxy, só com a permissão de DNS e só nas zonas necessárias. Assim, se precisar revogá-lo, nada mais é afetado.
Problemas comuns
Loop de redirecionamento (ERR_TOO_MANY_REDIRECTS)
Acontece com sites em SSL Flexible na Cloudflare que não estão marcados no miniProxy: a Cloudflare chega por HTTP, o HAProxy redireciona para HTTPS, e o ciclo se repete. Marque o domínio com Marcar como Cloudflare, ou mude o modo SSL na Cloudflare para Full.
Logs e bloqueios mostram IPs da Cloudflare
Ligue o Modo global (Flexible sempre ativo) ou marque o domínio como Cloudflare. Se o problema continuar, clique em Atualizar IPs: a conexão pode estar vindo de uma faixa nova da Cloudflare que ainda não está na lista.
Certificado não emite com a nuvem laranja
Veja Certificados SSL, seção de erros comuns: use a nuvem cinza durante a emissão ou, melhor, a validação DNS-01.