Todos os produtos
Search
Central de documentação

:Configurar redirecionamento 301/302

Última atualização: Jun 29, 2026

O recurso de redirecionamento 301/302 aceita os códigos de status de resposta 301 e 302 do servidor de origem e os processa da mesma forma. Quando esse recurso está ativado, os pontos de presença (POPs) do CDNDCDN lidam diretamente com as respostas 301/302 do servidor de origem. Isso reduz a troca de dados e acelera a recuperação de recursos para os usuários.

Pré-requisitos

  • O servidor de origem utiliza o redirecionamento 301/302.

  • Você deve obter permissões para configurar o redirecionamento 301/302. Por padrão, essa funcionalidade não está disponível para usuários externos. Para solicitar permissões, envie um ticket.

Contexto

Os códigos 301 ou 302 são status HTTP que indicam a mudança de local de um recurso, tornando-o inacessível no endereço original. Para resolver isso, o servidor geralmente inclui um cabeçalho Location na resposta. Ao receber uma resposta 301/302 com esse cabeçalho, o cliente envia uma nova requisição para o endereço especificado no Location a fim de recuperar o recurso.

Como funciona

Se um POP redirecionar uma requisição para o servidor de origem e receber o código de status HTTP 301 ou 302, o próprio POP processará esse status. A requisição é redirecionada internamente para o endereço definido pelo cabeçalho Location retornado pelo servidor de origem para buscar o recurso. Nesse cenário, o código de status HTTP 301 ou 302 não retorna ao cliente.

image
  1. Um cliente solicita o arquivo http://example.com/examplefile.txt.

  2. Como o arquivo não está em cache no ponto de presença (POP) do CDNDCDN, o sistema envia uma requisição de retorno à origem.

  3. O servidor de origem retorna um código de status 301/302, com o cabeçalho Location apontando para http://www.example.org/examplefile.txt.

  4. Após receber a resposta do servidor de origem, o POP do CDNDCDN envia uma requisição para o endereço do Location http://www.example.org/examplefile.txt para recuperar o recurso.

  5. Depois que o ponto de presença (POP) do CDNDCDN obtém o recurso necessário, ele armazena o conteúdo em cache no POP do CDNDCDN.

  6. O POP do CDNDCDN entrega os recursos recuperados ao usuário.

Caso outros usuários solicitem http://example.com/examplefile.txt, o POP servirá o arquivo diretamente.

Observações de uso

Antes de configurar o redirecionamento 301/302 para um nome de domínio, verifique se há um host de origem configurado para ele. Para mais informações, consulte Configurar o host de origem padrão.

  • Se não houver um host de origem configurado para o domínio: quando o servidor de origem retornar o código de status HTTP 301 ou 302 e o cabeçalho Location especificando uma URL ao POP, a requisição será redirecionada para a URL indicada no Location. O valor do cabeçalho Host na requisição corresponderá ao nome de domínio especificado no cabeçalho Location.

  • Se houver um host de origem configurado para o domínio: quando o servidor de origem retornar o código de status HTTP 301 ou 302 e o cabeçalho Location especificando uma URL ao POP, o valor do cabeçalho Host na requisição será o mesmo configurado para o nome de domínio acelerado. Por padrão, esse valor é o próprio nome de domínio acelerado. Utilizar o nome de domínio especificado no cabeçalho Location como valor do cabeçalho Host na requisição de origem causará um erro. Caso precise que o Alibaba Cloud CDNDCDN aceite esse cenário, envie um ticket.

  • O cabeçalho Location retornado pelo servidor de origem pode ter os seguintes formatos:

    • Location: http://www.example.net/index.html. O POP redireciona a requisição para a URL completa especificada no cabeçalho Location.

    • Location: //www.example.net/index.html. O POP redireciona a requisição para uma URL composta pelo protocolo da requisição original combinado com o valor do cabeçalho Location.

    • Location: /index.html. O POP redireciona a requisição para uma URL formada pelo protocolo e nome de domínio da requisição original, acrescidos do valor do cabeçalho Location.

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 desejado e clique em Configure.

  4. Na árvore de navegação à esquerda do nome de domínio, clique em Origin Fetch.

  5. Na aba Origin Fetch, localize 301/302 Redirection.

  6. Ative a chave 301/302 Redirection.

  7. Clique em Modify e configure os parâmetros conforme a tabela a seguir.

    Parâmetro

    Descrição

    Maximum Number of Redirects

    Especifique o número máximo de vezes que um POP pode redirecionar para a URL definida no cabeçalho Location em cada requisição. Se esse limite for ultrapassado, o código de status HTTP 301 ou 302 retornará ao usuário. Valores válidos: 1 a 5. Valor padrão: 2.

    Nota

    O número máximo de redirecionamentos 301/302 determina quantas requisições de origem um POP pode redirecionar ao servidor de origem.

    Número máximo de requisições de origem = Número máximo de redirecionamentos 301/302 + 1. Nesse caso, o número máximo padrão de requisições de origem é 3. Valores válidos: 2 a 6.

    Retention Request Parameters

    • Yes: durante os redirecionamentos 301/302, os parâmetros das requisições enviadas ao servidor de origem são mantidos e repassados ao servidor indicado no cabeçalho Location.

    • No: durante os redirecionamentos 301/302, os parâmetros das requisições enviadas ao servidor de origem não são mantidos.

    Retain Request Headers

    • Yes: durante os redirecionamentos 301/302, os cabeçalhos das requisições enviadas ao servidor de origem são preservados e seus parâmetros são repassados ao servidor indicado no cabeçalho Location.

    • No: durante os redirecionamentos 301/302, os cabeçalhos das requisições enviadas ao servidor de origem não são preservados.

  8. Clique em OK.