Após uma solicitação do usuário chegar ao servidor de origem por meio do DCDN, você pode modificar os cabeçalhos de resposta HTTP enviados pelo servidor. Esse recurso permite adicionar funcionalidades específicas ou garantir que as respostas estejam em conformidade com regras personalizadas, como políticas de cache, tipos MIME ou tempos de expiração.
Pré-requisitos
Esse recurso não vem ativado por padrão. Para utilizá-lo em um nome de domínio, envie um ticket para ativá-lo.
Contexto
Um cabeçalho de resposta HTTP (Hypertext Transfer Protocol) é um componente presente no cabeçalho de uma resposta HTTP. Ao modificar os cabeçalhos de resposta recebidos, você adiciona funcionalidades específicas à resposta. Um cabeçalho de resposta consiste em um nome, dois pontos (:) e um valor. Por exemplo, Cache-Control: no-cache.
O HTTP utiliza um modelo de solicitação-resposta. Quando um usuário envia uma solicitação, o DCDN a roteia até o servidor de origem, que então retorna uma resposta. Você pode modificar os cabeçalhos dessa resposta para implementar lógicas personalizadas. A figura a seguir ilustra esse processo.
A Alibaba Cloud oferece os seguintes parâmetros de cabeçalho de resposta para implementar as funcionalidades descritas na tabela abaixo.
|
Cabeçalho de resposta |
Descrição |
Exemplo |
|
Cache-Control |
Controla como os clientes e os pontos de presença (POPs) do DCDN armazenam o objeto em cache. Por exemplo, a diretiva max-age define a duração do cache em segundos. |
|
|
Content-Type |
Especifica o tipo MIME do corpo da resposta. |
|
|
Expires |
Define uma data e hora após as quais a resposta é considerada expirada. |
|
|
Last-Modified |
Indica a data e a hora da última modificação do objeto solicitado. |
|
|
Custom Response Header |
Caso os cabeçalhos padrão não atendam às suas necessidades, selecione Custom Response Header para definir nomes e valores de cabeçalho personalizados. |
Exemplos: |
Uma solicitação de retorno à origem é uma mensagem HTTP enviada de um ponto de presença (POP) do DCDN para um servidor de origem referente a um domínio acelerado específico.
As regras ativas aplicam-se a todas as respostas de recursos sob o domínio. Essas regras afetam apenas as respostas do servidor de origem para os POPs do DCDN, e não as respostas de um POP para um usuário.
Não há suporte para nomes de domínio com curinga.
Procedimento
Faça login no console do DCDN.
No painel de navegação à esquerda, clique em Domain Names.
Na página Domain Names, localize o nome de domínio que deseja gerenciar e clique em Configure na coluna Actions.
No painel de navegação do domínio, clique em Origin Fetch.
Clique em Modify Incoming Response Header.
Na aba Modify Incoming Response Header, clique em Add.
-
Configure a regra do cabeçalho de resposta recebido.
Você pode adicionar, substituir, modificar ou excluir cabeçalhos HTTP. Isso se aplica a cabeçalhos padrão, cabeçalhos adicionados anteriormente ou cabeçalhos desnecessários.
NotaSe você configurar várias operações para o mesmo cabeçalho de resposta, elas serão executadas na seguinte ordem de prioridade: . Por exemplo, se você configurar uma operação Add e uma Delete para o mesmo cabeçalho, o sistema primeiro adicionará e depois excluirá o cabeçalho.
Ao utilizar este recurso no mecanismo de regras, a prioridade da regra determina a ordem de execução, e não a prioridade da operação descrita neste tópico.
-
Adicionar um cabeçalho de resposta

Parâmetro
Exemplo
Descrição
Operação
Add
Adiciona o cabeçalho especificado à resposta do servidor de origem.
Parâmetro do Cabeçalho de Resposta
Custom Response Header
Selecione um parâmetro de cabeçalho predefinido na lista suspensa ou escolha Custom Response Header para configurar um parâmetro de cabeçalho personalizado.
Nome do Cabeçalho Personalizado
x-code
Define o nome do cabeçalho personalizado como x-code.
Valor do Cabeçalho
key1
Você pode especificar vários valores para um único cabeçalho. Separe os valores com vírgulas (,).
key1,key2
Permitir Duplicatas
Yes
Quando Allow Duplicates estiver definido como Allow, você pode definir valores diferentes para o parâmetro do cabeçalho de resposta. Por exemplo:
x-code:key1,x-code:key2.No
Quando Allow Duplicates estiver definido como Do not allow, o parâmetro do cabeçalho de resposta poderá ter apenas um valor único. Um novo valor substitui o anterior. Por exemplo, se você adicionar primeiro
x-code:key1e depoisx-code:key2, o valor final seráx-code:key2. -
Substituir um cabeçalho de resposta

Parâmetro
Exemplo
Descrição
Operação
Replace
A operação Replace só é permitida para cabeçalhos que aparecem uma única vez. Essa operação não é permitida se o cabeçalho especificado estiver duplicado.
Parâmetro do Cabeçalho de Resposta
Custom Response Header
Selecione um parâmetro de cabeçalho predefinido na lista suspensa ou escolha Custom Response Header para substituir um parâmetro de cabeçalho personalizado.
Nome do Cabeçalho Personalizado
x-code
Define o nome do cabeçalho personalizado como x-code.
Localizar
key
Uma expressão regular para localizar o conteúdo dentro do valor do cabeçalho que você deseja substituir.
Substituir Por
abc
O valor de substituição para o conteúdo correspondente.
Correspondência
Match All
Quando a opção Match estiver definida como Match All, todos os valores correspondentes serão substituídos. Por exemplo, se você substituir o valor
keyencontrado por uma expressão regular porabcemx-code:key1,key2,key3, o resultado seráx-code:abc1,abc2,abc3.Match the First Only
Quando a opção Match estiver definida como Match only the first, apenas o primeiro valor correspondente será substituído. Por exemplo, se você substituir o valor correspondente 'key' por 'abc' em
x-code:key1,key2,key3, o resultado seráx-code:abc1,key2,key3. -
Modificar um cabeçalho de resposta

Parâmetro
Exemplo
Descrição
Operação
Modify
A operação Modify só é permitida para cabeçalhos que aparecem uma única vez. Essa operação não é permitida se o cabeçalho especificado estiver duplicado.
Parâmetro do Cabeçalho de Resposta
Custom Response Header
Selecione um parâmetro de cabeçalho predefinido na lista suspensa ou escolha Custom Response Header para modificar um parâmetro de cabeçalho personalizado.
Nome do Cabeçalho Personalizado
x-code
Define o nome do cabeçalho personalizado como x-code.
Modificar Para
key1,key3
O novo valor para o cabeçalho. Você pode especificar vários valores, separados por vírgulas (,).
-
Excluir um cabeçalho de resposta

Parâmetro
Exemplo
Descrição
Operação
Delete
Exclui todas as instâncias do cabeçalho especificado, independentemente da existência de duplicatas.
Parâmetro do Cabeçalho de Resposta
Custom Response Header
Selecione um parâmetro de cabeçalho predefinido na lista suspensa ou escolha Custom Response Header para excluir um parâmetro de cabeçalho personalizado.
Nome do Cabeçalho Personalizado
x-code
Define o nome do cabeçalho personalizado como x-code.
Clique em OK.