All Products
Search
Document Center

Edge Security Acceleration:Get started with DNS records

Last Updated:Nov 28, 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

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

This approach is particularly useful in scenarios where DNS records from other service providers need to be transferred to ESA. To add multiple records in bulk, you can edit a template.

  1. In the ESA console, choose Websites. In the Website column, click the target website.

  2. Select DNS > Records, and click Import.

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

    image

    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

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. 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. In the Website column, click the target website.

  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 CNAME.

    • 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.

      Note

      If no origin rule is configured, the default rule applies:

      • Origin HOST: Based on the HOST policy set in the DNS record.

      • Origin SNI: Equal to the origin SNI.

      • Origin protocol and port: Follows the protocol and port of the client request by default.

    • TTL: The default setting is Auto.

      image

  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.

Note

Hostnames support the following characters: lowercase letters, numbers, wildcard * (only for wildcard domain records), hyphens - (cannot begin or end with a hyphen), at sign @ (only for root domain records), and underscores _ (only for TXT, CAA, CNAME, NS, and SRV records). The maximum length of a hostname is 63 characters.

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.