Todos os produtos
Search
Central de documentação

CDN:Configurar a busca de origem por intervalo

Última atualização: Aug 21, 2026

A busca de origem por intervalo permite que um ponto de presença (POP) da CDN inclua um cabeçalho Range nas solicitações à origem. Assim, o servidor de origem retorna apenas a parte especificada do recurso. Esse mecanismo melhora a eficiência na entrega de arquivos, reduz o tráfego de retorno à origem, diminui a carga no servidor de origem e acelera os tempos de resposta.

Contexto

O cabeçalho HTTP Range define qual parte de um recurso recuperar. Por exemplo, Range: bytes=0-100 solicita os primeiros 101 bytes de um arquivo.

Ao ativar a busca de origem por intervalo, quando um POP recebe uma solicitação para um recurso ausente no cache ou expirado, ele busca apenas os segmentos necessários no servidor de origem usando requisições Range e os armazena localmente em cache.

Funcionamento da busca de origem por intervalo:

image

Observações de uso

Antes de ativar a busca de origem por intervalo:

  • Verifique se o servidor de origem suporta requisições Range e responde com 206 Partial Content. Caso contrário, ativar esse recurso pode causar problemas de cache ou falhas nas solicitações.

  • A busca de origem por intervalo vem desativada por padrão.

  • Multipart Ranges também vem desativado por padrão e não é habilitado automaticamente pela busca de origem por intervalo. Para ativá-lo, envie um ticket.

  • Ativar a busca de origem por intervalo aumenta o QPS de busca na origem, o que pode acionar limitação de taxa no servidor de origem. Para evitar isso, chame a operação DescribeL2VipsByDomain para obter os endereços IP dos POPs de retorno à origem e adicione-os à lista de permissões de IP do servidor de origem.

Casos de uso para arquivos grandes

A CDN suporta streaming progressivo para arquivos grandes, como MP4. O comportamento depende do suporte a requisições Range do servidor de origem e do modo de busca de origem configurado no console da CDN:

  • Cenário 1: O servidor de origem suporta requisições Range e a busca de origem por intervalo está ativada

    Quando o cliente envia uma requisição Range e a busca de origem por intervalo está ativa, o POP recupera apenas o intervalo de dados solicitado do servidor de origem e o retorna ao cliente. O POP não aguarda o download completo do arquivo. Há suporte a streaming progressivo.

  • Cenário 2: O cliente não envia uma requisição Range

    Se um cliente solicitar um arquivo completo sem o cabeçalho Range, o POP solicita o arquivo inteiro à origem e o transmite via streaming para o cliente. Como os dados são encaminhados conforme chegam, o cliente pode iniciar a reprodução imediatamente (desde que o átomo moov do MP4 esteja no cabeçalho do arquivo), mas não pode buscar uma posição ainda não baixada. Nesse cenário, a configuração de busca de origem por intervalo não afeta o comportamento de transferência no lado do cliente.

  • Cenário 3: O servidor de origem não suporta requisições Range

    Se o servidor de origem não suportar requisições Range e não puder responder com 206, a busca de origem por intervalo não terá efeito, mesmo que ativada. O POP buscará o arquivo completo. Verifique se o servidor de origem suporta requisições Range antes de ativar este recurso.

Nota

Formatos como MP4 e similares suportam streaming, mas o transporte HTTP subjacente precisa aceitar requisições Range. Confirme se o servidor de origem suporta requisições Range e selecione o modo de busca de origem adequado às suas necessidades.

Procedimento

  1. Faça login no console da CDN.

  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 Manage na coluna Actions.

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

  5. Na seção Range Origin Fetch, clique em Modify.

  6. Conforme a tabela abaixo, selecione Do Not Enable Range Origin Fetch, Match Client ou Enable Range Origin Fetch (Recommended for Large File Delivery).

    Se você selecionar Match Client ou Enable Range Origin Fetch (Recommended for Large File Delivery), poderá definir o tamanho do fragmento. O tamanho padrão é 512 KB.

    Parâmetro

    Opção

    Descrição

    Exemplo

    Range Origin Fetch

    Do Not Enable Range Origin Fetch

    Por padrão, Do Not Enable Range Origin Fetch vem selecionado. Isso significa que, independentemente de o cliente enviar ou não uma requisição Range para um POP CDN, o POP CDN solicita o arquivo inteiro durante a busca na origem, resultando em baixa eficiência de distribuição para arquivos grandes.

    Por exemplo, se uma requisição de um cliente para um POP CDN contiver Range: bytes=0-100, o POP CDN envia uma solicitação ao servidor de origem sem o parâmetro Range. O servidor de origem envia o arquivo inteiro para o POP CDN. Se o arquivo tiver 10 MB, o servidor de origem enviará todos os 10 MB ao POP CDN. O POP CDN armazena em cache o arquivo recebido da origem e então responde ao cliente com o conteúdo correspondente à requisição Range: bytes=0-100.

    Match Client

    Ao ativar Match Client, se um cliente enviar uma requisição Range para um POP CDN, o POP CDN executa a busca na origem usando uma requisição Range. Na primeira solicitação de busca na origem, o POP CDN solicita um bloco de dados do servidor de origem. O tamanho desse bloco corresponde ao arredondamento para cima do tamanho do intervalo da requisição do cliente até o múltiplo inteiro mais próximo do tamanho do fragmento. Todas as solicitações subsequentes de busca na origem usam o tamanho de fragmento especificado.

    Por exemplo, com o tamanho de fragmento definido em 512 KB, se um cliente enviar uma requisição a um POP CDN contendo Range:bytes=0-614399 (equivalente a 600 KB) e o arquivo não estiver em cache no POP CDN, a primeira busca na origem recuperará um fragmento de 1024 KB (600 KB arredondados para 1024 KB). Para requisições subsequentes de outros fragmentos não armazenados em cache, o POP CDN acessará o servidor de origem utilizando o tamanho de fragmento de 512 KB.

    Enable Range Origin Fetch (Recommended for Large File Delivery)

    Com Enable Range Origin Fetch (Recommended for Large File Delivery) ativado, independentemente de o cliente enviar ou não uma requisição Range para um POP CDN, os POPs CDN sempre usarão requisições Range para a busca na origem. Todas as requisições Range enviadas dos POPs CDN para o servidor de origem utilizarão o tamanho de fragmento especificado.

    Nenhum

    Shard Size

    • 512 KB

    • 1 MB

    • 2 MB

    • 4 MB

    É possível definir o tamanho do fragmento ao selecionar Match Client ou Enable Range Origin Fetch (Recommended for Large File Delivery). O tamanho padrão é 512 KB.

    1 MB

    Rule Condition

    Uma condição de regra avalia os parâmetros da requisição para determinar se uma configuração se aplica.

    Importante

    Quando um recurso utiliza condições de regra do mecanismo de regras, a execução segue a prioridade da condição da regra, e não a ordem de configuração do recurso.

    • Do not use conditions: Desativa as regras condicionais.

    • Adicione ou edite regras condicionais em Rules engine.

    A condição de regra avalia parâmetros em uma requisição de usuário para determinar se a configuração se aplica.

    Não usar

  7. Clique em OK para salvar a configuração.