Analisador de Cabeçalhos de Cache

Analise cabeçalhos de cache HTTP para qualquer URL. Inspecione Cache-Control, Expires, ETag, Last-Modified, Vary, Age e sinais comuns de cache de CDN para entender o comportamento do navegador versus cache compartilhado. Inclui rastreamento de redirecionamentos, visualização de cabeçalhos brutos, filtragem, descobertas de problemas e exportação JSON/PDF.

Loading…

Sobre Analisador de Cabeçalhos de Cache

Cole uma URL e entenda instantaneamente como ela é armazenada em cache: diretivas do navegador, cache compartilhado de CDN/proxy (s-maxage, controles de substituto), validadores (ETag/Last-Modified) e padrões de revalidação (stale-while-revalidate, stale-if-error). Use para depurar desempenho, evitar cache acidental de HTML e verificar políticas de cache de ativos estáticos.

Funcionalidades

Auditoria de cache baseada em URL com cartão de pontuação claro + descobertas (foco em cabeçalhos de cache/desempenho).
Segue redirecionamentos (até 10) para ver onde as regras de cache realmente se aplicam.
Visualização de cabeçalhos brutos para total transparência (o que o servidor/CDN realmente retornou).
Destaques da análise de cache: diretivas Cache-Control, Expires/Pragma e conflitos.
Verificações de validador: detecção de ETag e Last-Modified (para solicitações condicionais e revalidação).
Análise Vary para capturar comportamento Vary ausente ou arriscado (especialmente para conteúdo personalizado).
Detecção de sinais de CDN: Age, Via, CF-Cache-Status, X-Cache, cabeçalhos no estilo Fastly/Akamai/CloudFront.
Filtros e modo “apenas problemas” para focar rapidamente em questões acionáveis.
Exporta resultados como relatórios JSON e PDF (ótimo para auditorias e entregas ao cliente).
Sondagem HEAD-first (fallback para GET) para minimizar largura de banda mantendo compatibilidade.

🧭 Como usar for cache-headers-analyzer

Insira a URL

Cole a URL completa que deseja auditar (ex.: [https://example.com/static/app.css](https://example.com/static/app.css)).

Escolha o comportamento da solicitação

Mantenha “Tentar HEAD primeiro (fallback para GET)” ativado para verificações rápidas. Ative “Seguir Redirecionamentos” se a URL puder redirecionar (HTTP→HTTPS, www, CDN, etc.).

Escolha um foco do analisador

Use “Auto (recomendado)” para uma visão equilibrada. Alterne para “Cache do navegador”, “Cache de CDN / proxy” ou “Cache de API” para priorizar as descobertas mais relevantes para seu endpoint.

Revise descobertas e categorias de cabeçalhos

Inspecione a pontuação/descobertas primeiro, depois detalhe as diretivas de cache, validadores (ETag/Last-Modified), análise Vary e sinais de CDN (Age, cabeçalhos de status de cache). Ative “Mostrar Cabeçalhos Brutos” se precisar da resposta completa.

Exporte um relatório

Baixe um relatório JSON para automação ou um relatório PDF para auditorias e compartilhamento com colegas/clientes.

Especificações técnicas

Modelo de solicitação

Esta ferramenta realiza uma inspeção de cabeçalhos de URL com seguimento opcional de redirecionamentos. Tenta uma solicitação HEAD primeiro (se ativado) e faz fallback para GET quando necessário.

Configuração	Comportamento	Padrão
Tentar HEAD primeiro (fallback para GET)	Usa HEAD para buscar cabeçalhos rapidamente; recorre ao GET se HEAD não for suportado ou for insuficiente	Ativado
Seguir Redirecionamentos	Segue a cadeia de redirecionamento para inspecionar o comportamento final de cache	Ativado
Máximo de Redirecionamentos	Limite de redirecionamentos para evitar loops infinitos	10 (intervalo 0–20)
Tempo Limite	Limite de tempo limite da requisição	15000 ms
User-Agent	Identifica o agente de usuário da requisição	Encode64Bot/1.0 (+[https://encode64.com](https://encode64.com))
Redes privadas	Bloqueia o acesso a intervalos de rede privada por segurança	Desativado (redes privadas não permitidas)

Cabeçalhos e sinais analisados

O analisador foca na semântica de cache (navegador e caches compartilhados) além de sinais comuns de borda de CDN.

Categoria	Exemplos
Diretivas de cache	Cache-Control, Expires, Pragma, Surrogate-Control, CDN-Cache-Control
Validadores	ETag, Last-Modified (usados para requisições condicionais / revalidação)
Comportamento de cache compartilhado	s-maxage, stale-while-revalidate, stale-if-error (quando presentes no Cache-Control)
Comportamento Vary	Vary (variações de chave de cache e segurança de personalização)
Sinais de CDN/proxy	Age, Via, CF-Cache-Status, X-Cache, X-Cache-Hits, Server-Timing e outras dicas de borda

Alguns cabeçalhos de CDN são específicos do fornecedor; a presença e o significado podem variar conforme o provedor e a configuração.

Heurísticas (o que aciona avisos)

As descobertas são derivadas de heurísticas práticas de cache para ajudar a identificar políticas de cache ausentes, contraditórias ou fracas.

Heurística	O que verifica
Cache-Control Ausente	Avisa quando Cache-Control está ausente
Diretivas conflitantes	Avisa quando as diretivas parecem inconsistentes (ex.: intenções de cache misturadas)
Validadores ausentes	Avisa quando respostas armazenáveis em cache não possuem ETag/Last-Modified
Validadores fracos	Sinaliza padrões de validadores fracos quando relevante
Risco de Vary	Avisa quando Vary parece ausente onde a variação é provavelmente necessária
Incompatibilidade de Pragma no-cache	Avisa quando Pragma: no-cache aparece sem o Cache-Control correspondente

Classificação (estático vs HTML vs API)

O analisador pode inferir a intenção do tipo de conteúdo a partir do caminho da URL para personalizar as recomendações de cache.

Classe	Padrões de caminho (exemplos)
Recurso estático	.css, .js, .png, .svg, .woff2, etc.
HTML	.html, .htm
API	Caminhos começando com /api/ ou terminando com .json

Se sua URL não corresponder a esses padrões, use o “Foco do Analisador” para direcionar as recomendações.

Linha de comando

Use estes trechos de CLI para inspecionar cabeçalhos de cache localmente. Eles não substituem as descobertas/pontuação desta ferramenta, mas ajudam você a reproduzir resultados rapidamente.

macOS / Linux

Buscar cabeçalhos com uma requisição HEAD

curl -I [https://example.com/static/app.css](https://example.com/static/app.css)

Verifica Cache-Control, Expires, ETag, Last-Modified, Vary e sinais de CDN sem baixar o corpo.

Seguir redirecionamentos e mostrar cabeçalhos

curl -IL [https://example.com/](https://example.com/)

Mostra a cadeia de redirecionamento para que você possa verificar onde as diretivas de cache mudam.

Run

Windows (PowerShell)

Obter cabeçalhos de resposta

(Invoke-WebRequest -Uri [https://example.com/static/app.css](https://example.com/static/app.css) -Method Head).Headers

Lista os cabeçalhos incluindo Cache-Control, ETag, Last-Modified e cabeçalhos de CDN do fornecedor, quando presentes.

Para recursos estáticos com nomes de arquivo com hash (app.abc123.css), prefira cache de longa duração com imutável. Para HTML, seja conservador para evitar servir páginas personalizadas desatualizadas.

Casos de uso

Auditoria de cache de recursos estáticos (CSS/JS/imagens/fontes)

Verifique se os recursos com impressão digital são armazenáveis em cache por um longo tempo e podem ser revalidados com eficiência quando necessário.

Confirme que Cache-Control inclui max-age longo e (quando apropriado) imutável
Garanta que validadores existam (ETag ou Last-Modified) para revalidação segura
Verifique indicadores de acerto de cache da CDN (Age, CF-Cache-Status, X-Cache)

Cache-Control: public, max-age=31536000, immutable
ETag: "686897696a7c876b7e"
Vary: Accept-Encoding

Evitar cache acidental de páginas HTML

Identifique casos em que páginas HTML são armazenadas em cache de forma muito agressiva no nível da CDN ou do navegador, o que pode quebrar fluxos de login, personalização e consistência de renderização para SEO.

Detecte Cache-Control excessivamente permissivo em HTML
Identifique Vary ausente onde o conteúdo difere por cookies, autenticação ou idioma
Confirme padrões de revalidação segura

Revisão de cache de endpoint de API

Entenda se caches compartilhados estão habilitados para respostas de API e se sua API é armazenável em cache com segurança.

Detecte cache compartilhado via s-maxage
Identifique estratégias stale-while-revalidate / stale-if-error
Sinalize validadores ausentes quando as respostas da API são armazenáveis em cache

Depurar comportamento da CDN em redirecionamentos

Muitos sites redirecionam (HTTP→HTTPS, apex→www, redirecionamentos de localidade). Esta ferramenta ajuda a garantir que as políticas de cache permaneçam consistentes desde o primeiro salto até a resposta final.

Verifique os cabeçalhos em cada salto e na URL final
Capture alterações de cabeçalhos de cache introduzidas por regras de borda ou reescritas de origem

❓ Frequently Asked Questions

❓Quais cabeçalhos esta ferramenta analisa para cache?

Ela se concentra na semântica e sinais de cache: Cache-Control, Expires, Pragma, Age, ETag, Last-Modified, Vary, além de indicadores comuns de CDN/proxy como Via, CF-Cache-Status, X-Cache e cabeçalhos de borda relacionados.

❓Por que vejo resultados de cache diferentes entre o navegador e a CDN?

Navegadores seguem diretivas de cache de ponta a ponta (Cache-Control, Expires), enquanto CDNs e proxies podem aplicar regras de cache compartilhado (s-maxage, Surrogate-Control) e políticas de borda. Uma resposta pode ser armazenável em cache na borda, mas de curta duração no navegador, ou o oposto.

❓Para que são usados ETag e Last-Modified?

Eles são validadores para solicitações condicionais. Com ETag (If-None-Match) ou Last-Modified (If-Modified-Since), clientes e caches podem revalidar recursos e receber um 304 Not Modified leve quando o conteúdo não foi alterado.

❓Devo armazenar páginas HTML em cache por um longo tempo?

Geralmente não. O HTML geralmente muda com frequência e pode ser personalizado. O cache agressivo pode servir conteúdo desatualizado ou errado. Prefira cache curto com revalidação e use regras Vary corretas quando o conteúdo depender de cabeçalhos/cookies.

❓O que é Vary e por que é importante?

Vary informa aos caches quais cabeçalhos de solicitação afetam a resposta (ex.: Accept-Encoding). Vary ausente ou incorreto pode fazer com que os caches sirvam a variante errada (comprimida vs não comprimida, variantes de idioma, etc.).

❓É seguro colar URLs aqui?

A ferramenta realiza solicitações do lado do servidor para a URL fornecida e bloqueia destinos de rede privada. Use URLs públicas em que você confia e evite colar segredos na string de consulta da URL.

❓Posso exportar a análise?

Sim. A ferramenta suporta a exportação de um relatório JSON e um relatório PDF para que possa partilhar os resultados ou anexá-los a auditorias de desempenho.

Pro Tips

Best Practice

Se os seus recursos têm impressão digital (hash no nome do ficheiro), use max-age longo + imutável para o melhor desempenho em visitas repetidas.

Best Practice

Se o HTML for personalizado (cookies/autenticação), evite cache em caches partilhados, a menos que controle totalmente a chave de cache e o comportamento Vary.

Best Practice

Prefira validadores (ETag ou Last-Modified) em recursos armazenáveis em cache para que os clientes possam revalidar com 304 em vez de fazer o download novamente.

Best Practice

Atenção a diretivas conflituosas como no-store misturado com max-age longo; isso geralmente indica má configuração.

Best Practice

Ao depurar redirecionamentos, compare os cabeçalhos de cache em cada etapa; regras de borda podem alterar o cache entre redirecionamentos e o URL final.

CI Tip

Exporte relatórios JSON e mantenha-os nos seus artefatos de CI/auditoria de desempenho para monitorar regressões ao longo do tempo.