All Products
Search
Document Center

Edge Security Acceleration:Get started with DNS records

Last Updated:Mar 27, 2025

Once your website is connected to ESA through NS or CNAME setups, you must add DNS records for your domain to be accessible. This topic guides you through the process of adding DNS records.

Before you begin

You can add DNS records to ESA by importing them in bulk or one by one manually.

  • Bulk import DNS records: This approach is particularly useful in scenarios where DNS records from other service providers need to be transferred to ESA.

  • Manually add DNS records one by one: This method is best for cases where records haven't been set up with other DNS providers or when only a few records are required.

Important

When adding or modifying a DNS record, ensure the hostname and record values are unique:

  • The hostname value can't be the same as any hostname or origin in existing DNS records, nor can it be an origin in an origin pool.

  • The record value can’t be the same as any existing DNS record value.

Bulk import DNS records

To add multiple records in bulk, you can edit a template.

  1. In the ESA console, choose Websites and click the website name you want to manage.

  2. Select DNS > Records, and click Import.

  3. Click Download Template, update the DNS record information in the template and save it. Then, click Select File and choose the updated file.

    The following shows a sample of an updated template:

    Sampe template

    ; Host Record TTL IN Record Type Record Value
    
    $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.
    
    ; MX record
    4.example.com.    600 IN  MX	15 mailhost.example.com.
    
    ; TXT record
    4.example.com.   600 IN  TXT	xxxxxxxxxxxxxxxxxxx
    
    ; NS record
    4.example.com.    600 IN  NS	ns.example.com.
    
    ; SRV record
    _sip._tcp.example.com.   600 IN  SRV	1 5 7001 srvhostname.example.com.
    
    ; CAA record
    hostname.example.com.    600 IN  CAA	0 issue example.com
    
    ; CERT record
    cert.example.com.	1	IN	CERT	0 0 0 VEVwQk5GWXlUR3RXVVZwc1RIcGFhMGh0UVhWUGQweFJFZENNM0JSVFROV2JVd3lWbFJOTkVSS1dnPT0=
    
    ; SMIMEA record
    smimea.example.com.	1	IN	SMIMEA	12 12 12 436c6f7564666c61726520444e53
    
    ; SSHFP record
    sshfp.example.com.	1	IN	SSHFP	12 12 436C6F7564666C61726520444e53
    
    ; TLSA record
    tlsa.example.com.	1	IN	TLSA	12 12 12 436c6f7564666c61726520444e53
    
    ; URI record
    uri.example.com.	1	IN	URI	12 12 "http://www.example.com/service"
  4. On the Import page, check and modify the configuration of the records if necessary. Select a Business Scenario that suit your website the most.

    image

    By default, ESA provides DNS resolution services. However, your website is accelerated and protected only when the Proxy Status is Proxied.

    • For websites added via CNAME, proxy is enabled by default and cannot be modified.

    • For websites added via NS, only A/AAAA and CNAME records can be proxied.

  5. Click OK to import your DNS records.

  6. Optional. If you added the website using CNAME setup, follow the on-screen instructions to configure the CNAME records with your DNS provider after adding the record.

Manually add DNS records

To add an individual DNS record, follow the steps in the example:

The domain name for your origin server is example.com, and you want to accelerate the webpage for the subdomain www.example.com. In this case, select CNAME as the DNS record type.

  1. In the ESA console, choose Websites and click the website name you want to manage.

  2. Select DNS > Records, and click Add Record.

  3. Enter the following required parameters and click Next. For more information on record types and parameters, see Parameters for adding records.

    • Record Type: Select AAAA.

    • Hostname: Enter www.

    • Proxy Status: The proxy is enabled by default.

    • Record Value: Choose the Domain Name option and enter example.com.

    • Origin HOST: The default setting is Match Requested Domain Name.

    • TTL: The default setting is Auto.

  4. Select a Business Scenario that suits your website the most, and click OK.

  5. Optional. If you added the website using CNAME setup, follow the on-screen instructions to configure the CNAME records with your DNS provider after adding the record.

(Optional) How to choose a business scenario

ESA provides three business scenarios: Web, API, and Image/Video:

image

  • Web: Suitable for accelerating websites with both static and dynamic content, such as a mix of small files and API requests. Examples: personal blog websites, small user-generated content platforms, and small independent e-commerce websites.

  • API: Suitable for accelerating purely dynamic APIs, which generally do not require caching. Examples: account and password verification, order payment, log upload, and real-time data synchronization.

  • Image/Video: Suitable for accelerating purely static file businesses. Examples: large numbers of image downloads, video on demand, and delivery of game installation packages.

If you select a scenario that does not completely match your business, it will not affect the basic usability. You can also adjust business types in the console at any time.

However, it is recommended to select the corresponding scenario type based on your actual business characteristics, so that ESA can dynamically allocate more suitable security acceleration policies for your records.