# 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.

> 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.

João Rizzon · 2026-11-07 · Infraestrutura web

---

## 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:

- **Relatório de visitantes**: o painel passa a mostrar algumas dezenas de IPs repetidos, todos de faixas da Cloudflare, e a geolocalização some ou vira o país do PoP.
- **Bloqueio por IP**: a regra `Deny from` no `.htaccess` ou no firewall da origem passa a mirar a borda. Bloquear um IP da Cloudflare pode derrubar o site para um pedaço grande do público.
- **Rate limit e regras de segurança**: qualquer contagem por IP (tentativa de login, flood em `xmlrpc.php`) soma todo mundo no mesmo balde e dispara falso positivo.

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](https://docs.litespeedtech.com/lsws/cp/cpanel/cloudflare/) 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.

```bash
# ú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:

```bash
# 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
<?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.

## 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

- **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.
- **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.
- **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

```bash
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.

## Checklist de onboarding para sites atrás da Cloudflare

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

- 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).
- Rodar o `tail` no `access_log` logo após ligar o proxy e guardar uma amostra. Se já tiver IP residencial variado, está certo.
- 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.
- Habilitar, no plugin de segurança, a opção de ler o IP real do cabeçalho da Cloudflare.
- Mover bloqueio de abuso de volume para a borda e deixar na origem só restrição de negócio.
- Documentar a ordem de purga (origem, borda, navegador) no runbook que a equipe usa ao publicar.
- 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:

> **** O site passou a usar uma rede de proteção que fica na frente do servidor e filtra ataque antes de chegar. Por causa disso, o relatório antigo passou a registrar o IP dessa rede, não o do visitante. O acesso continua normal, só a identificação precisava ser ajustada. Fizemos o ajuste no servidor e os relatórios a partir de agora voltam a mostrar a origem real. Os relatórios do período anterior ao ajuste seguem com a informação agregada.

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:

- **O cabeçalho não está chegando.** Teste com o arquivo PHP da seção de validação. Se `HTTP_CF_CONNECTING_IP` vier "ausente", a requisição não passou pela Cloudflare: ou o registro DNS está cinza (proxy desligado) ou alguém está batendo direto no IP da origem.
- **A confiança está restrita a IPs desatualizados.** As faixas da borda mudam. Lista velha significa cabeçalho descartado em silêncio, sem erro no log.
- **A aplicação ignora o que o servidor corrigiu.** Alguns plugins leem uma variável própria. Se `REMOTE_ADDR` está certo e o plugin continua mostrando IP da Cloudflare, a configuração que falta é a do plugin, não a do servidor.

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

