All Products
Search
Document Center

ApsaraVideo VOD:Configure CNAME in Alibaba Cloud DNS

Last Updated:Jun 20, 2026

After you add an accelerated domain name, CDN assigns a CNAME to the domain name. You must point the DNS record for the accelerated domain name to the assigned CNAME at your DNS service provider. This forwards user requests to points of presence (POPs) to accelerate content delivery. This topic uses Alibaba Cloud DNS as an example to show you how to configure a CNAME record.

Background information

Before you configure a CNAME record, you should understand the following concepts:

Prerequisites

Ensure that you have added an accelerated domain name. If not, see Add an accelerated domain name.

Procedure

  1. Obtain the CNAME of the accelerated domain name.

    1. Log on to the ApsaraVideo VOD console.

    2. In the left-side navigation pane, choose Configuration Management > CDN Configuration > Domain Names.

    3. Find the domain name for which you want to configure a CNAME, hover the pointer over the view icon, and then copy its CNAME value. You will use this value when you add the CNAME record.

  2. Configure the CNAME record.

    This section provides an example of adding a CNAME record in the Alibaba Cloud DNS console. If your domain name is hosted with another DNS service provider, such as DNSPod, Xinnet, or GoDaddy, configure the CNAME record with your provider. The procedure is similar.

    1. Log on to the Alibaba Cloud DNS console with the Alibaba Cloud account that owns the accelerated domain name.

    2. (Optional) If your domain name is not registered with Alibaba Cloud, add the domain name to the Alibaba Cloud DNS console.

      Note

      If your domain name is not registered with Alibaba Cloud, you must first add it to the Alibaba Cloud DNS console before you can configure its DNS settings. For more information, see domain name management. If your domain name is registered with Alibaba Cloud, skip this step.

    3. On the Domain Name Resolution page, find your domain name and click DNS Settings in the Actions column.

    4. Click Add DNS Record to add a CNAME record.

      Important
      • Each accelerated domain name has a unique CNAME. The CNAME of a root domain cannot be used by its subdomains. If you want to accelerate a subdomain, you must also add the subdomain to CDN and then point it to its corresponding CNAME. Alternatively, you can add a wildcard domain to CDN. The CNAME of a wildcard domain can be used by its subdomains.

      • Alibaba Cloud's DNS verification servers are located in the Chinese mainland. Therefore, if you configure a CNAME record to resolve only in regions outside the Chinese mainland, such as Hong Kong, Macao, Taiwan, and other countries and regions, the verification servers cannot resolve it. The CNAME status of the domain name is displayed as Pending Configuration in the ApsaraVideo VOD console. However, this does not affect the CDN acceleration service for ApsaraVideo VOD.

      • The CNAMEs for Alibaba Cloud CDN, Dynamic Route for CDN, ApsaraVideo Live, and ApsaraVideo VOD can be used only for scheduling and resolution by Alibaba Cloud CDN. Alibaba Cloud reserves the right to suspend the service for domain names and accounts that misuse these CNAMEs.

      Parameter

      Description

      Example

      Record Type

      Select CNAME.

      CNAME

      Hostname

      • If the accelerated domain name is a root domain, set the hostname to @.

      • If the accelerated domain name is a wildcard domain, set the hostname to *.

      • If the accelerated domain name is a subdomain, set the hostname to the prefix of the subdomain.

      • root domain examples

        • For the accelerated domain name aliyundoc.com, set the hostname to @.

        • For the accelerated domain name aliyundoc.com.cn, set the hostname to @.

      • wildcard domain examples

        • For the accelerated domain name *.aliyundoc.com, set the hostname to *.

        • For the accelerated domain name *.aliyundoc.com.cn, set the hostname to *.

        • For the accelerated domain name *.example.aliyundoc.com, set the hostname to *.example.

        • For the accelerated domain name *.example.aliyundoc.com.cn, set the hostname to *.example.

      • subdomain examples

        • For the accelerated domain name example.aliyundoc.com, set the hostname to example.

        • For the accelerated domain name example.aliyundoc.com.cn, set the hostname to example.

        • For the accelerated domain name www.example.aliyundoc.com, set the hostname to www.example.

        • For the accelerated domain name www.example.aliyundoc.com.cn, set the hostname to www.example.

      Note

      The accelerated domain names that end with .com.cn are examples of top-level domains with a two-level suffix.

      DNS Request Source

      Keep the default value.

      We recommend that you use the default value.

      Record Value

      Enter the CNAME value for the accelerated domain name. This is the CNAME value that you copied in Step 1.

      Note

      Each accelerated domain name has a unique CNAME value. A subdomain cannot use the CNAME value of its root domain. If you want to accelerate a subdomain, you must also add the subdomain to CDN and point it to its corresponding CNAME value.

      www.example.com.w.kunlunsl.com

      TTL

      TTL specifies the cache duration. The smaller the value, the faster the record modifications take effect globally. The default value is 10 minutes.

      We recommend that you use the default value.

    5. Click OK.

      After the CNAME record takes effect, the acceleration service is enabled immediately.

      Note
      • A new CNAME record takes effect quickly. Modifications to an existing CNAME record can take up to 72 hours to take effect globally.

      • After you configure the CNAME record, it may take about 10 minutes for the status to update. The domain list page in the console may still show a Not Configured status. You can ignore this temporary status.

  3. Verify that the CNAME configuration has taken effect.

    1. Open the command line on Windows.

    2. In the command line, run the ping command for your accelerated domain name. If the CNAME in the response matches the CNAME assigned to the accelerated domain name in the ApsaraVideo VOD console, CDN acceleration for ApsaraVideo VOD is active.

      Microsoft Windows [Version 10.0.17134.950]
      (c) 2018 Microsoft Corporation. All rights reserved.
      
      C:\Users\xxx> ping your.accelerated.domain.name
      
      Pinging your.accelerated.domain.name.w.kunlunsl.com [xxx.xxx.xxx.xxx] with 32 bytes of data:
      Reply from xxx.xxx.xxx.xxx: bytes=32 time=5ms TTL=51
      Reply from xxx.xxx.xxx.xxx: bytes=32 time=5ms TTL=51
      Reply from xxx.xxx.xxx.xxx: bytes=32 time=5ms TTL=51
      Reply from xxx.xxx.xxx.xxx: bytes=32 time=5ms TTL=51

FAQ

How do I test whether CNAME resolution is working as expected?