IPScanner

Cloudflare Workers

Detección de bots y VPN en un Cloudflare Worker

Un Worker delante de tu sitio clasifica cada visita: personas, rastreadores de búsqueda reales, rastreadores de IA como GPTBot y bots que pasan por VPN o centros de datos.

Velocidad

Decidido antes de que tu visitante parpadee.

Cada comprobación responde en 50 a 100 ms, así que tus páginas y registros nunca la esperan.

Comprobación de IPScannermediana, en tu edge
~85 ms
Un parpadeoojo humano
300 ms
Una carga de página rápidaumbral «bueno» de Google
2,5 s

En pocas palabras

Qué detecta

Rastreadores de IA como GPTBot y ClaudeBot, scrapers, Googlebots falsos y bots que pasan por VPN, Tor o centros de datos. Las personas y los rastreadores de búsqueda reales entran.

Sin código

Haz clic en Deploy to Cloudflare, pega tu clave API y tu Site ID, añade una ruta. Unos 10 minutos.

Tú decides por categoría

Cada tipo de visitante está en Permitir, Marcar o Bloquear. Marcar lo deja pasar y lo señala, para que puedas bloquear esa categoría después con un clic.

Lo que cuesta

La monitorización no cuesta nada hasta 10.000 comprobaciones de sitio al mes, sin tarjeta. El bloqueo usa créditos prepago: 1 por comprobación de visitante, guardada 10 minutos, packs desde 19,99 €. Los 5000 créditos gratis para empezar piden una tarjeta (no se cobra nada hasta que compras un pack) y duran 30 días.

Quién ve tus datos

Servidores en Dinamarca (UE). De cada visitante recibimos la IP, el user agent y algunas cabeceras. Seguridad y tratamiento de datos

¿Ya usas los ajustes de bots de IA de Cloudflare?

Mantenlos. IPScanner añade comprobaciones de VPN, Tor y centros de datos y te muestra cada visitante antes de que bloquees algo más que Tor y scripts de bots.

Configuración

Listo en cuatro pasos

  1. 1

    Despliega el Worker

    O usa el botón de despliegue de arriba.

    shell
    git clone https://github.com/ipscanner/ipscanner-cloudflare
    cd ipscanner-cloudflare
    npm install
    npx wrangler deploy
  2. 2

    Añade tu clave de API

    shell
    npx wrangler secret put IPSCANNER_API_KEY
  3. 3

    Crea un sitio y define SITE_ID

    Añádelo en Sitios, en tu panel, que muestra su tráfico y guarda su política.

    wrangler.jsonc
    "vars": {
      "SITE_ID": "site_4fQ8nZ2kLm7xR1vT9cBw"
    }
  4. 4

    Ponlo delante de tu sitio

    En un dominio propio o en workers.dev, apunta ORIGIN_URL a tu backend.

    wrangler.jsonc
    "routes": [{
      "pattern": "example.com/*",
      "zone_name": "example.com"
    }]

Configúralo y olvídate

Despliega una vez, el Worker atiende cada solicitud

Los cambios de política llegan al edge sin redesplegar y, si alguna vez vamos lentos, la solicitud pasa intacta.

Política actualizadaActiva en el edge, sin redesplegar
Origen protegidoSolo pasa el tráfico permitido

Cómo funciona

Qué pasa en cada solicitud

  1. 1

    El Worker lee la IP, el User-Agent y el JA4 del visitante, cuando Cloudflare lo proporciona.

  2. 2

    Agentscan e IP Detection se ejecutan en paralelo, con caché por visitante, y dejan pasar la solicitud tras 1,5 segundos.

  3. 3

    El modo monitor envía cabeceras de veredicto a tu servidor de origen. El modo Bloqueo además responde con un 403 al visitante bloqueado.

  4. 4

    Los crawlers verificados siempre pasan, y se eliminan las cabeceras X-IPScanner-* que envíe el cliente.

Cabeceras

Cabeceras que recibe tu servidor de origen

Si una comprobación falla o se omite, solo se define X-IPScanner-Status.

CabeceraEjemplo
X-IPScanner-ClassAgentscanhuman
X-IPScanner-ActionAgentscanallow
X-IPScanner-ConfidenceAgentscan0.92
X-IPScanner-Network-ClassIP Detectionresidential_clean
X-IPScanner-AnonymizedAmbosfalse
X-IPScanner-RiskIP Detection12
X-IPScanner-CountryIP DetectionDE
X-IPScanner-StatusWorkerok

Ajustes

Ajustes

Defínelos en el bloque vars de wrangler.jsonc.

VariablePor defecto
MODEmonitor añade cabeceras, enforce además bloqueamonitor
SITE_IDEl id de tu sitio. Si lo defines, se aplica la política del panelVacío
CHECK_AGENTEjecuta Agentscantrue
CHECK_IPEjecuta IP Detectiontrue
BLOCK_CLASSESClases de Agentscan a bloquear en modo enforcemalicious_automation
BLOCK_ANONYMIZEDTambién bloquea VPN, proxy y Tor en modo enforcefalse
TIMEOUT_MSPor llamada, después la solicitud pasa1500
AGENT_TTLSegundos en caché de un veredicto de Agentscan600
IP_TTLSegundos en caché de una consulta de IP3600
POLICY_TTLSegundos que una política descargada sigue vigente30
SKIP_PATHSRegex de rutas que omiten la comprobaciónRecursos estáticos
ORIGIN_URLBackend de destino fuera de una rutaVacío

Preguntas

Preguntas sobre el Cloudflare Worker

Un crédito por cada visitante sin caché. Las visitas repetidas dentro del TTL de la caché no consumen ninguno.

Empieza en modo monitor

Observa las cabeceras durante una semana antes de bloquear nada.

    Cloudflare Worker para detectar bots y VPN | IPScanner