Pular para o conteúdo
Documentação

Cloudflare

Como o miniProxy trabalha com domínios atrás da Cloudflare: IP real do visitante, SSL Flexible, bloqueio de acesso direto e token para DNS-01.

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

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-v4 e /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:

  1. Abra o domínio em Dominios.
  2. No card Seguranca, na linha Cloudflare, clique em Marcar como Cloudflare.
  3. 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.

Veja também

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!