Variar verificador de cabeçalho
Analise os cabeçalhos HTTP Vary para entender o comportamento do cache com nosso Vary Header Checker gratuito. Insira qualquer valor de cabeçalho Vary e veja instantaneamente como cada cabeçalho afeta a eficiência, o desempenho e a segurança do cache. A ferramenta fornece explicações detalhadas cabeçalho por cabeçalho, detecta problemas críticos como Vary: * que desativa o cache, avisa sobre a falta de Vary: Origin com origens CORS dinâmicas e sinaliza cabeçalhos como User-Agent e Cookie que fragmentam seu cache. Opcionalmente, insira seu valor Access-Control-Allow-Origin para verificar se Vary: Origin está configurado corretamente. Não é necessária inscrição.
Quick Test Presets
Enter the Vary header value as a comma-separated list, or leave empty to check what happens when Vary is not set.
If your API uses a dynamic (non-wildcard) Access-Control-Allow-Origin, enter it here to check if Vary: Origin should be set.
Por que usar nosso verificador de cabeçalho Vary?
- Análise de impacto de cache cabeçalho por cabeçalho: cada cabeçalho no valor Vary obtém uma explicação detalhada de seu comportamento de cache. O Vary Header Checker identifica se o cabeçalho é para negociação de conteúdo (Accept, Accept-Language), CORS (Origin), adaptação de dispositivo (User-Agent, DPR) ou autenticação (Cookie, Authorization). Cada cabeçalho recebe uma classificação de impacto – alto, médio ou baixo – para que você possa ver quais deles fragmentam mais seu cache.
- Avaliações abrangentes de eficiência de cache: a ferramenta fornece três classificações distintas: eficiência de cache (quão bem sua configuração Vary preserva a capacidade de cache), desempenho (impacto nas taxas de acertos de cache) e segurança (se os cabeçalhos Vary relacionados ao CORS estão configurados corretamente). Cada classificação vem com descobertas práticas que mostram exatamente o que corrigir para melhorar sua estratégia de cache.
- Detecção de problemas críticos e avisos de práticas recomendadas: O Vary Header Checker detecta automaticamente problemas comuns de configuração. Ele sinaliza Vary: * que desativa todo o cache, avisa sobre Vary: User-Agent e Vary: Cookie que destroem taxas de acertos de cache, alerta quando Vary: Origin está faltando com origens CORS dinâmicas e sugere otimizações para configurações Vary excessivamente amplas com muitos cabeçalhos.
- Gratuito e sem necessidade de inscrição: verifique configurações ilimitadas de cabeçalho Vary sem inscrição, sem chave de API e sem limites de uso. Toda a análise acontece inteiramente no seu navegador - o texto do cabeçalho nunca sai do seu dispositivo. Não armazenamos, registramos ou processamos quaisquer dados em nossos servidores. Completamente grátis, para sempre.
Casos de uso comuns para análise de cabeçalho variável
- Auditoria de configuração de cache de CDN: engenheiros de DevOps e desenvolvedores de back-end podem usar o Vary Header Checker para auditar suas configurações de CDN e proxy reverso. Cole o cabeçalho Vary da sua API ou site e veja instantaneamente como isso afeta a capacidade de cache. A ferramenta identifica cabeçalhos que degradam o desempenho do CDN, como Vary: User-Agent ou configurações Vary excessivamente amplas, ajudando a otimizar as taxas de acertos do cache e reduzir a carga do servidor de origem.
- Validação de configuração de cache CORS: os desenvolvedores front-end que configuram CORS em suas APIs podem usar o Vary Header Checker para verificar se Vary: Origin está configurado corretamente junto com Access-Control-Allow-Origin. Quando uma API retorna uma origem dinâmica (não curinga), o cabeçalho Vary: Origin é essencial para evitar que CDNs sirvam respostas CORS armazenadas em cache para a origem solicitante errada.
- Revisão de otimização de desempenho: os engenheiros de desempenho que analisam os tempos de carregamento do site podem verificar o cabeçalho Vary para garantir que o cache não esteja sendo fragmentado desnecessariamente. O Vary Header Checker mostra quais cabeçalhos estão dividindo o cache e fornece recomendações específicas para reduzir a pegada Vary, permitindo taxas de acertos de cache mais altas e carregamentos de página mais rápidos.
- Verificação de configuração do gateway de API: as equipes que gerenciam gateways de API podem verificar se seu gateway não está adicionando cabeçalhos Vary desnecessários que fragmentam o cache. A ferramenta ajuda a identificar cabeçalhos que podem ter sido adicionados automaticamente por middleware, estruturas ou camadas de proxy e fornece orientação sobre como remover entradas desnecessárias do cabeçalho Vary.
- Cache de aplicativos multilocatário: plataformas SaaS que atendem a vários locatários da mesma infraestrutura precisam gerenciar cuidadosamente seus cabeçalhos Vary. O Vary Header Checker ajuda a validar configurações para configurações multilocatários, como Vary: X-Forwarded-Host para nomes de host específicos de locatários, garantindo a separação adequada do cache sem fragmentação excessiva.
- Diagnóstico de bug relacionado ao cache: quando os usuários relatam problemas com conteúdo desatualizado, versões de idioma incorretas ou erros de CORS, o cabeçalho Vary geralmente é o culpado. O Vary Header Checker ajuda a diagnosticar esses problemas mostrando exatamente quais cabeçalhos de solicitação estão afetando a resposta em cache, facilitando a determinação se um cabeçalho Vary ausente ou incorreto é a causa raiz.
O que é o cabeçalho Vary?
O cabeçalho de resposta HTTP Vary informa aos caches (navegadores, CDNs, proxies reversos) quais cabeçalhos de solicitação o servidor usou para gerar a resposta. Quando um cache vê um cabeçalho Vary: Accept-Encoding, ele sabe que a resposta pode diferir com base no cabeçalho de solicitação Accept-Encoding do cliente e deve armazenar em cache versões separadas para cada tipo de codificação. Sem o cabeçalho Vary, um cache pode servir uma resposta compactada com gzip para um cliente que não consegue lidar com ela, ou servir uma resposta adaptada para um idioma para um usuário que fala outro.
Como o cabeçalho Vary afeta o cache
- Criação de chave de cache: quando uma resposta inclui um cabeçalho Vary, o cache adiciona os cabeçalhos de solicitação especificados à sua chave de cache. Isso significa que o cache armazena várias versões do mesmo URL, cada uma codificada por diferentes combinações de cabeçalhos variados.
- Impacto na taxa de acertos do cache: cada cabeçalho adicionado a Vary multiplica o número de variantes armazenadas em cache. Por exemplo, Vary: Accept-Language com 10 idiomas suportados cria até 10 variantes em cache por URL. Adicionando Vary: o User-Agent pode criar milhares de variantes - uma para cada combinação exclusiva de navegador/dispositivo - destruindo efetivamente a taxa de acertos do cache.
- Variar: * comportamento: O valor curinga informa aos caches que a resposta varia com base em cada cabeçalho da solicitação. A maioria dos caches não consegue armazenar efetivamente as respostas com Vary: * e muitos CDNs ignoram totalmente o cache para essas respostas.
- Manipulação de CDN e navegador: caches diferentes têm manipulação Vary diferente. A maioria dos CDNs modernos respeita o Vary corretamente, mas quanto mais cabeçalhos você listar, mais espaço de cache será consumido e menor será a taxa de acertos.
Quando usar (e evitar) cabeçalhos variados específicos
- Vary: Accept-Encoding - Geralmente tratado automaticamente por CDNs. Muitas vezes redundante, mas de baixo impacto. Seguro para manter.
- Vary: Accept-Language - Necessário para sites multilíngues. Considere prefixos de idioma baseados em URL para melhor capacidade de armazenamento em cache.
- Vary: Origin - Obrigatório ao usar Access-Control-Allow-Origin dinâmico (não curinga). Essencial para a correção do CORS.
- Variar: User-Agent - Evitar. Cria milhares de variantes de cache. Use a detecção de dispositivos do lado do cliente.
- Variar: Cookie - Evitar em caches públicos. Cada usuário possui cookies exclusivos, tornando o cache ineficaz. Use endpoints separados para conteúdo autenticado.
- Variar: Autorização - Use somente com Cache-Control: private . Caches públicos nunca devem armazenar respostas autenticadas.
Considerações sobre privacidade e segurança
O Vary Header Checker processa todos os dados inteiramente no seu navegador. Os valores do cabeçalho Vary que você cola, a origem do CORS que você insere e os resultados da análise nunca saem do seu dispositivo. Nenhum dado é carregado, armazenado ou transmitido para qualquer servidor. Isso significa que você pode analisar com segurança cabeçalhos de APIs de produção, serviços internos ou ambientes de clientes, sem qualquer preocupação com a privacidade dos dados. Como tudo é executado no lado do cliente, também não há limites de uso, nem chaves de API são necessárias, e a ferramenta funciona mesmo quando você está offline após o carregamento inicial da página.
Perguntas frequentes
O cabeçalho de resposta HTTP Vary informa aos caches quais cabeçalhos de solicitação o servidor usou para gerar a resposta. Por exemplo, Vary: Accept-Encoding informa ao cache que a resposta pode diferir com base no cabeçalho Accept-Encoding do cliente, portanto, ele deve armazenar versões em cache separadas para cada tipo de codificação (gzip, br, etc.). Sem Vary, um cache pode servir uma resposta compactada a um cliente que não pode descompactá-la, ou servir uma resposta destinada a um idioma para um usuário que fala outro.
Variar: * informa ao cache que a resposta varia com base em cada cabeçalho de solicitação possível. Como cada solicitação HTTP possui combinações de cabeçalho exclusivas (diferentes valores de aceitação, diferentes agentes de usuário, diferentes cabeçalhos de conexão), o cache deve tratar cada solicitação como única e não pode servir nenhuma resposta armazenada em cache. A maioria dos CDNs e navegadores desativa efetivamente o cache para respostas com Vary: *. Em vez de usar Vary: *, especifique apenas os cabeçalhos que realmente afetam o conteúdo da sua resposta.
Use Vary: Origin sempre que seu servidor definir um cabeçalho Access-Control-Allow-Origin dinâmico (não curinga). Isso é comum em configurações CORS onde o servidor ecoa a origem solicitante. Sem Vary: Origin, um cache pode servir uma resposta CORS destinada a uma origem para uma origem diferente, o que pode causar problemas de segurança ou erros de CORS. Muitos provedores de CDN recomendam Vary: Origin para todos os endpoints habilitados para CORS.
Variar: o User-Agent informa ao cache para armazenar respostas separadas para cada string exclusiva do User-Agent. Como existem milhares de valores diferentes de User-Agent disponíveis (diferentes navegadores, versões, sistemas operacionais, dispositivos), isso cria um enorme número de variantes de cache e destrói as taxas de acertos do cache. Em vez de usar Vary: User-Agent, considere usar a detecção do lado do cliente com JavaScript ou use consultas de mídia CSS e técnicas de design responsivas.
O cabeçalho Vary impacta diretamente as taxas de acertos do cache CDN. Cada cabeçalho listado em Vary multiplica o número de variantes em cache que o CDN deve armazenar. Por exemplo, Vary: Accept-Language com 10 idiomas cria até 10x o armazenamento em cache. Variar: o User-Agent pode criar milhares de variantes. Mais variantes significam taxas de acerto mais baixas, mais solicitações de servidor de origem, tempos de resposta mais lentos e custos de CDN mais elevados. A regra geral é manter o cabeçalho Vary o menor possível.
Na maioria das configurações modernas, Vary: Accept-Encoding é tratado automaticamente por CDNs e proxies reversos. Muitos CDNs retiram o cabeçalho Vary para codificação de conteúdo e gerenciam a compactação de forma transparente. Se Vary: Accept-Encoding for o único cabeçalho em seu valor Vary, geralmente é redundante. No entanto, isso não afeta significativamente o cache porque existem apenas alguns valores de codificação comuns (identity, gzip, br, deflate).
Cache-Control informa aos caches por quanto tempo armazenar uma resposta e sob quais condições (público, privado, idade máxima, sem cache, etc.). Vary informa aos caches quais cabeçalhos de solicitação diferenciam as respostas armazenadas em cache. Eles trabalham juntos: Cache-Control determina se e por quanto tempo uma resposta é armazenada em cache, enquanto Vary determina quantas variantes dessa resposta são armazenadas. Uma resposta com Cache-Control: public, max-age=3600 e Vary: Accept-Encoding armazenará em cache uma variante por tipo de codificação por uma hora.
Sim! O Vary Header Checker é 100% gratuito, sem inscrição, sem chave de API e sem limites de uso. Verifique quantas configurações de cabeçalho Vary você precisar, com a freqüência necessária. Toda a análise acontece inteiramente no seu navegador - o valor do cabeçalho nunca sai do seu dispositivo. Não armazenamos, registramos ou processamos quaisquer dados em nossos servidores.