Para ignorar o cache do Edge Security Acceleration (ESA) em recursos correspondentes à regra de cache padrão, crie uma regra de filtragem de solicitações e defina Cache Eligibility como Bypass Cache.
Se não houver regras ou configurações de cache definidas, o armazenamento em cache nos pontos de presença (POPs) do ESA seguirá a regra de cache padrão.
Cenários
Se o servidor de origem possuir recursos que não devam permanecer em cache nos POPs do ESA, como conteúdo dinâmico que exige busca da versão mais recente na origem a cada solicitação, configure uma regra para ignorar o cache nesses recursos. Ignorar o cache para recursos dinâmicos melhora o desempenho de acesso.
As regras de elegibilidade de cache determinam se os nós de borda do ESA armazenarão uma solicitação. Os casos de uso comuns incluem:
Cache de recursos estáticos — Melhore o desempenho mantendo imagens, arquivos CSS e JavaScript em cache nos nós de borda.
Exclusão de conteúdo dinâmico — Garanta que páginas de login, APIs e conteúdo personalizado não fiquem em cache.
Separação entre dinâmico e estático — Mantenha ativos estáticos em cache e encaminhe solicitações dinâmicas diretamente ao servidor de origem.
Bloqueio seletivo de cache — Impeça o armazenamento em cache de arquivos ou caminhos específicos.
Procedimento
No console do ESA, escolha Websites. Na coluna Website, clique em no site desejado.
No painel de navegação à esquerda, escolha .
Clique em Create Rule e insira um Rule Name.
Na seção If requests match..., defina os atributos de correspondência da solicitação. Para mais informações sobre configuração de regras, consulte Composição de uma expressão de regra.
-
Na área Cache Eligibility , selecione uma política de cache e clique em OK.
Bypass Cache: Todas as solicitações ignoram o cache do POP e buscam dados diretamente na origem, permitindo visualizar os recursos mais recentes do servidor de origem em tempo real. Quando ativada, aplica-se apenas a configuração Browser Cache TTL.
Eligible for Cache: Os nós de cache do POP atendem a todas as solicitações elegíveis em vez da origem. Isso evita longos trajetos de busca na origem, reduz a latência e melhora o desempenho de acesso.
Opções e limitações de elegibilidade de cache
Bypass Cache
Ao selecionar Bypass Cache:
O sistema encaminha as solicitações correspondentes diretamente ao servidor de origem sem armazená-las nos nós de borda do ESA.
Apenas a configuração Browser Cache TTL tem efeito. Outros recursos relacionados a cache (como Cache Deception Defense e Serve Stale Content) ficam desativados para esta regra.
O ESA não oferece suporte à configuração de comportamento de não armazenamento em cache com base em cabeçalhos de resposta HTTP (como
X-Fallback) ou marcadores de comentários HTML. Utilize condições de correspondência baseadas em cabeçalhos de solicitação ou URL.
Comportamento padrão de cache
Sem regras de cache configuradas ou quando nenhuma regra corresponde a uma solicitação, o ESA aplica o seguinte comportamento padrão:
As solicitações seguem a política de cache padrão do ESA.
O sistema encaminha solicitações dinâmicas com URLs terminadas em
/ao servidor de origem por padrão.Se o servidor de origem retornar um cabeçalho de resposta
no-cache, a resposta não ficará em cache.
Recursos avançados de cache
Os seguintes recursos ficam desativados por padrão; ative-os manualmente em uma regra de cache:
Cache Deception Defense: Protege contra ataques de enganação de cache.
Serve Stale Content: Permite que o ESA entregue conteúdo obsoleto do cache quando a origem estiver temporariamente indisponível.
Exemplos comuns de configuração
Os exemplos a seguir abordam cenários frequentes de configuração de elegibilidade de cache.
Exemplo 1: Ignorar cache para APIs dinâmicas
Cenário: Impedir o armazenamento em cache de endpoints de API dinâmicos nos nós de borda.
Configuração:
Condição de correspondência: Caminho da URL contém
/api, OU caminho da URL contém/prod-api/, OU extensão de arquivo é igual aphpElegibilidade de cache: Bypass Cache
Ao especificar extensões de arquivo, não inclua o ponto. Insira php, e não .php.
Exemplo 2: Ignorar cache para páginas administrativas e de login
Cenário: Evitar o armazenamento em cache de páginas de administração do WordPress, interfaces de gerenciamento de CMS ou endpoints de login.
Configuração:
Condição de correspondência: Caminho da URL contém
/wp-admin, OU caminho da URL contém/admin, OU caminho da URL contém/loginElegibilidade de cache: Bypass Cache
Posicione esta regra no topo da lista para garantir prioridade sobre as regras gerais de cache de recursos estáticos.
Exemplo 3: Armazenar em cache o caminho raiz de SPA
Cenário: O ESA não armazena URLs sem extensão (como /) em cache por padrão. Para armazenar conteúdo text/html de aplicativos de página única (SPAs):
Configuração:
Condição de correspondência: Cabeçalho da solicitação
Acceptcontémtext/htmlElegibilidade de cache: Eligible for Cache
TTL de cache: Defina conforme a frequência de atualização da sua SPA.
Exemplo 4: Ignorar cache para arquivos específicos
Cenário: Impedir o armazenamento em cache de arquivos específicos, como sitemap.xml.
Configuração:
Condição de correspondência: Caminho da URL contém
sitemap(sem extensão de arquivo), OU extensão de arquivo é igual axml(insiraxml, e não.xml)Elegibilidade de cache: Bypass Cache
Exemplo 5: Separação entre dinâmico e estático
Cenário: Manter ativos estáticos em cache e garantir o encaminhamento de solicitações dinâmicas à origem.
Abordagem recomendada:
Exclua quaisquer regras de cache de site completo existentes.
Crie uma regra para armazenar recursos estáticos em cache. Por exemplo, configure a condição em que a extensão de arquivo é igual a uma das opções:
jpg,png,cssoujs.Crie uma regra separada para ignorar o cache em endpoints de API dinâmicos. Por exemplo, configure a condição em que o caminho da URL contém
/api.
Essa abordagem evita o armazenamento acidental de solicitações dinâmicas em cache.
Observações sobre configuração
Um TTL de cache por regra — Uma única regra de cache pode definir apenas um TTL de cache. Se diferentes extensões de arquivo ou diretórios exigirem durações distintas, crie uma regra separada para cada caso.
Independência das regras — Desativar ou excluir uma regra de cache específica não afeta o comportamento de cache de outros recursos. O ESA continua a avaliar as regras restantes em ordem.
Redução da carga na origem — Configure regras para ignorar cache em conteúdo dinâmico e ative regras de cache para recursos estáticos, minimizando assim as solicitações encaminhadas ao servidor de origem.
Perguntas frequentes
Por que minha regra para ignorar cache não está funcionando?
Verifique os seguintes pontos:
-
Condição de correspondência incorreta: Valide a expressão da regra. Erros comuns incluem:
Uma condição OR que acaba correspondendo involuntariamente a solicitações de outros domínios.
Valores de extensão de arquivo ou caminho formatados incorretamente. Por exemplo, usar
.phpem vez dephp.
Características da solicitação ausentes: Se a regra depender de um cabeçalho específico (como
sec-fetch-site), confirme se as solicitações reais dos clientes incluem esse cabeçalho.Prioridade insuficiente da regra: O ESA avalia as regras de cima para baixo. Se a regra para ignorar cache estiver posicionada abaixo de uma regra de cache com TTL longo, a regra anterior poderá corresponder primeiro. Mova a regra de ignorar cache para uma posição superior na lista.
Cache não limpo após alteração da regra: Após modificar as regras, limpe as URLs ou diretórios afetados no console do ESA. Atualizar o navegador não invalida o conteúdo armazenado em cache nos nós de borda.
Limitações do plano: A Edição Gratuita pode não garantir a aplicação consistente das regras. Considere atualizar para um plano pago.
Método de verificação: Verifique o cabeçalho de resposta
Serverpara confirmar se os nós de borda do ESA estão processando as solicitações. Use uma janela anônima do navegador para eliminar interferências do cache local.
Por que não consigo fazer login ou por que as páginas redirecionam incorretamente após ativar o ESA?
Causa: Isso geralmente ocorre quando uma regra de cache de site completo ou uma regra mal configurada faz com que cookies de login, dados de sessão ou respostas de API dinâmicas fiquem em cache nos nós de borda do ESA.
Resolução:
Suspenda ou exclua quaisquer regras suspeitas de cache de site completo.
Crie regras de Bypass Cache especificamente para páginas de login, endpoints de CAPTCHA e caminhos administrativos. Posicione essas regras no topo da lista para garantir a maior prioridade.
No console do ESA, limpe o cache das URLs afetadas.
Verifique a correção usando uma janela anônima do navegador.
Se o problema persistir mesmo com a configuração correta: Verifique a lógica de negócios do seu servidor de origem. Por exemplo, confirme se a lógica de redirecionamento 302 identifica corretamente o estado de login. Caso o servidor de origem não esteja lidando adequadamente com o estado de login, isso está fora do escopo do ESA.
Qual é a diferença entre "equals" e "contains" nas condições de correspondência?
|
Tipo de correspondência |
Comportamento |
|
Equals |
Correspondência exata do caminho de URL especificado. Também corresponde automaticamente a todos os subcaminhos. Por exemplo, configurar |
|
Contains |
Correspondência aproximada. Qualquer URL que inclua a string especificada em qualquer parte será correspondida. |
Para correspondência de nome de host, tanto Equals quanto Contains produzem resultados equivalentes e podem ser usados indistintamente.
Por que ativar regras de cache faz o teste de conexão ter sucesso, mas desativá-las causa tempos limite?
Quando as regras de cache estão ativas, os nós de borda do ESA atendem às solicitações diretamente do cache, reduzindo a carga no servidor de origem.
Ao desativar as regras de cache, todas as solicitações — incluindo um alto volume de requisições dinâmicas — vão diretamente ao servidor de origem em tempo real. Sob testes de carga de alta concorrência, isso pode sobrecarregar o servidor de origem e causar tempos limite nas solicitações.
Esse comportamento reflete um gargalo de desempenho no servidor de origem, e não um problema no ESA. Para resolver isso:
Configure regras de cache para reduzir o volume de solicitações encaminhadas à origem.
Ative o JS Challenge ou o Intelligent Rate Limiting para proteger o servidor de origem contra excesso de solicitações simultâneas.
Documentação relacionada
Os recursos relacionados a regras variam em prioridade efetiva, reentrância e granularidade. Para obter detalhes, consulte Propriedades de recursos relacionados a regras.