Pular para o conteúdo
Aback Tools Logo

Construtor de cabeçalho de controle de cache CDN

Crie cabeçalhos Cache-Control para ativos compactados - define max-age, s-maxage, stale-while-revalidate e Vary: Accept-Encoding corretamente para entrega de CDN. Escolha entre cinco predefinições de tipo de ativo (ativos estáticos com hash de conteúdo, páginas HTML, APIs públicas, APIs privadas) ou configure todas as diretivas manualmente. O construtor de cabeçalho cdn cache-control gera snippets de configuração prontos para colar para Nginx, Apache, Cloudflare, AWS CloudFront, Fastly e Vercel - com avisos em tempo real para combinações de diretivas contraditórias. Toda a geração é executada no seu navegador - não é necessária inscrição.

CDN Cache-Control Header Builder

Build Cache-Control headers for compressed assets - sets max-age, s-maxage, stale-while-revalidate, and Vary correctly for CDN delivery. Choose an asset type preset or configure all options manually. Generates ready-to-paste server config snippets for Nginx, Apache, Cloudflare, CloudFront, Fastly, and Vercel.

Asset Type Preset

Cache Durations

Cache Directives

Vary Headers

Generated Headers

Cache-Control

Cache-Control: max-age=31536000, s-maxage=31536000, stale-if-error=86400, immutable

Vary

Vary: Accept-Encoding

Server / CDN Config Snippet

Nginx snippet

# Nginx - add to your server {} or location {} block
add_header Cache-Control "max-age=31536000, s-maxage=31536000, stale-if-error=86400, immutable";
add_header Vary "Accept-Encoding";
# For compressed assets, also add:
add_header Content-Encoding gzip;

Directive Reference

max-age - browser cache TTL in seconds

s-maxage - CDN/shared cache TTL (overrides max-age for CDNs)

stale-while-revalidate - serve stale while fetching fresh in background

stale-if-error - serve stale if origin returns 5xx error

immutable - skip revalidation during max-age (content-hashed assets only)

Vary: Accept-Encoding - required for CDNs to cache compressed variants separately

Por que usar nosso construtor de cabeçalho CDN Cache-Control?

  • Geração instantânea de cabeçalho de controle de cache: gere cabeçalhos de controle de cache corretos para ativos compactados instantaneamente - o construtor de cabeçalho de controle de cache cdn produz snippets de configuração de servidor prontos para colar para Nginx, Apache, Cloudflare, CloudFront, Fastly e Vercel com avisos de configuração incorreta em tempo real.
  • Construtor de cabeçalho de controle de cache CDN seguro online: toda a geração de cabeçalho é executada inteiramente em seu navegador. O construtor de cabeçalho cdn cache-control nunca envia sua configuração para qualquer servidor - seguro para construir cabeçalhos para APIs internas, endpoints autenticados e configurações proprietárias de CDN.
  • 5 predefinições de tipo de ativo + modo totalmente personalizado: escolha entre 5 predefinições testadas em batalha - ativos estáticos com hash de conteúdo, ativos versionados, páginas HTML, APIs públicas e APIs privadas - ou configure cada diretiva manualmente. O construtor de cabeçalho cdn cache-control define max-age, s-maxage, stale-while-revalidate e Vary corretamente para cada caso de uso.
  • 100% gratuito para sempre: o construtor de cabeçalho de controle de cache CDN é totalmente gratuito, sem inscrição, sem nível premium, sem limites e sem anúncios. Crie cabeçalhos Cache-Control para ativos ilimitados e configurações de CDN a custo zero, para sempre.

Casos de uso comuns para construtor de cabeçalho de controle de cache CDN

  • Cache de ativos estáticos com hash de conteúdo: crie cabeçalhos Cache-Control para JS, CSS e arquivos de imagem com hashes de conteúdo em seus nomes de arquivo - o construtor de cabeçalho cdn cache-control gera a combinação correta max-age=31536000, imutável, Vary: Accept-Encoding para cache CDN permanente com bloqueio instantâneo de cache na implantação.
  • Configuração de cache de página HTML: configure o Cache-Control para documentos HTML que precisam de cache CDN curto com obsoleto enquanto revalida para entrega rápida. O construtor de cabeçalho cdn cache-control define no-cache com s-maxage e stale-while-revalidate para que os CDNs sirvam HTML obsoleto instantaneamente enquanto buscam conteúdo novo em segundo plano.
  • Cache de resposta de API pública: gere cabeçalhos Cache-Control para endpoints de API JSON públicos que se beneficiam do cache de CDN. O construtor de cabeçalho cdn cache-control define a combinação correta de s-maxage, stale-while-revalidate e Vary: Accept-Encoding para que os CDNs armazenem em cache as respostas compactadas e descompactadas separadamente.
  • Cabeçalhos de endpoint privados/autenticados: crie cabeçalhos Cache-Control sem armazenamento para endpoints de API autenticados e respostas específicas do usuário. O construtor de cabeçalho cdn cache-control garante que respostas privadas nunca sejam armazenadas em cache por CDNs ou caches compartilhados - evitando que dados confidenciais sejam fornecidos ao usuário errado.
  • Configuração multi-CDN: gere snippets de configuração de servidor para Nginx, Apache, Cloudflare, AWS CloudFront, Fastly e Vercel a partir de um único conjunto de opções. O construtor de cabeçalho cdn cache-control elimina a necessidade de traduzir manualmente a semântica do Cache-Control para o formato de configuração de cada CDN.
  • Planejamento de estratégia obsoleto enquanto revalida: Configure durações obsoletas enquanto revalidam e obsoletas se houver erro para estratégias de cache de alta disponibilidade. O construtor de cabeçalho cdn cache-control mostra exatamente como essas diretivas interagem com max-age e s-maxage - com avisos para combinações contraditórias de diretivas.

O que é um construtor de cabeçalho de controle de cache CDN?

Um construtor de cabeçalho de controle de cache CDN gera os cabeçalhos de resposta Cache-Control e Vary HTTP corretos para ativos servidos por meio de um CDN - garantindo que os navegadores e os nós de borda do CDN armazenem as respostas corretamente. Para ativos compactados (GZIP ou Brotli), o cabeçalho Vary: Accept-Encoding é crítico - sem ele, os CDNs podem servir uma resposta compactada a um cliente que não oferece suporte à compactação, causando um erro de descompactação. O construtor de cabeçalho de controle de cache cdn define max-age (TTL do navegador), s-maxage (CDN TTL), obsoleto enquanto revalida (atualização em segundo plano) e obsoleto se erro (substituição de erro) corretamente para cada tipo de ativo.

Como funciona nosso construtor de cabeçalho de controle de cache CDN

  1. 1 Selecione uma predefinição de tipo de ativo: Escolha entre cinco predefinições: ativos estáticos com hash de conteúdo, ativos com controle de versão, páginas HTML, APIs públicas ou APIs privadas. Cada predefinição aplica a combinação correta de diretivas para esse caso de uso. Mude para Personalizado para configurar todas as opções manualmente.
  2. 2 Ajuste durações e diretivas: ajuste max-age, s-maxage, stale-while-revalidate e stale-if-error usando os seletores de duração. Alternar diretivas de cache (sem armazenamento, sem cache, revalidar, imutável) e cabeçalhos Vary. O construtor de cabeçalho cdn cache-control atualiza os cabeçalhos gerados instantaneamente e mostra avisos para combinações contraditórias.
  3. 3 Copie o cabeçalho e o snippet do servidor: Os valores gerados do cabeçalho Cache-Control e Vary são mostrados com botões de cópia de um clique. Selecione seu CDN ou servidor (Nginx, Apache, Cloudflare, CloudFront, Fastly, Vercel) para obter um snippet de configuração pronto para colar.

Principais diretivas de controle de cache para ativos compactados

  • Vary: Accept-Encoding: O cabeçalho mais importante para ativos compactados - diz aos CDNs para armazenar entradas de cache separadas para respostas compactadas (gzip/brotli) e descompactadas. Sem isso, um CDN pode armazenar em cache uma resposta gzip e servi-la a um cliente que não enviou nenhum cabeçalho Accept-Encoding, causando um download interrompido.
  • s-maxage vs max-age: s-maxage substitui max-age para caches compartilhados (CDNs, proxies) enquanto deixa o TTL do navegador inalterado. Use s-maxage para definir um TTL de CDN mais longo do que o TTL do navegador - por exemplo, max-age=0, s-maxage=86400 significa que os navegadores sempre revalidam, mas os CDNs são armazenados em cache por 24 horas.
  • stale-while-revalidate: permite que CDNs forneçam uma resposta obsoleta imediatamente enquanto buscam uma nova em segundo plano. Isso elimina o pico de latência quando uma resposta em cache expira – os usuários sempre obtêm uma resposta rápida e o cache é atualizado de forma assíncrona.
  • imutável: informa aos navegadores para não revalidar a resposta durante seu período máximo de idade, mesmo em recarga explícita. Use apenas com nomes de arquivos com hash de conteúdo (por exemplo, app.a1b2c3d4.js) - se o conteúdo mudar, o nome do arquivo deverá mudar para estourar o cache.

Erros comuns de controle de cache a serem evitados

O erro mais comum é definir Cache-Control: max-age=31536000 sem Vary: Accept-Encoding em ativos compactados - os CDNs armazenarão em cache apenas uma variante e poderão servir a variante errada. Outro erro comum é usar nomes de arquivos imutáveis ​​sem hash de conteúdo - se o arquivo mudar, mas a URL permanecer a mesma, os navegadores servirão a versão obsoleta em cache indefinidamente. O construtor de cabeçalho cdn cache-control detecta esses problemas e mostra avisos em tempo real. Sempre teste seus cabeçalhos Cache-Control com curl -I e verifique o comportamento do CDN com o inspetor de cache do seu CDN antes de implantar na produção.

Perguntas frequentes

Um construtor de cabeçalho de controle de cache CDN gera cabeçalhos de resposta HTTP Cache-Control e Vary corretos para ativos servidos por meio de um CDN. Nosso construtor de cabeçalho de controle de cache CDN online gratuito produz snippets de configuração de servidor prontos para colar para Nginx, Apache, Cloudflare, CloudFront, Fastly e Vercel. Toda a geração é executada no seu navegador sem necessidade de inscrição.

Sem Vary: Accept-Encoding, um CDN pode armazenar em cache uma resposta compactada com gzip e servi-la a um cliente que não enviou nenhum cabeçalho Accept-Encoding - causando um download interrompido. O cabeçalho Vary informa aos CDNs para armazenar entradas de cache separadas para variantes compactadas e descompactadas do mesmo URL.

Sim. Toda a geração de cabeçalho é executada inteiramente em seu navegador usando JavaScript. Nenhum dado de configuração é enviado a nenhum servidor, armazenado remotamente ou transmitido pela rede.

Sim - 100% grátis, para sempre. Sem inscrição, sem conta, sem nível premium, sem limites e sem anúncios.

max-age define o TTL do cache do navegador. s-maxage substitui max-age para caches compartilhados (CDNs, proxies) enquanto deixa o TTL do navegador inalterado. Use s-maxage para definir um TTL de CDN mais longo do que o TTL do navegador - por exemplo, max-age=0, s-maxage=86400 significa que os navegadores sempre revalidam, mas os CDNs são armazenados em cache por 24 horas.

Use imutável apenas com nomes de arquivos com hash de conteúdo (por exemplo, app.a1b2c3d4.js) e max-age=31536000. Ele diz aos navegadores para não revalidar durante a idade máxima, mesmo durante a recarga explícita. Nunca use imutável com URLs sem hash - se o conteúdo mudar, o nome do arquivo deverá mudar para estourar o cache.

stale-while-revalidate permite que os CDNs forneçam uma resposta obsoleta imediatamente enquanto buscam uma nova em segundo plano. Isto elimina o pico de latência quando uma resposta em cache expira. Use-o para páginas HTML e respostas de API onde uma resposta ligeiramente obsoleta é aceitável.

Use no-store para dados verdadeiramente confidenciais - evita qualquer armazenamento em cache, inclusive no navegador. Use no-cache para respostas que podem ser armazenadas em cache, mas sempre devem ser revalidadas. Para a maioria das APIs privadas, no-store é a escolha mais segura.

Teste com curl: curl -I https://yoursite.com/assets/app.js. Procure os cabeçalhos Cache-Control e Vary na resposta. Para o comportamento da CDN, verifique o cabeçalho de status do cache da sua CDN (Cloudflare: CF-Cache-Status, CloudFront: X-Cache). Sempre teste solicitações compactadas e descompactadas para verificar se Vary: Accept-Encoding está funcionando.