Plausible Analytics para Astro con Cloudflare Workers

Plausible Analytics es una alternativa a Google Analytics de código abierto y centrada en la privacidad. Es ligera (script de menos de 1 KB), no usa cookies y no rastrea datos personales. Con más de 19.000 suscriptores de pago y 260.000 millones de páginas vistas registradas, es la herramienta de analítica centrada en la privacidad más popular entre los desarrolladores.

Puedes autoalojar Plausible en tus propios servidores. Consulta Instalar Plausible con un clic para una configuración rápida, o usa uno de los mejores paneles de servidores autoalojados para un despliegue sencillo.

Astro es un framework web construido para la velocidad, y ahora se ejecuta de forma nativa en Cloudflare. Tras la adquisición de Astro por Cloudflare en enero de 2026, el adaptador @astrojs/cloudflare eliminó por completo el soporte para Pages. Desde la v13, los despliegues se hacen exclusivamente en Cloudflare Workers. Puedes desplegar tu sitio Astro en Cloudflare o crear un blog gratis con Astro y Cloudflare para empezar. Para un análisis más profundo de los frameworks disponibles, consulta la comparativa Astro vs Next.js vs TanStack Start.

En esta guía vas a configurar Plausible Analytics para tu sitio Astro usando Cloudflare Workers como proxy. El resultado: analítica precisa que evita los bloqueadores de anuncios, servida desde tu propio dominio y con un plan gratuito.

¿Por qué hacer proxy de Plausible Analytics a través de Cloudflare Workers?

Los bloqueadores de anuncios y los navegadores centrados en la privacidad bloquean habitualmente las solicitudes a plausible.io. Esto puede hacerte perder entre el 20 y el 30 % de tus datos de analítica. Si usas herramientas como NextDNS o bloqueadores de anuncios en el navegador en tus propios dispositivos, ya sabes lo agresivos que son bloqueando scripts de analítica.

Un proxy resuelve esto enrutando las solicitudes de Plausible a través de tu propio dominio. Para los navegadores de tus visitantes, el script de analítica parece parte de tu sitio, no un rastreador de terceros. Los bloqueadores de anuncios no pueden distinguirlo del tráfico normal del sitio.

Para más información sobre cómo bloquear anuncios y rastreadores a nivel de DNS, consulta cómo bloquear anuncios y rastreo con protección DNS.

¿Por qué usar Cloudflare Workers en lugar de redirecciones?

Si despliegas en Cloudflare Pages, podrías pensar que puedes usar el archivo _redirects para hacer proxy de las solicitudes de Plausible. No puedes. Cloudflare Pages solo admite redirecciones a rutas relativas. No puede hacer proxy hacia URLs externas.

Intentar añadir una redirección de proxy como esta fallará:

Found invalid redirect lines:
09:59:12.187	  - #1: /js/script.js https://domain.com/js/plausible.outbound-links.js 200
09:59:12.187	    Proxy (200) redirects can only point to relative paths. Got https://domain.com/js/plausible.outbound-links.js
09:59:12.187	  - #2: /api/event https://domain.com/api/event 200
09:59:12.187	    Proxy (200) redirects can only point to relative paths. Got https://domain.com/api/event

Los Cloudflare Workers no tienen esta limitación. Pueden hacer fetch a cualquier URL externa y devolver la respuesta, lo que los convierte en la herramienta adecuada para hacer proxy de Plausible en Cloudflare.

Hacer proxy de Plausible a través de Cloudflare Workers (paso a paso)

Cloudflare Workers ofrece un plan gratuito con 100.000 solicitudes al día. Es más que suficiente para la mayoría de los sitios. Todo lo que necesitas es una cuenta gratuita de Cloudflare.

Paso 1: Crea un Worker

Ve a la sección Workers & Pages de tu panel de Cloudflare y haz clic en Create application. Luego haz clic en Create Worker en la pestaña Workers. Dale a tu worker un nombre que no sugiera analítica. Algo como theme-assets o cdn-helper funciona bien. Haz clic en Deploy.

Crear Cloudflare Worker:

Desplegar Cloudflare Worker:

Paso 2: Añade el código del Worker (ES Modules)

Haz clic en Edit Code, borra el código por defecto y sustitúyelo por el código de abajo.

// Sustituye 'pa-XXXXX.js' por el ID de script específico de tu sitio
// Lo encuentras en Plausible: Site Settings → General → Data Snippets
const ProxyScript = 'https://plausible.io/js/pa-XXXXX.js';
const ScriptPath = '/theone/script';
const Endpoint = '/theone/event';

export default {
  async fetch(request, env, ctx) {
    ctx.passThroughOnException();
    const url = new URL(request.url);
    const pathname = url.pathname;

    if (pathname.startsWith(ScriptPath)) {
      return getScript(request, ctx);
    } else if (pathname === Endpoint) {
      return postData(request);
    }

    return new Response(null, { status: 404 });
  }
}

async function getScript(request, ctx) {
  let response = await caches.default.match(request);
  if (!response) {
    response = await fetch(ProxyScript);
    ctx.waitUntil(caches.default.put(request, response.clone()));
  }
  return response;
}

async function postData(request) {
  const req = new Request(request);
  req.headers.delete('cookie');
  return await fetch('https://plausible.io/api/event', req);
}

// Sustituye por tu dominio de Plausible autoalojado
const ProxyScript = 'https://plausible.yourdomain.com/js/pa-XXXXX.js';
const ScriptPath = '/theone/script';
const Endpoint = '/theone/event';

export default {
  async fetch(request, env, ctx) {
    ctx.passThroughOnException();
    const url = new URL(request.url);
    const pathname = url.pathname;

    if (pathname.startsWith(ScriptPath)) {
      return getScript(request, ctx);
    } else if (pathname === Endpoint) {
      return postData(request);
    }

    return new Response(null, { status: 404 });
  }
}

async function getScript(request, ctx) {
  let response = await caches.default.match(request);
  if (!response) {
    response = await fetch(ProxyScript);
    ctx.waitUntil(caches.default.put(request, response.clone()));
  }
  return response;
}

async function postData(request) {
  const req = new Request(request);
  req.headers.delete('cookie');
  return await fetch('https://plausible.yourdomain.com/api/event', req);
}

Editar Worker:

Añadir código:

Una vez añadido el código, haz clic en Save and Deploy arriba a la derecha.

Paso 3: Verifica que el Worker funciona

Prueba tu worker accediendo a él directamente:

https://your-worker-name.your-cloudflare-username.workers.dev/theone/script

Deberías ver código JavaScript como respuesta (el script de Plausible). Si obtienes un 404, comprueba que la variable ScriptPath de tu worker coincide con la ruta de URL que estás probando.

Paso 4: Ejecuta el proxy como un subdirectorio

Ejecutar el proxy bajo un subdirectorio de tu dominio principal (p. ej., example.com/theone/) es mejor que usar un subdominio separado. Mantiene las solicitudes como first-party, lo que evita restricciones de cookies y se ve más limpio en los logs de red.

Para configurarlo, añade una ruta de Worker en la sección Routes de los ajustes de tu Worker:

Route: *example.com/theone/*

Sustituye theone por el segmento de ruta que elegiste en el código del worker. Selecciona tu dominio en el desplegable de zona.

Paso 5: Añade el snippet de Plausible a tu sitio Astro

Añade este snippet al <head> de tu sitio Astro. En Astro, puedes colocarlo en tu archivo de layout principal (p. ej., src/layouts/Layout.astro):

<script async src="https://yourdomain.com/theone/pa-XXXXX.js"></script>
<script>
  window.plausible=window.plausible||function(){(plausible.q=plausible.q||[]).push(arguments)};
  plausible.init=plausible.init||function(i){plausible.o=i||{}};
  plausible.init({
    endpoint: "https://yourdomain.com/theone/event"
  })
</script>

Sustituye lo siguiente:

• yourdomain.com: el dominio real de tu sitio
• theone: la ruta del subdirectorio que configuraste en los pasos 2 y 4
• pa-XXXXX.js: el ID de script específico de tu sitio en Plausible (Site Settings → General → Data Snippets)

La URL de endpoint debe coincidir con la variable Endpoint de tu Worker, y el src del script debe coincidir con ScriptPath. La URL del script pasa por tu Worker (que sirve el script de Plausible en caché), y la URL del endpoint enruta los eventos de analítica a través de tu Worker hacia la API de Plausible.

Ya deberías tener Plausible Analytics funcionando a través de Cloudflare Workers, servido desde tu propio dominio.

Precios de Plausible (2025)

Plausible ofrece varios niveles en la nube. Todos los planes incluyen las funciones de analítica principales: páginas vistas, visitantes, tasa de rebote, duración de la visita, fuentes de referencia y más.

Hay niveles de páginas vistas superiores disponibles en cada plan. El plan Enterprise incluye un Managed Proxy donde Plausible gestiona el proxy por ti mediante un registro CNAME. No necesitas Worker.

Si quieres evitar por completo los precios de la nube, la Community Edition es gratuita.

Plausible Community Edition vs Cloud

Plausible Community Edition (CE) es una versión gratuita y autoalojada bajo licencia AGPL. Sigue un modelo open-core. CE incluye el motor de analítica principal, pero algunas funciones avanzadas son exclusivas de los planes Business y Enterprise de la nube.

Los precios de los VPS subieron en general en 2026: si estás reconsiderando un servidor alquilado, mira qué cambió y cuándo gana un mini PC.

Solución de problemas comunes

Novedades de Plausible desde 2023

Plausible ha lanzado muchas funciones desde que se publicó este artículo. Estas son las más destacadas:

Si también estás trabajando en el rendimiento de tu sitio Astro, consulta cómo optimizar la velocidad de build de Astro o migra Astro a Bun en Cloudflare para builds más rápidos.

Preguntas frecuentes