All Products
Search
Document Center

Edge Security Acceleration:CNAME setup

Last Updated:Sep 19, 2024

If you select CNAME for DNS setup when you add a website, you need to add a DNS record to map the domain that you want to proxy to the CNAME assigned by Dynamic Content Delivery Network (DCDN). This way, user requests destined for your domain can be forwarded to DCDN points of presence (POPs). This enables content delivery acceleration, edge computing, and enhanced protection.

Verify domain ownership

The first time you add a domain to DCDN, you must verify the ownership of the domain. Once the domain passes the verification, its subdomains do not require separate ownership verification.

Procedure

  1. Log on to the ESA console.

  2. On the Websites page, find the website that you want to manage, and click the website name or View Details in the Actions column.

  3. Obtain the TXT record.

    On the Overview page

    In the left-side navigation tree, click Overview and copy the Hostname and Record Value assigned to your website.

    image

    On the Records page

    In the left-side navigation tree, choose DNS > Records.

    image

  4. Add the TXT record to the DNS settings of your domain at your DNS provider. The following example shows how to add a TXT record to the DNS settings at Alibaba Cloud DNS. You can use similar methods to add TXT records to the systems of other DNS providers, such as Tencent Cloud and Xinnet.

    1. Log on to the Alibaba Cloud DNS console.

    2. On the Domain Name Resolution page, find the root domain, such as example.com, and click DNS Settings in the Actions column.

    3. Click Add DNS Record. Set Record Type to TXT, enter the hostname and record value that you obtained in Step 3, and retain the default values for other parameters.

    4. Click OK.

  5. Wait until the TXT record takes effect. Then return to the DCDN console and click Verify.

  6. Confirm that the status of the website changes to Active.

Add DNS records and enable proxy

You can upload a file to import DNS records or manually add them for your domain.

Note

In CNAME setup, you can only add A, AAAA, and CNAME records, for which proxy cannot be disabled.

Import DNS records at a time (recommended)

  1. On the Websites page, find the website that you want to manage, and click the website name or View Details in the Actions column.

  2. In the left-side navigation tree, choose DNS > Records.

  3. Click Import. On the Import page, click Download Template. Then modify the downloaded template as needed. Example:

    ;Host TTL IN RecordType RecordValue
    ;You can only import A, AAAA, and CNAME records for websites connected in CNAME setup.
    
    $ORIGIN example.com.
    
    ; A record
    1.example.com.   600 IN  A   8.8.8.8
    
    ; AAAA record
    2.example.com.   600 IN  AAAA		2400:cb00:2049:1::a29f:f9
    
    ; CNAME record
    2.example.com.   600 IN  CNAME     example.com.
  4. Click Select File to import the DNS records.

    Note

    After the import, A and AAAA records that correspond to the same hostname are collectively referred to as one A/AAAA record.

  5. Select an appropriate business scenario to further improve the acceleration performance.

  6. Click OK.

Add DNS records manually

  1. On the Websites page, find the website that you want to manage, and click the website name or View Details in the Actions column.

  2. In the left-side navigation tree, choose DNS > Records.

  3. Click Add Record. In the dialog box that appears, add a DNS record.

    Parameter

    Description

    Proxy Status

    In CNAME setup, proxy cannot be disabled.

    Record Type

    Supported record types are A, AAAA, and CNAME.

    Hostname

    The prefix of the subdomain. For example, if you add a subdomain named www.example.com, enter www in the Hostname field.

    Record Value

    Enter the value based on the selected record type. For example, the record value of an A record is an IP address.

    TTL

    Specifies how long resolution results are retained in the local DNS cache.

    Note

    The TTL cannot be adjusted for proxied DNS records.

  4. Click Next and select a business scenario based on your business requirements.

  5. Click OK.

Note

By default, when a DCDN POP requests resources from the origin server, the domain name in a client request is used as the Host request header. If you configure an origin domain name that is different from the requested domain name, such as one that a CNAME record points to, you need to modify the Host request header in origin requests to ensure that desired resources are returned. For more information, see Origin host.

Add a CNAME record to enable proxy

After you add the DNS records to DCDN, you must add a CNAME record to map your domain to the CNAME. This way, requests are forwarded to POPs to implement content delivery acceleration, edge computing, and protection.

Different DNS providers have different methods to add CNAME records.

Important
  • Make sure that the DNS records do not conflict with each other in the same system.

  • The server that DCDN uses for domain name resolution is deployed in the Chinese mainland. If you configure region-specific DNS settings for your domain name, for example, you add a CNAME record for your DCDN-accelerated domain name only in regions outside the Chinese mainland, including Hong Kong (China), Macao (China), and Taiwan (China), the domain name cannot be mapped to the CNAME. The CNAME status is Pending Configuration in the DCDN console. However, acceleration for the domain name is not affected.

  • CNAMEs that are assigned by Alibaba Cloud CDN, DCDN, ApsaraVideo Live, and ApsaraVideo VOD can be used only for domain name resolution. If Alibaba Cloud detects that your CNAME is used for unauthorized or malicious activities, Alibaba Cloud reserves the right to close your Alibaba Cloud account and remove the domain names.

Alibaba Cloud

If your DNS provider is Alibaba Cloud, perform the following steps to add a CNAME record for the domain:

  1. Log on to the Alibaba Cloud DNS console with the Alibaba Cloud account to which the domain belongs.

  2. Optional. Add a domain that is not registered with Alibaba Cloud.

    Note

    If the domain is not registered with Alibaba Cloud, you need to add the domain to Alibaba Cloud DNS before you can add a DNS record for the domain. For more information, see Manage domain names. If the domain is registered with Alibaba Cloud, skip this step.

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

  4. Click Add DNS Record to add a record.

    Note

    The CNAME record of a specific domain takes precedence over that of a wildcard domain. If you want to accelerate a wildcard domain, where the DNS record contains an asterisk (*), you need to delete all other DNS records that match the wildcard domain.

    添加记录

    Parameter

    Description

    Example

    Record Type

    Select CNAME.

    CNAME

    Hostname

    • For root domains, enter @.

    • For wildcard domains, enter *.

    • For subdomains, enter the prefix of the subdomain.

    • Root domains

      • aliyundoc.com: @

      • aliyundoc.com.cn: @

    • Wildcard domains

      • .aliyundoc.com: *

      • .aliyundoc.com.cn: *

      • *.example.aliyundoc.com: *.example

      • *.example.aliyundoc.com.cn: *.example

    • Subdomains

      • example.aliyundoc.com: example

      • example.aliyundoc.com.cn: example

      • www.example.aliyundoc.com: www.example

      • www.example.aliyundoc.com.cn: www.example

    Note

    .com.cn is a top-level domain that consists of two hierarchical levels.

    DNS Request Source

    Select Default from the drop-down list.

    We recommend that you keep the default setting.

    Record Value

    Enter the CNAME of the domain.

    Note

    Each domain is assigned a unique CNAME. Subdomains cannot use the CNAME of the root domain. If you want to accelerate a subdomain, add the subdomain to DCDN. Alibaba Cloud then assigns a CNAME to the subdomain. Alternatively, you can add a wildcard domain to DCDN. Subdomains that match the wildcard domain name are mapped to the CNAME of the wildcard domain. For more information, see Add a domain name.

    www.example.com.w.kunlunsl.com

    TTL Period

    Enter a time-to-live (TTL) value for the record. A smaller value indicates that the record is updated quicker. The default TTL is 10 minutes.

    We recommend that you keep the default setting.

  5. Click OK.

Tencent Cloud

If your DNS provider is Tencent Cloud, perform the following steps to add a CNAME record for the domain:

  1. Log on to the DNSPod console.

  2. On the DNSPod page, click Add Records to add a CNAME record.

    Parameter

    Description

    Example

    Host

    • For root domains, enter @.

    • For wildcard domains, enter *.

    • For subdomains, enter the prefix of the subdomain.

    • Root domains

      • aliyundoc.com: @

      • aliyundoc.com.cn: @

    • Wildcard domains

      • .aliyundoc.com: *

      • .aliyundoc.com.cn: *

      • *.example.aliyundoc.com: *.example

      • *.example.aliyundoc.com.cn: *.example

    • Subdomains

      • example.aliyundoc.com: example

      • example.aliyundoc.com.cn: example

      • www.example.aliyundoc.com: www.example

      • www.example.aliyundoc.com.cn: www.example

    Note

    .com.cn is a top-level domain that consists of two hierarchical levels.

    Type

    Select CNAME.

    CNAME

    Split Zone

    Select Default.

    We recommend that you keep the default setting.

    Value

    Enter the CNAME of the domain name.

    Note

    Each accelerated domain name is assigned a unique CNAME. Subdomains cannot use the CNAME of the root domain. If you want to accelerate a subdomain, add the subdomain to DCDN. Alibaba Cloud then assigns a CNAME to the subdomain. Alternatively, you can add a wildcard domain name to DCDN. Subdomains that match the wildcard domain name are mapped to the CNAME of the wildcard domain name. For more information, see Add a domain name.

    www.example.com.w.kunlunsl.com

    Weight

    You do not need to set this parameter.

    N/A

    MX

    You do not need to set this parameter.

    N/A

    TTL

    Enter a TTL value for the CNAME record. A smaller value indicates that the record is updated quicker.

    We recommend that you keep the default setting.

  3. Click Confirm.

Huawei Cloud

  1. Log on to the DNS console.

  2. In the left-side navigation pane, click Public Zones. The Public Zones page appears.

  3. In the row of the domain for which you want to add a CNAME record, click the domain name.

  4. Click Add Record Set. On the page that appears, add a CNAME record.

    Parameter

    Description

    Example

    Name

    • For root domains, enter @.

    • For wildcard domains, enter *.

    • For subdomains, enter the prefix of the subdomain.

    • Root domains

      • aliyundoc.com: @

      • aliyundoc.com.cn: @

    • Wildcard domains

      • .aliyundoc.com: *

      • .aliyundoc.com.cn: *

      • *.example.aliyundoc.com: *.example

      • *.example.aliyundoc.com.cn: *.example

    • Subdomains

      • example.aliyundoc.com: example

      • example.aliyundoc.com.cn: example

      • www.example.aliyundoc.com: www.example

      • www.example.aliyundoc.com.cn: www.example

    Note

    .com.cn is a top-level domain that consists of two hierarchical levels.

    Type

    Select CNAME.

    CNAME

    Alias

    You do not need to set this parameter.

    No

    Line

    Select Default.

    Keep the default setting.

    TTL (s)

    Enter a TTL value for the CNAME record. A smaller value indicates that the record is updated quicker.

    Keep the default setting.

    Value

    Enter the CNAME of the domain name.

    Note

    Each accelerated domain name is assigned a unique CNAME. Subdomains cannot use the CNAME of the root domain. If you want to accelerate a subdomain, add the subdomain to DCDN. Alibaba Cloud then assigns a CNAME to the subdomain. Alternatively, you can add a wildcard domain name to DCDN. Subdomains that match the wildcard domain name are mapped to the CNAME of the wildcard domain name. For more information, see Add a domain name.

    https://www.example.com.w.kunlunsl.com/

    Weight

    You do not need to set this parameter.

    N/A

  5. Click OK.

Cloudflare

  1. Log in to your Cloudflare account and select the domain for which you want to add a CNAME record.

  2. On the page that appears, choose DNS > Records. Click Add record to add a CNAME record.

    Parameter

    Description

    Example

    Type

    Select CNAME.

    CNAME

    Name (required)

    Enter the hostname.

    • For root domains, enter @.

    • For wildcard domains, enter *.

    • For subdomains, enter the prefix of the subdomain.

    • Root domains

      • aliyundoc.com: @

      • aliyundoc.com.cn: @

    • Wildcard domains

      • .aliyundoc.com: *

      • .aliyundoc.com.cn: *

      • *.example.aliyundoc.com: *.example

      • *.example.aliyundoc.com.cn: *.example

    • Subdomains

      • example.aliyundoc.com: example

      • example.aliyundoc.com.cn: example

      • www.example.aliyundoc.com: www.example

      • www.example.aliyundoc.com.cn: www.example

    Note

    .com.cn is a top-level domain that consists of two hierarchical levels.

    Target (required)

    Enter the CNAME of the domain name.

    Note

    Each accelerated domain name is assigned a unique CNAME. Subdomains cannot use the CNAME of the root domain. If you want to accelerate a subdomain, add the subdomain to DCDN. Alibaba Cloud then assigns a CNAME to the subdomain. Alternatively, you can add a wildcard domain name to DCDN. Subdomains that match the wildcard domain name are mapped to the CNAME of the wildcard domain name. For more information, see Add a domain name.

    https://www.example.com.w.kunlunsl.com/

    Proxy status

    Disable proxy.

    Disabled

    TTL

    Enter a TTL value for the CNAME record. A smaller value indicates that the record is updated quicker.

    Auto

  3. Click Save.

AWS (Amazon Route 53)

See Creating records by using the Amazon Route 53 console.

Google Cloud

  1. Log on to Google Cloud console and go to the Cloud DNS page.

  2. Click the domain for which you want to add a CNAME record.

  3. On the Zone details page, click ADD RECORD SET to add a CNAME record.

    Parameter

    Description

    Example

    DNS Name

    Enter the hostname.

    • For root domains, enter @.

    • For wildcard domains, enter *.

    • For subdomains, enter the prefix of the subdomain.

    • Root domains

      • aliyundoc.com: @

      • aliyundoc.com.cn: @

    • Wildcard domains

      • .aliyundoc.com: *

      • .aliyundoc.com.cn: *

      • *.example.aliyundoc.com: *.example

      • *.example.aliyundoc.com.cn: *.example

    • Subdomains

      • example.aliyundoc.com: example

      • example.aliyundoc.com.cn: example

      • www.example.aliyundoc.com: www.example

      • www.example.aliyundoc.com.cn: www.example

    Note

    .com.cn is a top-level domain that consists of two hierarchical levels.

    Resource Record Type

    Select CNAME.

    CNAME

    TTL

    Enter a TTL value for the CNAME record. A smaller value indicates that the record is updated quicker.

    Auto

    Canonical name

    Enter the CNAME of the domain name.

    Note

    Each accelerated domain name is assigned a unique CNAME. Subdomains cannot use the CNAME of the root domain. If you want to accelerate a subdomain, add the subdomain to DCDN. Alibaba Cloud then assigns a CNAME to the subdomain. Alternatively, you can add a wildcard domain name to DCDN. Subdomains that match the wildcard domain name are mapped to the CNAME of the wildcard domain name. For more information, see Add a domain name.

    https://www.example.com.w.kunlunsl.com/

  4. Click Create.

GoDaddy

  1. Sign in to your GoDaddy Domain Portfolio.

  2. Click the domain for which you want to add a CNAME record to access its Domain Settings page.

  3. Click DNS to view your DNS records for the domain. Select Add New Record and then select CNAME from the Type menu.

    Parameter

    Description

    Example

    Name

    Enter the hostname.

    • For root domains, enter @.

    • For wildcard domains, enter *.

    • For subdomains, enter the prefix of the subdomain.

    • Root domains

      • aliyundoc.com: @

      • aliyundoc.com.cn: @

    • Wildcard domains

      • .aliyundoc.com: *

      • .aliyundoc.com.cn: *

      • *.example.aliyundoc.com: *.example

      • *.example.aliyundoc.com.cn: *.example

    • Subdomains

      • example.aliyundoc.com: example

      • example.aliyundoc.com.cn: example

      • www.example.aliyundoc.com: www.example

      • www.example.aliyundoc.com.cn: www.example

    Note

    .com.cn is a top-level domain that consists of two hierarchical levels.

    Value

    Enter the CNAME of the domain name.

    Note

    Each accelerated domain name is assigned a unique CNAME. Subdomains cannot use the CNAME of the root domain. If you want to accelerate a subdomain, add the subdomain to DCDN. Alibaba Cloud then assigns a CNAME to the subdomain. Alternatively, you can add a wildcard domain name to DCDN. Subdomains that match the wildcard domain name are mapped to the CNAME of the wildcard domain name. For more information, see Add a domain name.

    https://www.example.com.w.kunlunsl.com/

    TTL (Time to Live)

    Enter a TTL value for the CNAME record. A smaller value indicates that the record is updated quicker.

    Auto

  4. Click Save.