Todos os produtos
Search
Central de documentação

CDN:Perguntas frequentes sobre configuração de CNAME

Última atualização: Jul 17, 2026

O CDN atribui um endereço CNAME a cada nome de domínio acelerado. Aponte o registro DNS do seu domínio para esse endereço CNAME e ative a aceleração do CDN. As seções a seguir abordam as dúvidas mais comuns sobre a configuração de CNAME.

Verificar o status do registro CNAME

Após configurar o registro CNAME no console do CDN, verifique-o com nslookup ou dig. Evite o comando ping, pois ele pode retornar resultados de DNS imprecisos.

Windows

nslookup -type=CNAME <accelerated domain name>

Se o resultado corresponder ao endereço CNAME atribuído pelo CDN, o registro CNAME entrou em vigor.

Linux/macOS

No Linux ou macOS, execute dig para verificar a configuração:

  • Consultar apenas o endereço de destino do CNAME (recomendado):

    dig +short <accelerated domain name> CNAME

    Caso o resultado corresponda ao endereço CNAME atribuído pelo CDN, o registro CNAME entrou em vigor. Exemplo de saída:

    dig +short cdn.example.com CNAME
    cdn.example.com.w.alikunlun.com.
  • Consultar informações detalhadas do nome de domínio:

    dig <accelerated domain name> CNAME

    Se o valor CNAME na ANSWER SECTION corresponder ao endereço CNAME atribuído pelo CDN, o registro CNAME entrou em vigor.

Solucionar erros NXDOMAIN ou "registro não encontrado"

Siga estas etapas para solucionar o problema:

  1. Verifique a ortografia do nome de domínio: certifique-se de que o nome de domínio inserido no comando esteja correto.

  2. Confira a configuração de DNS: faça login no console de DNS e verifique se o registro CNAME existe e se o registro de host está correto. O registro de host deve ser o prefixo do nome de domínio acelerado, e não o nome completo. Por exemplo, se o seu nome de domínio acelerado for cdn.example.com, o registro de host deve ser cdn, e não cdn.example.com.

  3. Aguarde a propagação do DNS: após modificar um registro DNS, a alteração leva algum tempo para se propagar globalmente. Aguarde alguns minutos e tente novamente.

    Nota

    O tempo de propagação do DNS depende do Time to Live (TTL) do registro. Por exemplo, se o registro anterior tinha um TTL de 10 minutos, o novo registro levará pelo menos 10 minutos para entrar em vigor. Antes de modificar um registro CNAME, recomendamos definir o TTL do registro original com um valor menor, como 60 segundos.

Resolver conflitos de registro A

Um registro A e um registro CNAME não podem coexistir para o mesmo registro de host. Se aparecer um erro de conflito, significa que já existe outro tipo de registro para esse registro de host. Para resolver isso:

  1. Faça login no console de DNS e localize o registro A conflitante (ou MX, TXT ou outros tipos de registro).

  2. Exclua ou pause o registro conflitante.

  3. Adicione o registro CNAME novamente e defina o valor do registro como o endereço CNAME atribuído pelo CDN.

Nota
  • A exclusão do registro A interrompe o tráfego para o servidor de origem. Teste primeiro com um subdomínio para verificar se a aceleração do CDN funciona antes de alternar seu domínio principal.

  • Execute esta operação fora dos horários de pico.

  • Se você ativou verificações de integridade no Global Traffic Manager (GTM), o GTM pode criar automaticamente um registro DNS conflitante. Resolva o problema no GTM antes de adicionar o registro CNAME.

Solucionar status incorreto no console

A configuração de CNAME geralmente leva de 5 a 30 minutos para entrar em vigor, dependendo do TTL do registro DNS. Após a propagação global, o console do CDN atualiza o status do domínio para ativo. Atualize a página após alguns minutos.

Se o status do domínio não for atualizado após um tempo razoável, faça a seguinte verificação:

  1. Verifique se o registro de host está correto: o registro de host deve corresponder ao prefixo do seu nome de domínio acelerado. Por exemplo, o registro de host para a.example.com é a, e o registro de host para example.com é @. Um erro comum é inserir www quando o nome de domínio acelerado não é www.example.com.

  2. Confira se o valor do registro CNAME está correto: o valor do registro deve corresponder exatamente ao endereço CNAME exibido no console do CDN. Recomendamos copiar o endereço diretamente do console.

  3. Valide com nslookup ou dig: confirme se o CNAME retornado aponta para o endereço atribuído pelo CDN.

  4. Verifique se há registros conflitantes: garanta que você excluiu o registro A ou outros registros conflitantes para o mesmo registro de host.

Lidar com divergência de status "CNAME not configured"

Nos cenários a seguir, o console do CDN pode relatar que o CNAME não está configurado, mesmo que a aceleração funcione corretamente. Isso não afeta seu service:

  • A região de aceleração exclui a China continental: se você definiu a região de aceleração como Global (excluding the Chinese mainland) (o que corresponde ao parâmetro da API Scope definido como overseas), uma verificação de CNAME feita de dentro da China continental pode relatar incorretamente que o CNAME não está configurado. Esse comportamento é esperado e não afeta seu service na região de destino. Para verificar se a aceleração está ativa fora da China continental:

    1. Use o comando nslookup ou dig, ou verifique no console do CDN para confirmar que o nome de domínio resolve para o endereço CNAME atribuído pelo CDN.

    2. Acesse o recurso acelerado a partir de uma rede fora da China continental e use as ferramentas de desenvolvedor do navegador para verificar o cabeçalho de resposta. Um valor X-Cache igual a HIT confirma que a aceleração está funcionando.

  • DNS de horizonte dividido configurado: se o seu provedor de DNS retornar registros diferentes para regiões distintas, como direcionar o tráfego da China continental para o endereço CNAME do CDN e outro tráfego para o IP de origem, o console poderá relatar "CNAME not configured" porque nem todas as regiões resolvem para o CDN. Ignore essa mensagem se os usuários nas regiões de destino conseguirem acessar os recursos acelerados corretamente.

  • Atraso na propagação do DNS: após adicionar ou modificar um registro CNAME, a propagação global do DNS pode levar de vários minutos a várias horas, dependendo da configuração de TTL. O console pode mostrar "CNAME not configured" durante esse período. Verifique novamente mais tarde.

Vários registros CNAME para um único domínio

Não. Apenas um valor de registro CNAME é permitido por registro de host. Vários registros CNAME podem causar erros de acesso, como HTTP 403.

Solução: mantenha apenas um registro CNAME para o registro de host, apontando para o endereço CNAME atribuído ao seu nome de domínio acelerado. Exclua quaisquer registros extras.

Registros CNAME curinga e subdomínios

Após configurar um registro CNAME para um domínio curinga, como *.example.com, todos os subdomínios sem seus próprios registros DNS (por exemplo, a.example.com e b.example.com) herdam o registro curinga. Para excluir subdomínios específicos da aceleração do CDN, configure um registro A separado ou outro tipo de registro para eles. Um registro DNS específico para um subdomínio tem precedência sobre o registro curinga.

Nota

As regras de precedência de resolução podem variar conforme o provedor de DNS.