All Products
Search

This Product

    Global Accelerator:Configure CNAME

    Document Center

    Global Accelerator:Configure CNAME

    Last Updated:Jun 25, 2026

    To accelerate access to your services using a domain name, you must point the domain to the CNAME address of your Global Accelerator instance. This topic demonstrates how to configure a CNAME record, using Alibaba Cloud DNS as an example.

    Prerequisites

    You have created a Global Accelerator and configured an Global Accelerator, a listener, and an endpoint group for the instance. For more information, see the following topics:

    Step 1: Get the CNAME address

    1. Log on to the GA console.

    2. On the Instances page, find the target Global Accelerator instance and click its ID.

    3. Click the Instance Information tab.

    4. In the Basic Information area, find CNAME and click Copy next to the CNAME value.

    Step 2: Add a CNAME record

    1. Log on to the Alibaba Cloud DNS console.

    2. 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, add it to the Alibaba Cloud DNS console before you configure DNS records. For more information, see Add a domain name. If your domain name is registered with Alibaba Cloud, skip this step.

    3. On the Public Zone page, find the target domain name, and in the Actions column, click DNS Settings.

    4. On the DNS Settings page, click Add DNS Record.

    5. In the Add DNS Record panel, configure the CNAME record with the following information and click OK.

      For more information about CNAME record settings, see CNAME record.

      Parameter

      Description

      Record Type

      Select CNAME.

      Hostname

      Enter the prefix of the accelerated domain name.

      • If the accelerated domain name is www.aliyun.com, set the hostname to www.

      • If the accelerated domain name is aliyun.com, set the hostname to @.

      • If the accelerated domain name is *.aliyun.com, set the hostname to *.

      • If the accelerated domain name is mail.aliyun.com, set the hostname to mail.

      DNS Request Source

      Keep the default value.

      TTL

      The duration for which the DNS record is cached on DNS servers. A smaller value means the record takes effect faster.

      In this example, the default value of 10 minutes is used.

      Record Value

      Paste the CNAME value that you copied in Step 1.
    Note

    • To use region-based DNS resolution, upgrade Alibaba Cloud DNS to the Enterprise Standard or Enterprise Ultimate edition. For more information, see Renewal.

      After you upgrade, you can modify the default resolution line of an existing A record to a specific region and add a CNAME record that points to the CNAME assigned by your Global Accelerator instance.

    • When you use a custom domain name as the backend service for an endpoint, the time required for the DNS record to take effect depends on the following two factors:

      • The TTL value that you set for the DNS record.

      • The cache update interval of Global Accelerator, which retrieves the DNS record every 15 seconds by default.

    Step 3: Verify the CNAME configuration

    Check CNAME effective regions

    1. Log on to the GA console.

    2. On the Instances page, find the target Global Accelerator instance, and in the CNAME column, click View DNS Records.

    3. On the Network Detect Tool page, view the CNAME resolution result.

      After you are redirected to the Network Detect Tool page, the default detection points are selected based on the configured acceleration area:

      • If the acceleration area contains only regions in the Chinese mainland, detection points across the Chinese mainland are selected by default.

      • If the acceleration area contains only regions outside the Chinese mainland, detection points in regions outside the Chinese mainland are selected by default.

      • If the acceleration area contains regions both in and outside the Chinese mainland, or contains the China (Hong Kong) region, all detection points are selected by default.

      You can also select specific ISPs and regions for the tests.

      You can view the resolution result of each detection point. If the result matches the accelerated IP address of the acceleration area, the CNAME record is effective for that region.

    Verify the CNAME configuration

    Automated verification

    1. Go to the Instant Detections page.

    2. On the DNS Tests tab, select an ISP and a region, enter the accelerated domain name, and then click Test Now.

    3. In the Inspection Result area, click 筛选.png to the right of the Detection Point City column, enter the name of the acceleration region, and then click Confirm.

    4. View the test results.

      If the DNS query result for a detection point matches the CNAME of the Global Accelerator instance or its accelerated IP address, the CNAME configuration is effective.

      DNS生效检测 INTL.png

    Manual verification

    1. Open the command-line interface (CLI) on a computer in an acceleration region.

      This topic uses Alibaba Cloud Linux 3 as an example.

    2. Run the ping command: ping the acceleration domain name.

      If the output shows your domain resolving to the CNAME of your Global Accelerator instance, the configuration is effective.

      [root@iZrjxxx ~]# ping xxx.cloud
PING ga-bp1cxxx.com (47.251.xxx.xxx) 56(84) bytes of data.
64 bytes from 47.251.xxx.xxx (47.251.xxx.xxx): icmp_seq=1 ttl=95 time=1.42 ms
64 bytes from 47.251.xxx.xxx (47.251.xxx.xxx): icmp_seq=2 ttl=95 time=1.41 ms
64 bytes from 47.251.xxx.xxx (47.251.xxx.xxx): icmp_seq=3 ttl=95 time=1.39 ms
^C
--- ga-bp1xxx.com ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2002ms
rtt min/avg/max/mdev = 1.393/1.407/1.420/0.011 ms

    References