tencent cloud


Domain Name Connection

Last updated: 2020-10-28 16:01:15

    Process Overview

    The main steps in connecting an acceleration domain name to ECDN include:

    1. Add an acceleration domain name configuration on the platform.
    2. Access your business with the hosts file to verify the business compatibility.
    3. Switch the CNAME record to forward requests to ECDN.

    Step 1. Add an acceleration domain name

    1. Enter the domain management page

    Log in to the ECDN Console and click Domain Management on the left sidebar to enter the Domain Management page. Click Add Domain Name to enter the Add Domain Name page.

    2. Enter the domain name information

    On the Add Domain Name page, enter the acceleration domain name information as instructed.


    • If the acceleration regions are in the mainland of China, according to relevant laws and regulations, the new acceleration domain name must have been filed on record on MIIT's ICP filing website or have obtained ICP filing through [ICP filing registration], and has not connected to Tencent Cloud CDN or ECDN before. The domain name that has been connected to the CDN needs to be deleted before being added to the ECDN platform.
    • You can manage domain names by project in the Project section. Here, a project is shared by all Tencent Cloud products. You can manage projects in Project Management.
    • If the origin server type is origin IP, optimal route selection, weighted, and primary/secondary origin-pull policies are supported. For more information, please see configuration methods in Advanced Origin-Pull Policies.
    • If the origin server type is origin domain, you can enter only one domain name, which must be different from the acceleration domain name. You can set the port in Host:Port format, and the port number should be between 1 and 65535.
    • When you add a domain name, ECDN will display the default regular caching rules. You can modify or manage them in the rule list for customization for the domain name.

    3. Select the origin-pull protocol

    Select the transfer protocol used for communication between the edge server and origin server.

    4. Configure caching rules

    Configure caching rules for dynamic and static content of the domain name. You can use the recommended configurations by default or click Edit Caching Rule to edit the rules.

    5. Click "Submit"

    After the domain name is configured, click Submit to add it. In the pop-up box, click Go to Domain Name List to view the domain name status. After the domain name is added, the system will deploy relevant configurations on the backend, which will take effect in about 5 minutes.

    To configure the domain name with HTTPS, you can do so as instructed in HTTPS Settings after adding the domain name.

    Step 2. Verify access with hosts

    To ensure continuity of access to your business, you are recommended to set the local hosts file to verify whether access is normal before formally switching the CNAME resolution. If your page contains multiple dynamic domain names, you can add them in batches for verification

    1. Get a CNAME domain name

    1. Before verification with hosts, please make sure that the domain name is activated.
    2. The CNAME address of ECDN is suffixed with .dsa.dnsv1.com, which can be viewed on the Domain Management page.

    2. Resolve the CNAME domain name to get the ECDN cache node IP

    Run nslookup on the local command line to resolve the ECDN CNAME domain name so as to get the IP address of the cache node.

    3. Set hosts

    You can configure the local hosts file to forcibly redirect access requests to the local server to the ECDN platform, so that you can verify the platform compatibility without affecting formal access to your business.
    The following uses the hosts file on Windows as an example to show the settings. It is generally stored in C:\Windows\System32\drivers\etc\hosts:

    4. Verify access

    After setting the hosts file, you can access resources under the acceleration domain name with a browser. The following uses Chrome as an example to show how to access the domain name:

    By using the built-in packet capture tool in the browser, you can see that:

    • The request address of the acceleration domain name is pointed to the ECDN node
    • The request response status code of the acceleration domain name is 200 OK, indicating that user requests can be responded to normally, which meets the test expectation.
    • If the response status code of the acceleration domain name is exceptional, you can submit a ticket. Please attach screenshots of your operations in the ticket to facilitate troubleshooting.

    Step 3. Configure the CNAME record of the domain name

    1. After verification with the hosts file is passed, you can forward requests to the domain name to the ECDN acceleration platform. You need to complete the CNAME configuration at your DNS service provider of the acceleration domain name. For more information on how to configure a CNAME record, please see CNAME Record Configuration.
    2. Check whether the CNAME record of the domain name takes effect: the time it takes for a CNAME record to take effect varies by DNS service provider. You can also run the ping or dig command to check whether the CNAME record is in effect. If a domain name suffixed with .dsa.sp.spcdntip.com or .dsa.p23.tc.cdntip.com is returned, the CNAME record has taken effect.

    Subsequent Steps

    When the distribution is completed, ECDN will allocate a corresponding CNAME address to you, which needs to be configured before the acceleration service taking effect. For detailed directions, please see CNAME Configuration.

    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support