Pular para o conteúdo
Documentação

Proteção contra bots

Como a Proteção contra bots detecta IPs com excesso de requisições e os bloqueia no HAProxy por tempo limitado.

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

A Proteção contra bots detecta endereços IP que fazem requisições demais aos sites do servidor e os bloqueia no HAProxy por um tempo. Ela ajuda contra robôs agressivos, varreduras e picos de acesso abusivo. Acesse em Rede & SSL → Protecao contra bots.

Como funciona

  1. A cada janela de tempo, o painel lê os logs de acesso de todos os domínios (HTTP e HTTPS).
  2. Conta quantas requisições cada IP fez e calcula a média por minuto.
  3. O IP que passar do limite é bloqueado no HAProxy, a menos que esteja isento.
  4. Depois do tempo de bloqueio, o painel libera o IP sozinho.

Os bloqueios feitos pela proteção ficam gravados em disco. Por isso cada IP é liberado no tempo configurado mesmo que o painel seja reiniciado ou atualizado nesse meio-tempo, e mesmo que você desligue a proteção: desligada, ela para de bloquear IPs novos, mas continua liberando os que já tinha bloqueado quando o prazo vence.

Quando um ou mais IPs são bloqueados, o painel envia um alerta pelos canais configurados em Configuracoes → Alertas.

Atenção: sem o HAProxy habilitado, a proteção funciona em modo relatorio: mostra os IPs abusivos, mas não bloqueia. Para bloquear, configure a integração com o HAProxy.

Configurar

  1. Ligue Ativa.
  2. Ajuste os campos:
Campo Padrão Significado
Limite (req/min por IP) 300 Média de requisições por minuto a partir da qual o IP é bloqueado. Mínimo 30
Janela (min) 5 Período analisado. Também é o intervalo entre as varreduras. De 1 a 60
Bloqueio (min) 60 Tempo que o IP fica bloqueado. De 5 minutos a 7 dias
Whitelist vazio IPs e faixas CIDR que nunca são bloqueados, separados por espaço ou vírgula
Bots bons isentos Googlebot, bingbot, DuckDuckBot, YandexBot, Applebot, facebookexternalhit, Slurp, UptimeRobot Expressão regular aplicada ao User-Agent. Quem casar não é bloqueado
  1. Clique em Salvar.

Os proxies confiáveis (o próprio servidor e o HAProxy) são sempre isentos.

Dica: coloque na Whitelist os IPs do seu escritório, do monitoramento externo e de integrações que acessam os sites com frequência (ERP, marketplace, gateway).

Atenção: se você salvar o campo Bots bons isentos vazio, nenhum robô fica isento: todos podem ser bloqueados pelo limite. Para manter os buscadores isentos, deixe a lista preenchida. Para isentar outros robôs, acrescente os nomes separados por |, por exemplo Googlebot|bingbot|MeuMonitor. Uma expressão inválida não é salva e a anterior é mantida.

Escolher o limite

O limite é uma média por minuto dentro da janela. Com os padrões (300 req/min em 5 minutos), o IP precisa fazer 1500 requisições em 5 minutos para ser bloqueado.

  • Um visitante comum raramente passa de algumas dezenas de requisições por minuto, mesmo carregando imagens e scripts.
  • Lojas com muitos arquivos por página ou APIs muito usadas podem precisar de um limite maior.
  • Comece com o padrão e acompanhe a tabela Mais ativos na janela antes de baixar o limite.

Acompanhar

A tela mostra quando foi a última varredura (atualizado) e se atualiza sozinha a cada 20 segundos. Para varrer na hora, clique em Varrer agora.

Bloqueados agora

IPs bloqueados pela proteção, com a taxa de requisições, o motivo e há quanto tempo foram bloqueados.

Para liberar antes do prazo, clique em liberar na linha do IP.

Mais ativos na janela

IPs que passaram do limite na última varredura, com a taxa e o User-Agent. Os selos indicam isenção:

Selo Significado
whitelist IP na whitelist ou proxy confiável
bot bom User-Agent casa com a lista de bots bons

Nos IPs não isentos aparece o botão bloquear, para bloquear na hora no HAProxy.

Atenção: o IP bloqueado manualmente pelo botão bloquear não é liberado sozinho. Para liberar, use Monitoramento → Dominios → Gerenciar bloqueios.

Bloqueio manual de IPs e User-Agents

Para bloquear um IP, uma faixa de IPs ou um User-Agent de forma permanente, use Monitoramento → Dominios → Gerenciar bloqueios. A lista de bloqueio é a mesma do HAProxy usada por esta proteção.

Relação com outros eventos

Picos de robôs costumam aparecer em Eventos de Recurso como PHP-FPM lotado ou Apache lotado. Se esses eventos coincidem com IPs na tabela Mais ativos na janela, ajuste o limite ou bloqueie o IP.

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!