Todos os produtos
Search
Central de documentação

CDN:Configurar redirecionamento 301/302

Última atualização: Aug 03, 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 interação de dados e acelera a recuperação de recursos para os usuários.

Pré-requisitos

Seu servidor de origem usa redirecionamentos 301/302 para implementar a lógica de negócios.

Contexto

Os códigos 301 ou 302 são status HTTP que indicam a movimentação de um recurso, tornando-o inacessível no local solicitado. Para lidar com essa situação, 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 ao endereço especificado para recuperar o recurso.

Como funciona

O redirecionamento 301/302 ocorre quando um ponto de presença (POP) do CDNDCDN recebe um código de status 301/302 do servidor de origem em resposta a uma requisição de retorno à origem. Nesse cenário, o POP do CDNDCDN segue diretamente o endereço Location para buscar o recurso, em vez de retornar o código de status 301/302 ao usuário.

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 ao endereço Location http://www.example.org/examplefile.txt para recuperar o recurso.

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

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

Nesse momento, se outro usuário solicitar o arquivo http://example.com/examplefile.txt, a requisição atingirá diretamente o cache no ponto de presença (POP) do CDN DCDN e o sistema retornará o arquivo ao usuário.

Observações de uso

Antes de configure o redirecionamento 301/302, certifique-se de que o CDNDCDN esteja configurado com um default origin host ou um specific origin host:

  • Se nenhum host de origem padrão ou específico estiver configurado: Quando o servidor de origem responde a um POP do CDNDCDN com um código de status 301/302 e uma URL Location, o cabeçalho Host da requisição de retorno à origem usa o nome de domínio presente na URL Location.

  • Se um host de origem padrão estiver configurado: Caso o servidor de origem responda a um ponto de presença (POP) do CDNDCDN com um código de status 301/302 e uma URL Location, a requisição de retorno à origem usa o cabeçalho Host definido no CDNDCDN. Se o servidor de origem exigir o uso do nome de domínio da URL Location como Host de retorno à origem, utilize o recurso specific origin host.

O cabeçalho Location na resposta do servidor de origem para um ponto de presença (POP) do CDNDCDN aceita os três formatos a seguir:

  1. Location: http://www.example.net/index.html: O ponto de presença (POP) do CDNDCDN usa a URL completa fornecida no cabeçalho Location.

  2. Location: //www.example.net/index.htmL: O POP do CDNDCDN combina o protocolo da requisição de retorno à origem com as informações do cabeçalho Location para formar uma URL.

  3. Location: /index.html: O POP do CDNDCDN constrói a URL concatenando o protocolo e o nome de domínio da requisição original de retorno à origem com o valor indicado no cabeçalho Location.

Procedimento

  1. Faça login no CDN console.

  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 gerencie e clique em Manage na coluna Actions.

  4. Clique em Origin Fetch. Na aba Configurations, encontre a seção 301/302 Redirection e ative a chave.

  5. Na caixa de diálogo exibida, configure os parâmetros e clique em OK.

    Parâmetro

    Descrição

    Maximum 301/302 Redirects

    Define o número máximo de vezes que um ponto de presença (POP) do CDN pode seguir um redirecionamento durante uma única requisição de usuário. Se esse limite for excedido, o POP retornará diretamente um código de status 301 ou 302 ao usuário. O valor padrão é 2, com intervalo válido de 1 a 5.

    Nota

    A configuração de Maximum 301/302 Redirects afeta o número máximo de requisições de retorno à origem. Esse valor representa quantas vezes um nó do CDN pode acessar o servidor de origem durante uma única requisição de usuário.

    A fórmula é: Número máximo de requisições de retorno à origem = Maximum 301/302 Redirects + 1. O máximo padrão é 3, com intervalo válido de 2 a 6.

    Retain Parameters in 301/302 Redirects

    • Yes: Mantém os parâmetros da requisição original na requisição de retorno à origem para o novo local.

    • No: Não mantém os parâmetros da requisição original na requisição de retorno à origem para o novo local.

    Retain Request Headers in 301/302 Redirects

    • Yes: Preserva os cabeçalhos da requisição original na requisição de retorno à origem para o novo local.

    • No: Não preserva os cabeçalhos da requisição original na requisição de retorno à origem para o novo local.

Exemplo de configuração

Caso de uso: Os recursos no seu servidor de origem foram movidos para um novo local, mas você deseja que os clientes continuem acessando-os de forma transparente pelo nome de domínio original.

Configuração: Ative o redirecionamento 301/302 para o nome de domínio example.com. Na caixa de diálogo 301/302 Redirection, defina Maximum 301/302 Redirects como 2. Assim, o número máximo de requisições de retorno à origem será 3. O intervalo válido para redirecionamentos é de 1 a 5, e para requisições de retorno à origem é de 2 a 6. Selecione No em Retain Parameters in 301/302 Redirects, escolha No para Retain Request Headers in 301/302 Redirects e clique em OK.

Explicação dos resultados: Um usuário solicita o arquivo http://example.com/examplefile.txt. Caso o arquivo não esteja em cache no nó do CDNDCDN, o nó solicitará o recurso ao servidor de origem. O servidor de origem retornará um código de status 301/302 e a URL de redirecionamento http://www.example.org/examplefile.txt.

  1. Ao receber um código de status 301 ou 302, um ponto de presença (POP) do CDN DCDN envia uma requisição ao endereço de redirecionamento. O POP tenta seguir o redirecionamento até duas vezes. Se as tentativas falharem, ele retornará o código de status 301 ou 302 ao usuário.

  2. O POP do CDNDCDN recupera o recurso, entrega-o ao usuário e o armazena em cache no próprio POP do CDNDCDN.

  3. Quando outros usuários solicitarem o arquivo novamente, o CDNDCDN retornará diretamente o recurso em cache.