blog
Infraestrutura web

Log mostra IP da Cloudflare: como restaurar o IP real

Como restaurar o IP do visitante atrás da Cloudflare, ajustar o bloqueio para a camada certa e purgar os dois caches na ordem que funciona.

JR · · 8 min de leitura · 3 tabelas · 4 blocos de código

Resposta curta: o servidor registra o IP da borda porque é ela quem abre a conexão; o IP do visitante vai no cabeçalho CF-Connecting-IP. A correção é configurar o servidor para ler esse cabeçalho confiando apenas nas faixas da Cloudflare, e conferir no access_log bruto.

Neste artigo
  1. O que muda no access_log quando a Cloudflare entra na frente
  2. Use Client IP in Header: restaurar o IP real no LiteSpeed com cPanel
  3. Ler o access_log bruto para provar que o IP do visitante voltou
  4. Bloquear na borda ou na origem: como decidir antes de escrever a regra
  5. Os dois caches e o que cada um guarda
  6. Checklist de onboarding para sites atrás da Cloudflare
  7. Como explicar ao cliente que o relatório mudou
  8. Três causas de o IP real não voltar mesmo com tudo configurado

O que muda no access_log quando a Cloudflare entra na frente

Com o proxy da Cloudflare ligado (nuvem laranja no DNS), nenhuma requisição chega direto do visitante. Quem abre a conexão TCP com o seu servidor é um datacenter da borda. Para o Apache, LiteSpeed ou nginx da origem, aquele é o cliente. É esse IP que vai para o access_log, para o AWStats do painel, para o .htaccess que bloqueia por IP e para o plugin de segurança do WordPress.

Três coisas quebram ao mesmo tempo:

O visitante real não some. Ele viaja no cabeçalho HTTP CF-Connecting-IP, que a Cloudflare adiciona em toda requisição que repassa para a origem, além de aparecer no X-Forwarded-For. O trabalho é fazer o servidor da origem usar esse cabeçalho como IP de cliente em vez do IP da conexão.

Use Client IP in Header: restaurar o IP real no LiteSpeed com cPanel

Em servidores cPanel com LiteSpeed, o caminho documentado não é instalar módulo. A documentação oficial do LiteSpeed sobre Cloudflare no cPanel descreve a opção nativa do servidor para ler o IP do cliente a partir do cabeçalho, no lugar de mod_cloudflare do Apache.

No WebAdmin Console do LiteSpeed, em Server > General, existe a configuração Use Client IP in Header. Os valores que importam:

Valor Comportamento Quando usar
No Ignora o cabeçalho, registra o IP da conexão Origem exposta direto na internet, sem proxy
Yes Confia no cabeçalho de qualquer origem Evite: permite forjar o IP batendo direto no servidor
Trusted IP Only Só aceita o cabeçalho se a conexão vier de um IP marcado como confiável Padrão correto atrás da Cloudflare

Com Trusted IP Only, você precisa declarar as faixas da Cloudflare como confiáveis na lista de IPs permitidos do servidor. A lista oficial de redes da borda é publicada e muda de tempos em tempos, então trate isso como item de manutenção, não como configuração que se faz uma vez e esquece.

Se você está num plano de hospedagem compartilhada, o WebAdmin não é seu. Nesse caso a configuração é do servidor e precisa ser pedida ao suporte, ou você resolve na camada da aplicação (próxima seção). Não insista em mod_cloudflare por conta própria: o módulo foi descontinuado pela Cloudflare e em Apache moderno o equivalente é mod_remoteip, que também é configuração de servidor, não de .htaccess.

Por que 'Trusted IP Only' evita cabeçalho forjado e 'Yes' não

Se o servidor aceitar CF-Connecting-IP de qualquer conexão, qualquer pessoa que descubra o IP de origem pode mandar uma requisição direta com o cabeçalho forjado e aparecer no seu log como o IP que quiser. Isso contamina o relatório e, pior, fura bloqueio e rate limit. Confiar só nas faixas da borda fecha essa porta.

No mesmo passe, feche a origem: se o firewall do servidor só aceitar conexões nas portas 80 e 443 vindas das faixas da Cloudflare, ninguém chega direto e a decisão de confiar no cabeçalho fica consistente.

Ler o access_log bruto para provar que o IP do visitante voltou

Não confie no painel para validar. O relatório pode estar em cache ou processar o log com atraso de horas. Leia o log bruto.

# últimas 20 linhas do access_log do domínio
tail -n 20 ~/access-logs/exemplo.com.br

# conferência rápida: quais IPs aparecem com mais frequência
awk '{print $1}' ~/access-logs/exemplo.com.br | sort | uniq -c | sort -rn | head

Se a primeira coluna continuar cheia de IPs idênticos repetindo centenas de vezes, o cabeçalho ainda não está sendo usado. Se aparecerem IPs residenciais variados, voltou.

Para testar com um IP que você conhece, acesse o site do celular na rede móvel, confira seu IP num serviço público de "meu IP" e procure esse valor no log:

# troque 203.0.113.45 pelo IP real do seu teste (essa faixa é reservada para documentação)
grep '203.0.113.45' ~/access-logs/exemplo.com.br

Dentro do WordPress, uma checagem rápida de qual IP a aplicação está enxergando, para colar num arquivo temporário e apagar depois:

<?php
// arquivo de teste: apague depois de usar
echo 'REMOTE_ADDR: ' . $_SERVER['REMOTE_ADDR'] . "\n";
echo 'CF-Connecting-IP: ' . ($_SERVER['HTTP_CF_CONNECTING_IP'] ?? 'ausente') . "\n";

Se REMOTE_ADDR já traz o IP do visitante, o servidor resolveu e nenhum plugin precisa ser ajustado. Se só o cabeçalho traz, a correção está acontecendo apenas na aplicação e cada plugin de segurança precisa ser configurado individualmente para ler o cabeçalho. Vários deles (firewalls de WordPress) têm essa opção explícita nas preferências.

Bloquear na borda ou na origem: como decidir antes de escrever a regra

Com proxy na frente, você tem dois lugares para bloquear e eles não são equivalentes.

Critério Bloqueio na borda (Cloudflare) Bloqueio na origem (.htaccess, firewall)
Onde o tráfego para Antes de chegar ao servidor Depois de consumir conexão e CPU da origem
Consumo de recurso do plano Nenhum na origem Processo PHP, I/O, banda interna
Funciona sem IP real restaurado Sim Não, erra o alvo
Granularidade IP, ASN, país, user agent, path IP e padrão de requisição
Risco de autobloqueio Baixo Alto se bloquear faixa da Cloudflare

Regra prática: abuso de volume bloqueia na borda, regra de negócio fica na origem. Scanner, flood de login, bot que varre wp-content são casos de borda, porque o objetivo é que o tráfego nem chegue. Restrição de uma área administrativa a IPs do escritório do cliente pode ficar na origem, desde que o IP real já esteja correto.

Antes de aplicar qualquer Deny from novo, confira se o IP que você vai bloquear não pertence à Cloudflare. Bloquear um PoP não derruba apenas um visitante, derruba todo mundo que estiver sendo roteado por ele.

Onde bloquear: borda ou origemAbuso de volume?Scanner, flood de login, botSim: bloqueie na bordaTráfego nem chega ao servidorNão: regra de negócioRestringir área administrativa por IPConfirme o IP real antesOrigem erra o alvo sem eleCheque se o IP é CloudflareBloquear PoP derruba muita gente
Decisão antes de escrever qualquer regra de bloqueio com proxy na frente.

Os dois caches e o que cada um guarda

Resolvido o log, sobra o outro efeito colateral de ter duas camadas. Publicar alteração e continuar vendo a página antiga é quase sempre ordem de purga errada.

Camada Guarda tipicamente Quem limpa
Cache da origem (LSCache, plugin de cache) HTML gerado pelo WordPress, página completa Plugin no painel do WP ou pelo servidor
Cache da borda (Cloudflare) Estáticos: CSS, JS, imagens, fontes. HTML só com regra explícita Painel da Cloudflare, purge por URL ou total
Cache do navegador Tudo que veio com Cache-Control longo Ctrl+Shift+R, aba anônima

Purgar na ordem certa: origem, borda e só então navegador

  1. Origem primeiro. Limpe o cache do plugin no WordPress. Se limpar a borda antes, ela vai buscar na origem e receber de volta a mesma página velha que estava no cache local, e você repete o ciclo achando que a Cloudflare está com defeito.
  2. Borda depois. Purge por URL quando souber o que mudou, purge total só em redesenho ou troca de tema. Purge total força a borda a reconstruir tudo a partir da origem e gera um pico de requisições no servidor.
  3. Navegador por último, para a sua própria conferência. Use janela anônima para não se enganar.

O que cf-cache-status e o cabeçalho do LiteSpeed dizem sobre quem entregou a página

curl -sSI https://exemplo.com.br/ | grep -iE 'cf-cache-status|x-litespeed-cache|age|cache-control'

O cf-cache-status responde pela borda: HIT veio do cache da Cloudflare, MISS a borda foi buscar na origem, DYNAMIC a borda não cacheia aquele recurso, BYPASS uma regra mandou ignorar o cache. O cabeçalho de cache do LiteSpeed indica se a origem serviu do próprio cache. Com DYNAMIC na borda e hit na origem, você sabe exatamente de quem é o HTML velho e para onde mandar o purge.

Repita o curl logo após a purga. Dois MISS seguidos sem a alteração aparecer significa que o problema não é cache: é a alteração que não chegou ao arquivo em produção.

Ordem de purga que evita página velhaOrigemLimpe o cache do pluginBordaPurge por URL na CloudflareNavegadorJanela anônima para conferirValidarcurl nos cabeçalhos de cache
Inverter a ordem faz a borda recarregar a mesma página velha da origem.

Checklist de onboarding para sites atrás da Cloudflare

Transforme isto em item fixo do seu onboarding de site atrás da Cloudflare:

  1. Confirmar com o provedor se o servidor restaura o IP do cliente a partir do cabeçalho e em qual modo (confiança restrita às faixas da borda).
  2. Rodar o tail no access_log logo após ligar o proxy e guardar uma amostra. Se já tiver IP residencial variado, está certo.
  3. Revisar as regras existentes de Deny from e do firewall de WordPress: qualquer uma escrita durante o período de IP errado está mirando no alvo errado.
  4. Habilitar, no plugin de segurança, a opção de ler o IP real do cabeçalho da Cloudflare.
  5. Mover bloqueio de abuso de volume para a borda e deixar na origem só restrição de negócio.
  6. Documentar a ordem de purga (origem, borda, navegador) no runbook que a equipe usa ao publicar.
  7. Revisitar as faixas de IP confiáveis quando o provedor avisar de mudança.

Como explicar ao cliente que o relatório mudou

Quando o cliente abrir o relatório e disser que o site só recebe visita "do mesmo lugar", use algo assim:

Se o cliente acompanha métricas de audiência de verdade, o lugar certo não é o relatório do painel de hospedagem: oriente para a ferramenta de analytics, que mede no navegador e não é afetada pelo proxy, e use o log do servidor para diagnóstico e segurança.

Três causas de o IP real não voltar mesmo com tudo configurado

Três causas comuns, na ordem em que eu checaria:

Nada disso exige trocar de plano. É configuração em duas camadas e uma conferência no log bruto para provar que funcionou.

Referências

  1. Documentação oficial (litespeed) — LiteSpeed com Cloudflare no cPanel. Consultado em 2026-09-16.
Leia também