Saltar para o conteúdo

Cache na FortFox

A FortFox guarda cópias das respostas do teu site nos servidores edge. Visitantes seguintes recebem a cópia sem incomodar o teu servidor — mais rápido para eles, menos carga para ti.

5 min de leitura

A intuição

Imagina que o teu site tem uma página /sobre que demora 800 ms a gerar (consulta BD, render template, etc.):

Sem cache:

Visitante A pede /sobre → FortFox → Servidor (800 ms) → Resposta
Visitante B pede /sobre → FortFox → Servidor (800 ms) → Resposta
Visitante C pede /sobre → FortFox → Servidor (800 ms) → Resposta

3 visitas → 2400 ms de trabalho no servidor.

Com cache (TTL 1 hora):

Visitante A pede /sobre → FortFox → Servidor (800 ms) → Resposta + guarda cópia
Visitante B pede /sobre → FortFox tem cópia → 5 ms ao visitante
Visitante C pede /sobre → FortFox tem cópia → 5 ms ao visitante

3 visitas → 800 ms de trabalho no servidor + ms para os edges. Visitantes B e C recebem a página 160× mais rápido.

O que vale a pena cachar (e o que não)

Cacháveis:

  • Conteúdo estático: imagens, CSS, JavaScript, fontes. Quase sempre.
  • Páginas públicas que não mudam por utilizador: landing pages, "sobre nós", FAQ, blog.
  • Listagens públicas que mudam pouco: catálogo de produtos sem preço/stock por sessão.
  • Respostas de API públicas: dados que não dependem do utilizador.

NÃO cacháveis (mau cache!):

  • Páginas com conteúdo personalizado por sessão (dashboard, /minha-conta, cart). O visitante A não pode receber o dashboard do visitante B.
  • Endpoints de autenticação: /login, /logout.
  • Endpoints que alteram estado: POST, PUT, DELETE — quase nunca cacháveis.
  • Endpoints com query strings dinâmicas relevantes: depende da regra (ver Variar por query string).

Como funciona — regras de cache

A cache é controlada por regras, configuradas em Sites → site → Velocidade → Regras de cache. Cada regra tem:

CampoO que significa
CaminhoPadrão de URL a cachar. Ex.: /imagens/*, /produtos, /blog/*
Duração da cache (TTL)Quanto tempo guardar a cópia. Ex.: 3600 = 1 hora
PrioridadeQuando vários padrões coincidem, o número menor ganha
Variar por query stringTrata /produtos?cor=azul e /produtos?cor=verde como entradas diferentes
Variar por cookiesTrata cada cookie diferente como entrada diferente

Sem regras = sem cache. Adicionas as regras conforme o site beneficiar.

O ciclo de uma resposta cacheada

  1. Pedido chega ao edge.
  2. Match: o edge verifica se há regra de cache para esse caminho.
  3. Se sim:
    • Cache hit: cópia válida existe → devolve-a (latência ms).
    • Cache miss: não há cópia (ou expirou) → vai ao servidor.
  4. Origem responde → edge guarda a cópia → devolve ao visitante.

Próximos pedidos no mesmo caminho durante a TTL servem o hit.

Headers HTTP que controlam o cache

A FortFox respeita os headers padrão de cache enviados pelo servidor de origem:

  • Cache-Control: no-store → nunca cacha esta resposta, mesmo que haja regra.
  • Cache-Control: max-age=N → o servidor pediu que a TTL seja N segundos. A FortFox usa o mínimo entre este valor e o configurado na regra (defensivo).
  • Cache-Control: private → não cacha em edges partilhados (só permite cache no browser do visitante).
  • Set-Cookie: → por defeito, respostas com Set-Cookie não são cacheadas (o cookie pode ser único por utilizador).

Para opt-in à cache mesmo com cookies, ativas Variar por cookies na regra.

Cache hit rate

Em Atividade → Tráfego e desempenho vês a métrica Servido da cache (em %). É a fração de pedidos servidos sem ir ao servidor.

  • < 30%: cache mal configurada ou muito conteúdo dinâmico. Vê quais paths populares falham hit.
  • 30-60%: razoável para muitos sites. Páginas dinâmicas dominam.
  • 60-85%: bem configurada para um site típico.
  • > 85%: ótimo. Sites estáticos podem chegar a 95%+.

Invalidar (purgar) cache

Quando publicas conteúdo novo e queres que apareça imediatamente, sem esperar pela TTL:

  • Purga manual: Sites → site → Velocidade → Purgar cache (atualmente botão futuro; via API hoje).
  • Bypass por header: configura o servidor para devolver Cache-Control: no-cache na resposta específica.

Onde mexer

Sites → site → Velocidade → Regras de cache.

Em mais detalhe técnico

Storage: cache em disco no edge (default /var/cache/openresty). Tamanho por-site é proporcional ao plano; total por edge limitado a alguns % do disco para evitar exhaustion.

Cache key: por defeito é (scheme, host, path). Quando regras incluem Variar por query string, query string passa a fazer parte da key. Idem para Variar por cookies.

LRU eviction: quando o cache enche, entradas menos usadas são removidas primeiro. Não há TTL hard cap — uma entrada com TTL = 1 ano não é "imortal", pode ser despejada por LRU.

Stale-while-revalidate: experimental. Quando uma cache entry expira, o edge devolve a versão antiga ao visitante e em paralelo vai buscar uma fresca. Próximos pedidos durante o refresh já recebem a nova. Melhora latência percebida sem comprometer freshness.

Cross-edge sharing: cada edge tem cache própria (não há cache federada). Significa que a primeira request a um edge específico é sempre um miss. Para sites de tráfego baixo distribuído por vários edges, pode reduzir hit rate efetivo.

Compression no cache: respostas são descompressas ao serem armazenadas (a compressão é re-aplicada quando servidas, conforme o Accept-Encoding do visitante). Isto evita ter de armazenar variantes para gzip, br, deflate.

Headers no hit: a FortFox adiciona X-FortFox-Cache: HIT ou MISS à resposta. Útil para debug — curl -I mostra-te se algo está a hit.

Próximos passos

← Toda a documentação