CDN:Modify incoming response headers

Contexto

Os cabeçalhos de resposta HTTP são componentes de uma resposta HTTP que transmitem parâmetros específicos ao cliente.

Quando o conteúdo solicitado por um usuário final não está em cache em um nó de CDN, a CDN busca o conteúdo na origem e o servidor de origem envia uma resposta. Você pode modificar os cabeçalhos HTTP nessa resposta de entrada. Por exemplo, é possível reescrever o valor do cabeçalho Content-Type antes de transmiti-lo ao cliente, para garantir a análise correta. Se o servidor de origem retornar um valor incorreto para Content-Type, o cliente pode não conseguir analisar o conteúdo corretamente. Resolva esse problema reescrevendo o cabeçalho na CDN.

Casos de uso

Veja a seguir os casos de uso e exemplos mais comuns:

• Tipo de conteúdo incorreto: Se o tipo de conteúdo (Content-Type) retornado pelo servidor de origem não corresponder ao conteúdo real, o cliente pode não conseguir analisá-lo corretamente. Por exemplo, um arquivo HTML pode ser marcado incorretamente como texto simples. configure o cabeçalho de resposta de origem para resolver esse problema.

  Exemplo: Altere Content-Type: text/plain para Content-Type: text/html.

• Controle da política de cache: Caso precise de um controle refinado sobre a política de cache da CDN, ajuste os campos Cache-Control ou Expires nos cabeçalhos de resposta do servidor de origem. Isso ajuda a otimizar a frequência de atualize do conteúdo e a taxa de acerto do cache.

  Exemplo: Altere Cache-Control: max-age=3600 para Cache-Control: max-age=86400 a fim de estender o tempo de expiração do cache. Para obter mais informações sobre as regras de cache padrão da CDN, consulte Alibaba Cloud CDN Default Cache Rules and Priorities.

• Cross-Origin Resource Sharing (CORS): Para permitir que aplicações web de outros domínios acessem recursos hospedados na CDN, configure o cabeçalho Access-Control-Allow-Origin e outros cabeçalhos CORS relacionados no servidor de origem. Essas configurações garantem que, quando um navegador envia uma solicitação de origem cruzada, a CDN possa fornecer os cabeçalhos de resposta adequados ao cliente, evitando erros de CORS. Para obter mais informações sobre problemas de acesso de origem cruzada, consulte Configure Cross-Origin Resource Sharing.

  Exemplos:

  • Access-Control-Allow-Origin: *: Permite solicitações de recursos de origem cruzada de todos os domínios.

  • Access-Control-Allow-Methods: GET, POST, OPTIONS: Especifica os métodos HTTP permitidos para solicitações de origem cruzada.

• Transferência compactada: Se o servidor de origem suportar transferência compactada, mas não a tiver ativado, ou se o algoritmo de compactação utilizado não for o mais eficiente, defina o Accept-Encoding no cabeçalho de resposta de retorno à origem para instruir o servidor de origem a usar o método de compactação ideal.

  Exemplo: Altere Accept-Encoding: gzip, deflate para Accept-Encoding: br para priorizar a compactação Brotli. Para obter mais informações, consulte Brotli Compression.

• Redirecionamento: Quando o servidor de origem precisa redirecionar um usuário para outra URL, defina os cabeçalhos de redirecionamento corretos no cabeçalho de resposta de origem. Para obter mais informações, consulte Configure 301/302 redirect following.

  Exemplo: Location: https://www.example.com/new-page.html: Notifica a CDN e o navegador do usuário sobre o novo local do recurso para redirecionamento 301 ou 302.

• Comportamento de origem personalizado: Talvez seja necessário adicionar cabeçalhos personalizados à resposta para implementar funções específicas ou para fins de rastreamento.

• Use variáveis para um controle de configuração refinado. Para obter mais informações, consulte Variable reference.

Observações

• O sistema executa as configurações de cima para baixo, na ordem em que aparecem na lista. Os efeitos são cumulativos. Se várias configurações modificarem o mesmo cabeçalho, a última tem precedência. No exemplo a seguir, a Configuração 2 é a que entra em vigor:

  • Configuração 1: Adicionar o cabeçalho de resposta HTTP: cache-control: max-age=3600

  • Configuração 2: Adicionar o cabeçalho de resposta HTTP: cache-control: no-cache

• Ao aplicar condições de regra, o sistema determina a correspondência com base na prioridade das condições, e não na ordem das configurações.

Procedimento

1. Faça login no CDN console.

2. No painel de navegação à esquerda, clique em Domain Names.

3. Na página Domain Names, encontre o nome de domínio de destino e clique em Manage na coluna Actions.

4. No painel de navegação do domínio, clique em Origin Fetch.

5. Clique na aba Modify Incoming Response Header.

6. Clique em Customize.

7. modifique as configurações do cabeçalho de resposta de entrada.

   Importante

   Se várias operações se aplicarem ao mesmo parâmetro de cabeçalho de resposta de origem, o sistema as executa com base na seguinte prioridade: Replace > Add > Change e Delete. Por exemplo, se uma operação de adição e uma de exclusão estiverem configuradas para o mesmo parâmetro, o sistema executa a operação de adição antes da de exclusão.

   Adicionar cabeçalho de resposta

   Parâmetro	Exemplo	Descrição
   Operation	add	Adiciona o cabeçalho de resposta especificado à resposta de origem.
   Response Header	Custom Response Header	Selecione Custom Response Header ou um parâmetro de cabeçalho de resposta predefinido.
   Header Name	x-code	Especifica o nome do cabeçalho de resposta personalizado.
   Header Value	key1	Insira um ou mais valores de cabeçalho, separados por vírgulas (,).
   	key1,key2
   Allow Duplicates	Allow	Yes: Permite adicionar cabeçalhos de resposta duplicados. Por exemplo, x-code:key1 e x-code:key2. No: Se já existir um cabeçalho com o mesmo nome, o novo valor substitui o existente. Por exemplo, se você adicionar x-code:key1 e depois x-code:key2, o cabeçalho final será x-code:key2.
   Rule Condition	Do not use	Uma condição de regra identifica várias informações de parâmetro em uma solicitação do usuário e determina se a configuração entra em vigor para essa solicitação. Do not use: Não utiliza condição de regra. Para adicionar ou edite condições de regra, gerencie-as no Rules Engine.

   exclua cabeçalho de resposta

   Parâmetro	Exemplo	Descrição
   Operation	exclua	Remove todos os cabeçalhos de resposta com o nome especificado, incluindo duplicatas.
   Response Header	Custom Response Header	Selecione Custom Response Header ou um parâmetro de cabeçalho de resposta predefinido.
   Header Name	x-code	Especifica o nome do cabeçalho de resposta personalizado a ser removido.
   Rule Condition	Do not use	Uma condição de regra identifica várias informações de parâmetro em uma solicitação do usuário e determina se a configuração entra em vigor para essa solicitação. Do not use: Não utiliza condição de regra. Para adicionar ou edite condições de regra, gerencie-as no Rules Engine.

   Modificar cabeçalho de resposta

   Parâmetro	Exemplo	Descrição
   Operation	modifique	Modifica o cabeçalho. Esta operação não é permitida se houver cabeçalhos duplicados com o mesmo nome.
   Response Header	Custom Response Header	Selecione Custom Response Header ou um parâmetro de cabeçalho de resposta predefinido.
   Header Name	x-code	Especifica o nome do cabeçalho de resposta personalizado a ser modificado.
   Change Value To	key1,key3	Especifica o novo valor do cabeçalho. Para configurar vários valores, separe-os por vírgulas (,).
   Rule Condition		Uma condição de regra identifica várias informações de parâmetro em uma solicitação do usuário e determina se a configuração entra em vigor para essa solicitação. Do not use: Não utiliza condição de regra. Para adicionar ou edite condições de regra, gerencie-as no Rules Engine.

   Substituir cabeçalho de resposta

   Parâmetro	Exemplo	Descrição
   Operation	replace	Substitui o valor do cabeçalho. Esta operação não é permitida se houver cabeçalhos duplicados com o mesmo nome.
   Response Header	Custom Response Header	Selecione Custom Response Header ou um parâmetro de cabeçalho de resposta predefinido.
   Header Name	x-code	Especifica o nome do cabeçalho de resposta personalizado que terá o valor substituído.
   Find	key	Expressão regular que corresponde à parte do valor do cabeçalho a ser substituída.
   Replace With	abc	Valor que substitui o texto correspondente.
   Match	Match All	Match All: Substitui todas as ocorrências que correspondem à expressão regular. Por exemplo, se o cabeçalho for x-code:key1,key2,key3 e você usar uma expressão regular para substituir o valor correspondente key por abc, o resultado é x-code:abc1,abc2,abc3. Match the First Only: Substitui apenas a primeira ocorrência que corresponde à expressão regular. Por exemplo, se o cabeçalho for x-code:key1,key2,key3 e você usar uma expressão regular para substituir o valor correspondente key por abc, o resultado é x-code:abc1,key2,key3.
   Rule Condition	-	Uma condição de regra especifica os critérios que uma solicitação do usuário deve atender para que a configuração seja aplicada. Do not use: Não utiliza condição de regra. Para adicionar ou edite condições de regra, acesse a página rule engine.

8. Clique em OK.

Cabeçalhos de resposta padrão

O Alibaba Cloud CDN define quatro cabeçalhos de resposta por padrão: Cache-Control, Content-Type, Expires e Last-Modified. Esses cabeçalhos essenciais do protocolo HTTP controlam o cache, definem os tipos de conteúdo, estabelecem tempos de expiração e registram a hora da última modificação dos recursos.

Exemplos de configuração

Perguntas frequentes

• Para perguntas sobre solução de problemas (CORS, caracteres ilegíveis, baixe/visualização, Set-Cookie, tipo MIME de JS, etc.), consulte Cache troubleshooting.

• Para perguntas de consultoria (verificação de ACAO de origem, configuração precisa de video/mp4, suporte a arquivos JS, status de sincronização de arquivos, etc.), consulte Origin fetch FAQ.