Todos os produtos
Search
Central de documentação

CDN:Modificar cabeçalhos de requisição de saída

Última atualização: Oct 29, 2026

Por padrão, o Alibaba Cloud CDNDCDN oferece suporte ao encaminhamento de cabeçalhos de requisição, como aqueles 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 de origem, modifique os cabeçalhos de requisição de saída. Esse recurso permite que você adicione, exclua, altere ou substitua cabeçalhos de requisição HTTP de origem para atender aos seus requisitos de negócios.

Informações de contexto

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

Quando um ponto de presença (POP) da CDNDCDN envia uma requisição a um servidor de origem para recuperar recursos, o servidor de origem pode acessar as informações no cabeçalho da requisição de origem. Use este recurso para reescrever as 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 Obtain the real IP address of a client.

image

Notas de uso

  • Uma requisição de saída é uma mensagem HTTP que a CDNDCDN envia a um servidor de origem. A modificação da configuração do cabeçalho de requisição de saída afeta apenas as mensagens HTTP que a CDNDCDN envia a um servidor de origem. Essa configuração não afeta as mensagens HTTP que os POPs da CDNDCDN servem diretamente aos 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 este recurso com condições do mecanismo de regras, a prioridade das condições da regra determina a ordem de execução, e não a ordem de configuração do recurso.

  • Por padrão, o Alibaba Cloud CDN and DCDN inclui 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

    O endereço IP real do cliente que se conecta a um POP da CDN or DCDN.

    Ali-Cdn-Real-Ip:192.168.0.1

    X-Forwarded-For

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

    X-Forwarded-For:192.168.0.1, 172.16.0.1

    X-Client-Scheme

    O protocolo da camada de aplicação, como HTTP ou HTTPS, que um cliente usa para enviar uma requisição a um POP da CDN or DCDN.

    X-Client-Scheme:http

    Host

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

    Host:example.com

    Via

    Os nomes de todos os POPs da CDN or DCDN pelos quais a requisição do cliente passa.

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

  • Se você defina 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 em tempo de 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 da 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

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

    Ali-Cdn-Real-Ip:192.168.0.1

    x_forwarded_for

    $proxy_add_x_forwarded_for

    Anexa 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. Inicialmente, acesse o 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 guia Modify Outgoing Request Header.

  6. Clique em Customize.

  7. Em seguida, configure o cabeçalho de requisição de saída.

    Importante

    Se você configurar operações diferentes para o mesmo cabeçalho de requisição de origem, ocorrerá um conflito e o sistema executará a operação de maior prioridade. A ordem de prioridade é: Replace > Add > Change e Delete.

    Add header

    Parâmetro

    Exemplo

    Descrição

    Operation

    Add

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

    Request Header

    Custom Origin Request Header

    Selecione Custom Back-to-origin Request Headers ou um cabeçalho de requisição predefinido.

    Header Name

    x-code

    Neste campo, defina o nome do cabeçalho de requisição personalizado como x-code.

    Header Value

    key1, key2

    É possível configurar vários valores para um cabeçalho de requisição. Separe valores múltiplos com uma vírgula (,).

    Allow Duplicates

    Yes

    • Yes: Permite a adição de 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, o novo valor substituirá o existente. Por exemplo, se você adicionar primeiro x-code:key1 e depois x-code:key2, o valor final será x-code:key2.

    Rule Condition

    Do not use

    As condições de regra identificam vários parâmetros nas requisições do usuário para determinar se uma configuração se aplica a uma requisição específica.

    Importante

    Ao usar uma condição de regra, a correspondência usa como base a prioridade da condição de regra associada, e não a ordem de configuração do próprio recurso.

    • Do not use: Nenhuma condição de regra é usada.

    • Para adicionar ou edite uma condição de regra, acesse rules engine.

    Exclua o cabeçalho

    Parâmetro

    Exemplo

    Descrição

    Operation

    Exclua

    exclua todos os cabeçalhos que correspondem ao nome especificado, incluindo duplicatas.

    Request Header

    Custom Origin Request Header

    Selecione Custom Back-to-origin Request Headers ou um cabeçalho de requisição predefinido.

    Header Name

    x-code

    Neste campo, defina o nome do cabeçalho de requisição personalizado como x-code.

    Rule Condition

    Do not use

    Uma condição de regra identifica várias informações de parâmetros em uma requisição de usuário. Isso determina se uma configuração entra em vigor para essa requisição.

    • Do not use: Não usa uma condição de regra.

    • Para adicionar ou edite condições de regra, gerencie-as em Rules Engine.

    Change header

    Parâmetro

    Exemplo

    Descrição

    Operation

    Change

    Altera o valor de um cabeçalho. O sistema não permite esta operação se existirem cabeçalhos duplicados com o mesmo nome.

    Request Header

    Custom Origin Request Header

    Selecione Custom Back-to-origin Request Headers ou um cabeçalho de requisição predefinido.

    Header Name

    x-code

    Neste campo, defina o nome do cabeçalho de requisição personalizado como x-code.

    Change Value To

    key1, key3

    Configure vários valores para um cabeçalho de requisição. Separe os valores múltiplos com uma vírgula (,).

    Rule Condition

    Do not use

    Uma condição de regra identifica várias informações de parâmetros em uma requisição de usuário. Isso determina se uma configuração entra em vigor para essa requisição.

    • Do not use: Não usa uma condição de regra.

    • Para adicionar ou edite condições de regra, gerencie-as em Rules Engine.

    Replace header

    Parâmetro

    Exemplo

    Descrição

    Operation

    Replace

    Substitui o valor de um cabeçalho. O sistema não permite esta operação se existirem cabeçalhos duplicados com o mesmo nome.

    Request Header

    Custom Origin Request Header

    Selecione Custom Back-to-origin Request Headers ou um cabeçalho de requisição predefinido.

    Header Name

    x-code

    Neste campo, defina o nome do cabeçalho de requisição personalizado como x-code.

    Find

    key

    Uma expressão regular para encontrar o valor a ser substituído.

    Replace With

    abc

    O valor de substituição.

    Match

    Match All

    • Match All: Substitui todos os valores correspondentes. Por exemplo, para o cabeçalho x-code:key1,key2,key3, se você usar uma expressão regular para corresponder a "key" e substituí-la por "abc", o resultado será x-code:abc1,abc2,abc3.

    • Match the First Only: Substitui apenas o primeiro valor correspondente. Por exemplo, para o cabeçalho x-code:key1,key2,key3, se você usar uma expressão regular para corresponder a "key" e substituí-la por "abc", o resultado será x-code:abc1,key2,key3.

    Rule Condition

    Do not use

    Uma condição de regra identifica várias informações de parâmetros em uma requisição de usuário. Isso determina se uma configuração entra em vigor para essa requisição.

    • Do not use: Não usa uma condição de regra.

    • Para adicionar ou edite condições de regra, gerencie-as em Rules Engine.

  8. Clique em OK.