Ignorar Parâmetros

Ao ativar a opção de ignorar parâmetros, os nós de borda do CDN removem os parâmetros de consulta (a parte após o ?) das URLs de solicitação. Isso permite que solicitações com parâmetros diferentes acessem a mesma cópia em cache, melhorando a taxa de acerto do cache. Este tópico descreve como configurar a opção de ignorar parâmetros, compara essa funcionalidade com recursos alternativos e fornece orientações para solucionar problemas comuns.

Comparação e Seleção de Recursos

Custom Cache Key entra em conflito com a opção de ignorar parâmetros. Quando a opção de ignorar parâmetros está ativada, os nós de borda removem todos os parâmetros após ? na URL, o que invalida as configurações de parâmetros de solicitação definidas na configuração do Custom Cache Key. Desative a opção de ignorar parâmetros antes de usar o Custom Cache Key.

O Custom Cache Key pode substituir a opção de ignorar parâmetros na configuração da chave de cache e oferece funcionalidades mais abrangentes. Recomendamos usá-lo primeiro. Comparação das configurações:

Cenário	Configuração de Ignorar Parâmetros	Configuração do Custom Cache Key
Ignorar todos os parâmetros de solicitação na chave de cache	Defina Ignore Parameters como Yes e deixe Retain Specified Parameters vazio.	Adicione uma regra de tratamento de parâmetros de solicitação: Action: Retain Parameter name: defina como qualquer nome de parâmetro inexistente, como example-argument.
Manter apenas o parâmetro de solicitação key1 na chave de cache	Defina Ignore Parameters como Yes e defina Retain Specified Parameters como `key1`.	Adicione uma regra de tratamento de parâmetros de solicitação: Action: Retain Parameter name: key1
Excluir apenas o parâmetro de solicitação key1 da chave de cache	Exclua a configuração do parâmetro `key1`.	Adicione uma regra de tratamento de parâmetros de solicitação: Action: Delete Parameter name: key1

Rewrite Origin Parameters pode substituir a opção de ignorar parâmetros na reescrita de solicitações de origem e oferece funcionalidades mais abrangentes. Recomendamos usá-lo primeiro.

Visão Geral do Recurso

Função

Cenários

Remove os parâmetros de consulta (a parte após ?) das URLs de solicitação para que solicitações com parâmetros diferentes acessem o mesmo arquivo em cache. Isso melhora a taxa de acerto do cache e reduz o tráfego de retorno à origem.

Ative a opção de ignorar parâmetros quando os parâmetros da URL não estiverem relacionados ao conteúdo do recurso (como UID do usuário, fonte de referência ou códigos promocionais). Por exemplo, estas duas solicitações acessam o mesmo recurso, mas possuem UIDs diferentes:

Usuário A: http://example.com/1.jpg?uid=123***

Usuário B: http://example.com/1.jpg?uid=654***

Sem a opção de ignorar parâmetros, os nós de borda do CDN tratam essas solicitações como recursos diferentes e não conseguem compartilhar o mesmo cache, exigindo uma busca na origem para cada solicitação. Com a opção de ignorar parâmetros ativada, os nós de borda do CDN removem os parâmetros e usam http://example.com/1.jpg para localizar o cache.

Nota

A assinatura de URL tem precedência sobre a opção de ignorar parâmetros. A assinatura do tipo A inclui os parâmetros da URL em sua assinatura. O CDN executa a autenticação primeiro e armazena a réplica em cache somente após a validação bem-sucedida.

Manter Parâmetros de Origem

Função

Cenários

Mantém todos os parâmetros originais da URL durante as buscas na origem para garantir que o servidor de origem receba informações críticas do usuário.

Quando a opção de ignorar parâmetros está ativada, os nós de borda do CDN usam a URL sem parâmetros para buscar conteúdo na origem por padrão. No exemplo acima, tanto o Usuário A quanto o Usuário B acionariam uma solicitação de origem para http://example.com/1.jpg, perdendo informações críticas como o UID. Ativar a opção Manter Parâmetros de Origem garante que o CDN use a URL original para buscar conteúdo na origem, preservando parâmetros como o UID para o servidor de origem.

Procedimento

Faça login no CDN console.
No painel de navegação à esquerda, clique em Domain Names.
Na lista de domínios, clique no nome do domínio desejado. No painel de navegação à esquerda, clique em Optimization para acessar a página de configuração de otimização de desempenho.
Clique em Modify na seção Ignore Parameters. Selecione um modo e conclua a configuração conforme necessário.
Após concluir a configuração, clique em OK para salvar.

Importante

A troca de modos limpa as configurações existentes.
Após modificar a configuração de ignorar parâmetros, os arquivos em cache nos nós de borda não são atualizados automaticamente. Execute uma atualização de URL ou atualização de diretório no console para aplicar a nova configuração e limpar o cache antigo. Caso contrário, os usuários podem continuar acessando conteúdo armazenado em cache sob a política antiga, causando problemas de acesso.

Modo: Manter Parâmetros Especificados

Parâmetro	Descrição	Exemplo
Ignore Parameters	Yes: ative a opção de ignorar parâmetros para remover todos os parâmetros após `?` na URL. Nota Se você ativar Ignore Parameters mas deixar Retain Specified Parameters vazio, todos os parâmetros após `?` serão removidos. No: desative a opção de ignorar parâmetros para manter todos os parâmetros da URL.	Suponha que a URL original seja `http://example.com/1.jpg?key1=1&key2=2&key3=3`. Os resultados para cada configuração são os seguintes: Exemplo 1, ignorar todos os parâmetros, não manter parâmetros de origem: Configuração: Ignore Parameters=Yes, Retain Specified Parameters vazio, Retain Origin Parameters=No. Chave de cache: `http://example.com/1.jpg` URL de origem: `http://example.com/1.jpg` Exemplo 2, manter parâmetros especificados, não manter parâmetros de origem: Configuração: Ignore Parameters=Yes, Retain Specified Parameters=`key1`, Retain Origin Parameters=No. Chave de cache: `http://example.com/1.jpg?key1=1` URL de origem: `http://example.com/1.jpg?key1=1` Exemplo 3, ignorar todos os parâmetros, manter parâmetros de origem: Configuração: Ignore Parameters=Yes, Retain Specified Parameters vazio, Retain Origin Parameters=Yes. Chave de cache: `http://example.com/1.jpg` URL de origem: `http://example.com/1.jpg?key1=1&key2=2&key3=3` Exemplo 4, manter parâmetros especificados, manter parâmetros de origem: Configuração: Ignore Parameters=Yes, Retain Specified Parameters=`key1`, Retain Origin Parameters=Yes. Chave de cache: `http://example.com/1.jpg?key1=1` URL de origem: `http://example.com/1.jpg?key1=1&key2=2&key3=3`
Retain Specified Parameters	Insira os nomes dos parâmetros a serem mantidos. É possível especificar até 10 parâmetros, separados por vírgulas (,).
Retain Origin Parameters	Yes: mantém todos os parâmetros originais da URL durante as buscas na origem. No: durante as buscas na origem, inclui apenas os parâmetros consistentes com a chave de hash do cache (ou seja, os parâmetros mantidos).
Rule Condition	Uma condição de regra identifica diversas informações de parâmetros em uma solicitação do usuário. Isso determina se uma configuração entra em vigor para essa solicitação. Importante Ao referenciar condições de regra, elas são correspondidas com base na prioridade das condições de regra associadas, não na ordem de configuração do próprio recurso. Do not use: não utiliza uma condição de regra. Para adicionar ou editar condições de regra, gerencie-as no Rules Engine.

Modo: Excluir Parâmetros Especificados

Parâmetro	Descrição	Exemplo
Remove Specified Parameters	Insira os nomes dos parâmetros a serem excluídos. É possível especificar até 10 parâmetros, separados por espaços.	Suponha que a URL original seja `http://example.com/1.jpg?key1=1&key2=2&key3=3`. Os resultados para cada configuração são os seguintes: Exemplo 1, excluir parâmetros especificados, não manter parâmetros de origem: Configuração: Delete Specified Parameters=`key1`, Retain Origin Parameters=No. Chave de cache: `http://example.com/1.jpg?key2=2&key3=3` URL de origem: `http://example.com/1.jpg?key2=2&key3=3` Exemplo 2, excluir parâmetros especificados, manter parâmetros de origem: Configuração: Delete Specified Parameters=`key1`, Retain Origin Parameters=Yes. Chave de cache: `http://example.com/1.jpg?key2=2&key3=3` URL de origem: `http://example.com/1.jpg?key1=1&key2=2&key3=3`
Retain Origin Parameters	Yes: mantém todos os parâmetros originais da URL durante as buscas na origem. No: durante as buscas na origem, inclui apenas os parâmetros consistentes com a chave de hash do cache (ou seja, o resultado após a exclusão dos parâmetros especificados).
Rule Condition	Uma condição de regra identifica diversas informações de parâmetros em uma solicitação do usuário. Isso determina se uma configuração entra em vigor para essa solicitação. Importante Ao referenciar condições de regra, elas são correspondidas com base na prioridade das condições de regra associadas, não na ordem de configuração do próprio recurso. Do not use: não utiliza uma condição de regra. Para adicionar ou editar condições de regra, gerencie-as no Rules Engine.

Perguntas Frequentes

Como solucionar problemas de negócio após ativar a opção de ignorar parâmetros?

Após ativar a opção de ignorar parâmetros, o CDN trata solicitações com parâmetros diferentes como o mesmo recurso para armazenamento em cache. Não ignore globalmente os parâmetros da URL se eles se enquadram nestas categorias:

Identificadores de identidade do usuário (como UID, Token, Session ID): ignorá-los causa falhas de autenticação ou vazamento de dados entre usuários.
Diferenciação de conteúdo dinâmico (como números de versão ?v=1 ou paginação ?page=2): ignorá-los retorna conteúdo incorreto do cache.
Instruções de processamento da origem (como parâmetros de processamento de imagens do OSS x-oss-process): ignorá-los desativa o processamento e retorna o recurso original não processado.

Solução de problemas e resolução:

Exclua ou desative a configuração de Ignore Parameters.
Após modificar a configuração, execute uma limpeza de cache (atualização de URL ou atualização de diretório) para limpar o cache antigo dos nós de borda.
Se alguns parâmetros precisarem ser mantidos, use o modo Retain Specified Parameters para preservar parâmetros críticos (como x-oss-process ou token).

Por que a configuração de ignorar parâmetros não entra em vigor após a modificação?

Após modificar a configuração de ignorar parâmetros, os arquivos em cache nos nós de borda não são atualizados automaticamente. Se os problemas de acesso persistirem ou o tráfego de retorno à origem não diminuir, siga estas etapas:

Confirme que a configuração foi salva: faça login no console do CDN, revisite a página de configuração de ignorar parâmetros e verifique se as configurações atuais correspondem às suas expectativas.
Verifique conflitos com o Custom Cache Key: a opção de ignorar parâmetros e o Custom Cache Key não podem coexistir. Ativar a opção de ignorar parâmetros invalida as configurações de parâmetros de solicitação no Custom Cache Key. Garanta que ambos os recursos não estejam ativados simultaneamente.
Execute uma limpeza de cache: a nova configuração entra em vigor imediatamente, mas os arquivos existentes em cache ainda usam a política antiga. Execute uma atualização de URL ou atualização de diretório na página Refresh and Prefetch Resources para limpar o cache antigo e aplicar totalmente a nova configuração.
Verifique a configuração: use o comando curl -I "URL completa" para verificar o campo X-Cache no cabeçalho de resposta e confirmar se o status de acerto do cache corresponde ao esperado.

Como configurar a opção de ignorar parâmetros ao usar o processamento de imagens do OSS ou snapshots de vídeo?

Ao usar o processamento de imagens do OSS (como x-oss-process=image/resize,w_200) ou recursos de snapshot de vídeo, ativar a opção de ignorar parâmetros no domínio do CDN faz com que as URLs do recurso original e do recurso processado sejam armazenadas em cache como o mesmo arquivo, resultando em entrega de conteúdo incorreta.

Solução: na configuração de ignorar parâmetros do console do CDN, defina o parâmetro x-oss-process para o modo Retain Specified Parameters. Isso garante que as URLs com parâmetros de processamento de imagens sejam armazenadas em cache separadamente, evitando conflitos com o cache do recurso original.

Como usar a opção de ignorar parâmetros para lidar com solicitações que contornam o cache usando parâmetros de URL?

Quando invasores ou rastreadores adicionam parâmetros aleatórios sem significado (como ?timestamp=xxx ou ?random=xxx) para solicitar o mesmo recurso, o CDN trata cada solicitação parametrizada como um recurso exclusivo. Isso reduz a taxa de acerto do cache e aumenta o tráfego de retorno à origem.

Ative a opção de ignorar parâmetros (ou configure para ignorar todos os parâmetros) para que solicitações com parâmetros aleatórios diferentes acessem o mesmo cache, reduzindo efetivamente a pressão na origem. Por exemplo, após ativar a opção de ignorar parâmetros, estas solicitações acessam o mesmo cache:

http://example.com/page.html?t=123456
http://example.com/page.html?t=789012
http://example.com/page.html?random=abc

Com a opção de ignorar parâmetros ativada, todas essas solicitações usam http://example.com/page.html para localizar o cache, mitigando efetivamente ataques de contorno de cache por meio de parâmetros de URL.

Por que clientes diferentes mostram status de acerto de cache inconsistentes (X-Cache mostra MISS) após ativar a opção de ignorar parâmetros?

Possíveis causas:

A URL contém parâmetros de autenticação dinâmica não ignorados: se a URL incluir parâmetros como auth_key com valores diferentes por solicitação, o CDN os tratará como recursos diferentes mesmo com a opção de ignorar parâmetros ativada (se o parâmetro de autenticação não for mantido).
Primeiro acesso a um nó sem cache: o recurso ainda não foi armazenado em cache nesse nó de borda específico, portanto, o primeiro acesso sempre mostra MISS.
Diferenças nos cabeçalhos de solicitação do cliente: variações em cabeçalhos como Accept-Encoding ou User-Agent podem acionar múltiplas réplicas de cache (por exemplo, versões separadas Gzip e não-Gzip).
Conflito com o Custom Cache Key, causando ineficácia da configuração.

Método de solução de problemas: execute curl -I "URL completa" no cliente e compare os cabeçalhos de resposta X-Cache e X-Swift-CacheTime para confirmar o status do cache.

Solução: verifique se a opção de ignorar parâmetros está configurada corretamente (ativada e parâmetros críticos definidos para manter) e garanta políticas consistentes de cabeçalhos de solicitação do cliente.

Como controlar o CDN para buscar os recursos mais recentes durante lançamentos graduais ou atualizações de versão usando parâmetros de URL?

Se a opção de ignorar parâmetros estiver ativada, o CDN não consegue distinguir versões usando parâmetros de URL (como ?v=1 ou ?v=2). Use uma destas abordagens:

Abordagem 1 (recomendada): use nomes de arquivo com versão (como style.v2.css ou app.v2.js) em vez de depender exclusivamente de parâmetros de consulta para garantir que os usuários obtenham o conteúdo mais recente.
Abordagem 2: ao lançar uma nova versão, chame proativamente a API de atualização do CDN para limpar o cache antigo.