Todos os produtos
Search
Central de documentação

:Modifique cabeçalhos de resposta recebidos

Última atualização: Jun 29, 2026

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.

image

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.

Cache-Control: max-age=3600

Content-Type

Especifica o tipo MIME do corpo da resposta.

Content-Type: application/x-www-form-urlencoded

Expires

Define uma data e hora após as quais a resposta é considerada expirada.

Expires: Wed, 21 Oct 2025 07:28:00 GMT

Last-Modified

Indica a data e a hora da última modificação do objeto solicitado.

Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT

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: Allow, Content-Encoding e Content-Length.

Nota
  • 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

  1. Faça login no console do DCDN.

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

  3. Na página Domain Names, localize o nome de domínio que deseja gerenciar e clique em Configure na coluna Actions.

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

  5. Clique em Modify Incoming Response Header.

  6. Na aba Modify Incoming Response Header, clique em Add.

  7. 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.

    Nota
    • Se você configurar várias operações para o mesmo cabeçalho de resposta, elas serão executadas na seguinte ordem de prioridade: Replace > Add > Modify > Delete. 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

      HTTP响应头

      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:key1 e depois x-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 key encontrado por uma expressão regular por abc em x-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.

  8. Clique em OK.