# Plugin CDN para Magento 2

> Plugin open source para Magento 2 que invalida caché CDN automáticamente, sirve WebP/AVIF y precarga páginas con Speculation Rules. Instálalo gratis.

[Magento](https://es.wikipedia.org/wiki/Magento) es un Ferrari con ruedas cuadradas. Potencia de sobra bajo el capó (catálogo, *checkout*, EAV, indexación…todo el arsenal), pero en cuanto pisas el acelerador en producción, el [TTFB](https://docs.transparentedge.eu/getting-started/faq/time-to-first-byte-ttfb) te recuerda que las ruedas no son redondas. Una instalación típica sin CDN se mueve en los 800-2000 ms de [TTFB](https://www.transparentedge.eu/blog/velocidad-de-carga-web/). Puedes meterle Varnish local y mejora, sí, pero entonces te toca escribir [VCL a mano](https://docs.transparentedge.eu/config/vcl/varnish-book), mantenerlo, y encima el contenido sigue sin moverse de tu servidor de origen, así que si tu cliente está en Buenos Aires, va a notarlo. En el post de hoy abordamos cómo hemos desarrollado un *plugin* CDN para acelerar el TTFB de Magento 2, ¡al lío!

## Por qué desarrollar un *plugin* CDN para Magento 2

La mayoría de las CDN no resuelven el problema de raíz: o exigen que edites el *setup* tú mismo, o simplemente no hablan el idioma de Magento. Cuando un admin guarda un producto, la CDN no se entera. Sigue sirviendo la versión vieja hasta que expire el TTL o alguien haga un *purge* manual de todo el sitio, con el efecto secundario de tirar por la borda el caché de las 9.999 páginas que no habían cambiado.

Por ese motivo hicimos lo que hacen los frikis cuando algo les molesta de verdad: nos pusimos a arreglarlo. El resultado es el [*plugin* oficial de Transparent Edge para Magento 2](https://github.com/TransparentEdge/magento-transparentedge-cache), open source, MIT license, construido por gente que lleva tanto tiempo mirando *logs* de Varnish como debugueando *observers* de Magento. 

## Qué hace exactamente (y qué no te obliga a hacer)

El *plugin* se conecta al ciclo de vida de Magento (producto, categoría, CMS, bloque, precio, *reindex)* y traduce cada cambio en invalidaciones quirúrgicas hacia la CDN. Sin tocar VCL. Sin Varnish local. Sin que el admin de la tienda tenga que aprender qué es un *ban*. Instalas, configuras cuatro datos de conexión, y el *plugin* empieza a hablar con la CDN en tu nombre.

La instalación es vía composer require o copia manual del módulo (sin *scripts* raros ni dependencias exóticas). En el repositorio del *plugin* en GitHub tienes el nombre exacto del paquete y los pasos detallados.

![Pantallazo del repositorio del plugin CDN para Magento 2 en GitHub](https://www.transparentedge.eu/wp-content/uploads/2026/07/image-1024x579.png)

Tras la instalación, ya tienes 46 clases PHP con PSR-4 y *strict types* trabajando calladamente en segundo plano, repartidas en seis *observers* y tres *plugins* (interceptores AOP) que se enganchan a los eventos de Magento sin que el *core* se entere de que están ahí.

## Tres mejoras de rendimiento que introduce el plugin

### La joya de la corona: invalidación quirúrgica con Surrogate-Keys

Aquí es donde el *plugin* deja de ser otro conector de caché y se convierte en algo más. Cada respuesta HTTP de Magento sale con una cabecera Surrogate-Keys que etiqueta el contenido:

```
Surrogate-Keys: product-123 category-5 block-footer te-all
```

Cuando el admin guarda el producto 123, el *plugin* no dice «purga todo». Dice «purga product-123» y ya está. Las 9.999 páginas restantes del catálogo se quedan exactamente donde estaban: calientes, servidas desde el *edge*, sin pasar por origen.

Es la diferencia entre un cirujano y un martillo. El martillo también resuelve el problema, pero a costa de todo lo que había alrededor.

Y no es una promesa de folleto. En pruebas con un catálogo de 181 productos, una sola invalidación de producto generó 1.463 *tags* procesados en 15 *batches* de 100, en menos de 2 segundos. Quirúrgico, medido en milisegundos.

Para que esto no se descontrole, hay un umbral automático: si en una operación se acumulan más de 5.000 *tags*, el *plugin* decide por sí solo que ya no merece la pena ser fino y lanza un *full ban* en su lugar. Y hay 28 prefijos de *tags* filtrados (paycomet\_, payment\_, token\_, quote\_…) para no enviarle basura a la CDN que nunca debería cachearse de todas formas.

### Speculation Rules: la página carga antes de que hagas clic

Esta es la parte que más nos gusta enseñar en pantalla completa. El *plugin* genera automáticamente un JSON de [Speculation Rules](https://developer.chrome.com/docs/web-platform/prerender-pages) (soportado desde Chrome 109, Edge 120 y Safari 18) que le dice al navegador: «oye, cuando el usuario pase el ratón por este enlace, empieza a descargar la página ya, antes de que haga clic».

En modo Balanced, el *hover* sobre un producto dispara la precarga. Cuando el usuario hace clic de verdad, la página ya está ahí. Carga instantánea, sensación de app nativa, cero JavaScript adicional en el *frontend*. (Si quieres saber más de [Speculation Rules](https://www.transparentedge.eu/blog/speculation-rules-tu-web-anticipando-el-siguiente-clic/), tenemos un post con todo detalle)

En la versión 2.0.0 esto se ha vuelto contextual por tipo de página:

- En una PLP (listado de categoría), se prerenderizan los tres primeros productos visibles.
- En una PDP (ficha de producto), se prefetchea la categoría padre y los productos relacionados.
- En la home, se prerenderizan las categorías principales del menú.

El dato freak: este JSON se sirve desde un *endpoint* propio (/transparentedge/speculationRules/index) con Content-Type: application/speculationrules+json, y — aquí viene el *inception* — está cacheado en la propia CDN con su Surrogate-Key. Es decir, la CDN cachea las instrucciones para que el navegador use la CDN más rápido. Como en Matrix, pero con menos balas y más cabeceras HTTP.

Por seguridad, hay más de 40 exclusiones configuradas de fábrica: *checkout, customer,* pasarelas de pago, REST, GraphQL. Nada de precargar por accidente una página con datos sensibles del cliente.

### i3: WebP, Avif, marcas de agua, leyendas *custom*, y todo sin tocar un solo archivo

Vamos al caso de uso más frecuente, aunque puedes hacer mucho más. Las imágenes del catálogo se transforman a [WebP](https://docs.transparentedge.eu/config/i3/conversion-to-webp) o AVIF al vuelo, en el *edge*, según lo que soporte el navegador que las pide. No se generan copias en tu servidor, no cambian las URL, no hay impacto en SEO, no necesitas extensiones PHP nuevas. La imagen original se queda como está; la transformación ocurre en el momento de servirla.

Técnicamente, el *plugin* añade la cabecera TCDN-i3-transform: auto\_webp:85% en el VCL, y la negociación de formato se hace automáticamente a partir del Accept del navegador. Tú no decides el formato, lo decide el navegador de cada visitante.

## Herramientas para desarrolladores y sysadmins

### WPO: *hints* que el navegador te agradece sin que se lo pidas

Además de la imagen, el *plugin* analiza cada respuesta HTML y le añade automáticamente:

- \<link rel=»preload»\> para la imagen LCP, el CSS crítico y las *fonts* (entre 3 y 5 *hints* según la página)
- \<link rel=»dns-prefetch»\>  para dominios externos detectados (hasta 8)
- loading=»lazy» en iframes y vídeos

Todo esto sin JavaScript, sin tocar tu *theme*, sin meter mano en RequireJS. El HTML sale de Magento, pasa por el *plugin*, y llega al navegador ya optimizado.

### Redis, en un clic (con red de seguridad)

Si todavía estás con *file-based cache* en 2026, este panel es para ti. El *plugin* detecta Redis automáticamente — localhost, Docker, sockets Unix — te muestra versión y memoria, y activa Object Cache, FPC y Sessions con un solo clic. Antes de tocar nada, hace un *backup* automático de tu env.php, así que si algo sale mal tienes *rollback* instantáneo.

La auditoría de seguridad incluyó específicamente este módulo: protección contra SSRF en el Redis Manager, el client\_secret cifrado en base de datos, la *cookie* de admin con flag Secure, y *strip* de cabeceras internas en producción para que nadie vea de más.

### VCL Generator: copia y pega, funciona

Si nunca has escrito una línea de VCL, no pasa nada. El *plugin* genera el VCL completo para el [dashboard](https://docs.transparentedge.eu/getting-started/dashboard) de Transparent Edge: *bypass* del admin, limpieza de *cookies* en estáticos, eliminación de parámetros de *tracking* (UTM, gclid, fbclid), reglas [i3](https://www.transparentedge.eu/distribucion-de-contenidos-cdn/i3/) para imágenes, y los TTLs correctos para cada tipo de contenido.

Copias, pegas en el dashboard y despliegas. Ya está. 

```
sub vcl_recv {
    if (req.url ~ "^/admin") {
        return (pass);
    }
    # limpieza de parámetros de tracking
    set req.url = regsuball(req.url, "([?&])(utm_[a-z]+|gclid|fbclid)=[^&]+", "\1");
    set req.url = regsub(req.url, "[?&]$", "");
}
```

⚠️ El fragmento de arriba es solo ilustrativo del tipo de reglas que cubre, el VCL real lo genera el *plugin* según tu configuración.

### Modo Import: 700.000 productos sin pestañear

Si has hecho alguna vez un *import* masivo o un *reindex* completo sabes lo que pasa si tu integración con la CDN no está pensada para eso: miles de invalidaciones individuales, una API saturada, y un rato largo mirando el terminal con cara de circunstancias.

El *plugin* cache Magento 2 detecta automáticamente el contexto CLI (*imports, reindex*) y suspende las invalidaciones individuales mientras dura el proceso. Al terminar, lanza un único *ban* total. Nada de 700.000 llamadas a la API, nada de *overhead*, nada de saturar la CDN.

## Observabilidad: *health check* y *dashboard*

GET /transparentedge/status/health devuelve un JSON con el estado completo del *plugin*  (conexión con la CDN, *features* activas, *backend* de caché, versión) pensado para integrarse en Datadog, en *liveness probes* de Kubernetes, o en el sistema de monitorización que ya tengas montado.

Y para el día a día, hay un *widget* en la home del admin de Magento con el estado de la CDN, las *features* activas y accesos directos a configuración, *purge* y al dashboard de Transparent Edge. De un vistazo sabes si todo está funcionando, sin tener que entrar en ningún submenú.

## Cómo empezar a usar el *plugin* CDN para Magento 2

1. Instálalo desde el repositorio del *plugin* en GitHub: [https://github.com/TransparentEdge/magento-transparentedge-cache](https://github.com/TransparentEdge/magento-transparentedge-cache) 
2. Revisa la documentación de configuración
3. Si ya eres cliente de Transparent Edge, actívalo desde tu dashboard
4. Si tienes dudas técnicas o quieres ver una demo antes de meterlo en producción, escríbenos a [help+cdn@transparentedge.eu](mailto:help+cdn@transparentedge.eu)

![Pantallazo instalación completa plugin caché Magento 2](blob:https://www.transparentedge.eu/510a82f4-829d-4d91-8ca0-376878ba9a50)

¡Listo! Tu Magento ya tiene el motor. Esto son los neumáticos redondos.

[Oscar Dorrego](https://www.linkedin.com/in/odorrego/) es preventa en Transparent Edge.

> *Psicólogo de formación, informático de afición, preventa de profesión, new romantic de corazón. Hace tantas cosas que ya ni él se acuerda a qué se dedica realmente. Más mano izquierda que Nadal. Vivir a caballo entre negocio y tecnología le permite tener la mitad de alegrías y el doble de preocupaciones, pero es imposible hacer mella en el ánimo de nuestro encantador de serpientes favorito.*


---

Fuente: https://www.transparentedge.eu/blog/plugin-cdn-para-magento-2/
Actualizado: 2026-08-03
