LiteSpeed Cache es una potente solución de caché que hace que tu tienda online Magento sea bastante más rápida. En esta guía te explicamos cómo configurar LiteMage.

¿Qué es LiteSpeed Cache?

LiteSpeed es un servidor web más rápido que Apache y Nginx. LiteMage es el módulo de caché específico para Magento que:

  • Sirve las páginas hasta 100x más rápido
  • Reduce el consumo de recursos del servidor
  • Mejora la experiencia de usuario
  • Mejora el posicionamiento SEO

Ventajas de LiteMage

Función Ventaja
Full Page Cache Carga instantánea de las páginas
Compatibilidad con ESI Bloques dinámicos en páginas en caché
Etiquetas de caché Invalidación inteligente de la caché
Hole punching Contenido personalizado
Crawler Precalentamiento automático de la caché

Requisitos

  • Servidor web LiteSpeed (disponible en el hosting de Theory7)
  • Magento 2.x
  • Acceso SSH para la instalación con Composer
  • Módulo LiteMage (gratuito para los usuarios de LiteSpeed)

Instalar LiteMage

Con Composer

# Ve a la raíz de Magento
cd /pad/naar/magento

# Instala el módulo
composer require litespeed/module-litemage

# Registra el módulo
bin/magento module:enable Litespeed_Litemage

# Actualiza el setup
bin/magento setup:upgrade

# Compila DI
bin/magento setup:di:compile

# Despliega el contenido estático
bin/magento setup:static-content:deploy nl_NL

# Vacía la caché
bin/magento cache:clean

Atención: si tu tienda está en modo developer o default, setup:static-content:deploy solo se ejecuta con la opción -f (force): bin/magento setup:static-content:deploy -f nl_NL. En modo production, -f no hace falta.

Comprobar el estado del módulo

bin/magento module:status | grep Litemage

Debe mostrar Litespeed_Litemage como enabled.

Configurar LiteMage

Configuración básica

  1. Ve a Stores > Configuration > LiteMage > LiteMage Configuration
  2. Configura los siguientes ajustes:

General Settings

  • Enable LiteMage: Yes
  • License Serial: déjalo vacío para la versión gratuita

Public Cache TTL

  • Default Page TTL: 86400 (24 h)
  • Product Page TTL: 86400
  • Category Page TTL: 86400
  • CMS Page TTL: 86400

Private Cache TTL

  • Private Cache TTL: 1800 (30 minutos)
  1. Haz clic en Save Config

Ajustes avanzados

Cache Warmup

  • Enable Warm Up: Yes
  • Warmup Priorities: configúralas por tipo de página
  • Concurrent Threads: 2-4

ESI (Edge Side Includes)

  • ESI se configura automáticamente
  • Controla los bloques dinámicos en las páginas estáticas
  • Es esencial para el carrito y el estado de inicio de sesión

Comprobar que la caché funciona

Desde el navegador

  1. Abre tu sitio web
  2. Abre las herramientas para desarrolladores (F12)
  3. Ve a la pestaña Network
  4. Actualiza la página
  5. Comprueba las cabeceras de respuesta:
    • X-LiteSpeed-Cache: hit = página servida desde la caché
    • X-LiteSpeed-Cache: miss = página generada

Desde la línea de comandos

curl -I https://example.nl

Busca la cabecera X-LiteSpeed-Cache.

Gestionar la caché

Vaciar la caché desde Admin

  1. Ve a System > Cache Management
  2. Marca Page Cache
  3. Haz clic en Flush

Vaciar la caché desde la CLI

# Todo
bin/magento cache:clean
bin/magento cache:flush

# Solo la full page cache (LiteMage)
bin/magento cache:clean full_page

Purgado selectivo

# Un producto (ID 1)
bin/magento cache:litemage:flush:prods 1

# Una categoría (ID 3)
bin/magento cache:litemage:flush:cats 3

# Por etiqueta de caché (cat_p_1 = producto con ID 1)
bin/magento cache:litemage:flush:tags cat_p_1

No se puede purgar una URL suelta desde la CLI; en ese caso, purga por producto, categoría o etiqueta.

Exclusiones de la caché

Algunas páginas deben quedar fuera de la caché:

Desde la configuración

  1. Ve a Stores > Configuration > LiteMage > LiteMage Configuration
  2. En Do Not Cache URLs: 
    /checkout/*
/customer/*
/catalogsearch/*

Con .htaccess

<IfModule LiteSpeed>
    RewriteRule ^checkout/.* - [E=cache-control:no-cache]
    RewriteRule ^customer/.* - [E=cache-control:no-cache]
</IfModule>

Optimización del rendimiento

Caché del navegador

Asegúrate de que los recursos estáticos se guardan en caché durante mucho tiempo:

<IfModule mod_expires.c>
    ExpiresActive On
    ExpiresByType image/jpeg "access plus 1 year"
    ExpiresByType image/png "access plus 1 year"
    ExpiresByType text/css "access plus 1 month"
    ExpiresByType application/javascript "access plus 1 month"
</IfModule>

Compresión GZIP

LiteSpeed comprime automáticamente, pero compruébalo:

<IfModule LiteSpeed>
    CacheEnable public /
</IfModule>

HTTP/2 Push

LiteSpeed es compatible con HTTP/2 Server Push para los recursos críticos.

Solución de problemas

La caché no funciona

  1. Comprueba si LiteSpeed está activo (pregunta a soporte)
  2. Verifica el estado del módulo: bin/magento module:status
  3. Revisa la configuración en Admin
  4. Consulta los registros de LiteSpeed
  5. Comprueba que la página no contenga ningún bloque marcado como no almacenable en caché (cacheable="false" en el XML de layout de tu tema o de una extensión). Un solo bloque así hace que toda la página deje de poder almacenarse en caché.

«Hit», pero la página va lenta

  • Es posible que los bloques ESI sean lentos
  • Revisa las consultas a la base de datos
  • Verifica los ajustes de caché de Magento

La invalidación de la caché no funciona

  1. Revisa la configuración de las etiquetas de caché
  2. Verifica los webhooks
  3. Purga manualmente y vuelve a probar

Conflictos con Varnish

No uses ambos a la vez:

  1. Desactiva Varnish en Magento
  2. Confía en LiteSpeed para la full page cache

Buenas prácticas

  1. Supervisa el rendimiento: usa GTmetrix o WebPageTest
  2. Rastrea con regularidad: mantén la caché caliente
  3. Prueba las exclusiones: asegúrate de que el checkout no se guarda en caché
  4. Analiza los registros: revisa los registros de LiteSpeed en busca de problemas
  5. Actualiza con regularidad: mantén actualizado el módulo LiteMage