Todos os produtos
Search
Central de documentação

:Modifique cabeçalhos de requisição de saída

Última atualização: Jun 29, 2026

Por padrão, o Alibaba Cloud CDN e DCDN encaminham cabeçalhos de requisição, como os que contêm o endereço IP do cliente. Você também pode configurar cabeçalhos personalizados. Para reescrever cabeçalhos HTTP nas requisições à origem, modifique os cabeçalhos de requisição de saída. Esse recurso permite adicionar, excluir, alterar ou substituir cabeçalhos de requisição HTTP de origem para atender aos seus requisitos de negócios.

Pré-requisitos

Esse recurso não vem ativado por padrão. Para utilizá-lo em um domínio, envie um ticket para ativá-lo.

Contexto

Um cabeçalho de requisição HTTP faz parte de uma mensagem de requisição HTTP e transmite informações específicas de parâmetros a um servidor.

Quando um ponto de presença (POP) do CDN ou DCDN envia uma requisição a um servidor de origem para recuperar recursos, o servidor de origem acessa as informações no cabeçalho da requisição de origem. Use esse recurso para reescrever informações de cabeçalho HTTP nas requisições de origem e enviar parâmetros específicos ao seu servidor de origem.

Para saber como um servidor de origem obtém o endereço IP real do cliente a partir do cabeçalho X-Forwarded-For em uma requisição de origem, consulte Obter o endereço IP real de um cliente.

image

Observações de uso

  • Uma requisição de saída é uma mensagem HTTP enviada do CDNDCDN para um servidor de origem. Modificar a configuração de cabeçalho de requisição de saída afeta apenas as mensagens HTTP enviadas do CDNDCDN para um servidor de origem. Essa configuração não impacta as mensagens HTTP servidas diretamente dos POPs do CDNDCDN para os usuários.

  • Não é possível modificar cabeçalhos de requisição de saída para um nome de domínio curinga.

  • Se você configurar esse recurso com condições do mecanismo de regras, a ordem de execução seguirá a prioridade das condições da regra, e não a ordem de configuração do recurso.

  • Por padrão, o Alibaba Cloud CDN e DCDN incluem os seguintes cabeçalhos de requisição HTTP nas requisições de origem. Nenhuma configuração adicional é necessária.

    Cabeçalho HTTP de origem

    Descrição

    Exemplo

    Ali-Cdn-Real-Ip

    Endereço IP real do cliente conectado a um POP do CDN ou DCDN.

    Ali-Cdn-Real-Ip:192.168.0.1

    X-Forwarded-For

    Endereços IP do cliente e de todos os POPs intermediários do CDN ou DCDN no caminho da requisição de origem.

    X-Forwarded-For:192.168.0.1, 172.16.0.1

    X-Client-Scheme

    Protocolo da camada de aplicação, como HTTP ou HTTPS, usado pelo cliente para enviar uma requisição a um POP do CDN ou DCDN.

    X-Client-Scheme:http

    Host

    Nome de domínio do site de origem acessado pela requisição de origem.

    Host:example.com

    Via

    Nomes de todos os POPs do CDN ou DCDN pelos quais a requisição do cliente passou.

    Via:cn2546-10.l1, cache1.cn2546-10, l2cn2547-7.l2, cache1.l2cn2547-7

  • Se você definir o valor de um cabeçalho de requisição de saída como uma variável, o sistema resolverá a variável para seu valor real durante a execução. As seguintes variáveis estão disponíveis.

    Parâmetro

    Cabeçalho HTTP de origem

    Descrição

    Exemplo

    Ali-Cdn-Real-Port

    $http_Ali_Cdn_Real_Port

    Adiciona a porta real do cliente ao cabeçalho de requisição de origem para transmitir as informações da porta ao servidor de origem.

    Ali-Cdn-Real-Port:80

    Ali-Cdn-Real-Ip

    $http_Ali_Cdn_Real_Ip

    Inclui o endereço IP real do cliente no cabeçalho de requisição de origem para passar as informações de IP do cliente ao servidor de origem.

    Ali-Cdn-Real-Ip:192.168.0.1

    x_forwarded_for

    $proxy_add_x_forwarded_for

    Acrescenta o endereço IP do cliente e os endereços IP dos servidores proxy intermediários ao cabeçalho X-Forwarded-For para transmiti-los ao servidor de origem.

    X-Forwarded-For:192.168.0.1, 172.16.0.1

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 na aba Modify Outgoing Request Header.

  6. Na aba Modify Outgoing Request Header, clique em Add.

  7. Configure os parâmetros para modificação do cabeçalho.

    Importante

    Se houver múltiplas operações conflitantes direcionadas ao mesmo cabeçalho de requisição de origem, apenas aquela com a maior prioridade será executada. A ordem de prioridade, da mais alta para a mais baixa, é: Replace > Add > Change/Delete. Por exemplo, se você configurar uma operação Add e uma Delete para o mesmo cabeçalho, somente a operação Add será executada.

    Add request header

    Parameter

    Example

    Description

    Operation

    Add

    Adiciona o cabeçalho especificado às requisições HTTP de origem.

    Request header

    Custom header

    Selecione um cabeçalho de requisição predefinido ou escolha Custom header.

    Request header name

    x-code

    Nome do cabeçalho de requisição personalizado. Neste exemplo, x-code.

    Header value

    key1

    Especifique um ou mais valores. Separe múltiplos valores com vírgula (,).

    key1, key2

    Allow duplicates

    Yes

    • Yes: Permite adicionar cabeçalhos de requisição duplicados. Por exemplo, x-code:key1 e x-code:key2.

    • No: Se você adicionar um cabeçalho com o mesmo nome de um cabeçalho existente, o novo valor sobrescreverá o antigo. Por exemplo, se você adicionar primeiro x-code:key1 e depois x-code:key2, o cabeçalho final será x-code:key2.

    Delete request header

    Parameter

    Example

    Description

    Operation

    Delete

    Exclui todos os valores de cabeçalho correspondentes ao nome de cabeçalho especificado, incluindo quaisquer duplicatas.

    Request header

    Custom header

    Selecione um cabeçalho de requisição predefinido ou escolha Custom header.

    Request header name

    x-code

    Nome do cabeçalho de requisição personalizado. Neste exemplo, x-code.

    Change request header

    Parameter

    Example

    Description

    Operation

    Change

    Altera o valor de um cabeçalho. Essa operação não é permitida se existirem múltiplos cabeçalhos com o mesmo nome.

    Request header

    Custom header

    Selecione um cabeçalho de requisição predefinido ou escolha Custom header.

    Request header name

    x-code

    Nome do cabeçalho de requisição personalizado. Neste exemplo, x-code.

    Change to

    key1, key3

    Especifique um ou mais valores. Separe múltiplos valores com vírgula (,).

    Replace request header

    Parameter

    Example

    Description

    Operation

    Replace

    Substitui parte do valor de um cabeçalho usando uma expressão regular. Essa operação não é permitida se existirem múltiplos cabeçalhos com o mesmo nome.

    Request header

    Custom header

    Selecione um cabeçalho de requisição predefinido ou escolha Custom header.

    Request header name

    x-code

    Nome do cabeçalho de requisição personalizado. Neste exemplo, x-code.

    Find

    key

    Expressão regular para localizar o valor a ser substituído.

    Replace with

    abc

    String que substituirá o texto correspondente. Há suporte para referências anteriores de expressões regulares.

    Match

    Match All

    • Match All: Substitui todos os valores correspondentes. Por exemplo, ao substituir "key" por "abc" em x-code:key1,key2,key3, o resultado será x-code:abc1,abc2,abc3.

    • Match the First Only: Substitui apenas o primeiro valor correspondente. Por exemplo, ao substituir "key" por "abc" em x-code:key1,key2,key3, o resultado será x-code:abc1,key2,key3.

  8. Clique em OK.

API relacionada

BatchSetDcdnDomainConfigs