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.
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:
| Campo | O que significa |
|---|---|
| Caminho | Padrão de URL a cachar. Ex.: /imagens/*, /produtos, /blog/* |
| Duração da cache (TTL) | Quanto tempo guardar a cópia. Ex.: 3600 = 1 hora |
| Prioridade | Quando vários padrões coincidem, o número menor ganha |
| Variar por query string | Trata /produtos?cor=azul e /produtos?cor=verde como entradas diferentes |
| Variar por cookies | Trata cada cookie diferente como entrada diferente |
Sem regras = sem cache. Adicionas as regras conforme o site beneficiar.
O ciclo de uma resposta cacheada
- Pedido chega ao edge.
- Match: o edge verifica se há regra de cache para esse caminho.
- 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.
- 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 comSet-Cookienã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-cachena 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
- Duração da cache (TTL) — quanto tempo guardar.
- Variar por query string — para URLs com parâmetros.
- Compressão — outra forma de acelerar.