Menu

Quick Start

This document describes how to add a site to Tencent Cloud EdgeOne and enable secure acceleration, so that you can get a quick start with the EdgeOne service.

EdgeOne brings the following benefits to your site:
EdgeOne nodes provide dynamic and static smart acceleration, to enable users to obtain resources from nodes nearby, which avoids network issues due to cross-region or cross-ISP access.
Files are cached on nodes to reduce the proportion of origin-pull requests, which decreases the traffic to the origin.
Services are provided from EdgeOne nodes to hide the IP address of the origin and protect the origin from malicious attacks.
More EdgeOne capabilities, such as DNS, security protection, edge functions, and L4 proxy, can be integrated with your site.



Preparations

1. You have registered a Tencent Cloud account.
2. You have registered a domain name, such as example.com. For more information about domain name registration, see Domain Registration.
Note:
If you want to set the service region of your site to Chinese mainland or Global, the domain name must have been filed with the Chinese Ministry of Industry and Information Technology.
3. Your site is hosted on an accessible service, such as Cloud Virtual Machine (CVM) or Cloud Object Storage (COS). For example, you have built a cross-border e-commerce site based on Tencent Cloud CVM, and the current server IP address is: 1.1.1.1.



Step 1: Add the Site

Perform the following operations to add the site to EdgeOne:
1. Log in to the EdgeOne console.
2. Click Add site.

3. In the Enter your site input box, enter the domain name, In this example, enter example.com. Then, click Next.


Step 2: Select Service Region and Plan

This step requires binding the site access plan specs so that the platform can allocate the corresponding service resources for you. You can bind by purchase plan or bind sites to your plan:
Purchase plan
Bind sites to your plan
1. When entering the plan selection, the default is the Purchase plan page. Currently. You can view the Comparison of EdgeOne Plans to see the differences between the different plan versions.

2. After confirming the plan, check and agree to the EdgeOne Service Level Agreement below, and click the next step.
1. If you have already purchased a plan, you can click Bind sites to your plan to switch to the binding plan page and select the purchased plan to bind.

1. 
2. After selecting the plan, check and agree to the EdgeOne Service Level Agreement below, and click Next.

Step 3: Select the Access Mode

This step requires selecting the acceleration region and access mode that meet your needs.
1. Select the acceleration region. The acceleration region is mainly used to allocate node resources for the current site. When you select the Chinese mainland availability zone and the Global availability zone, it is required that the current domain has completed the MIIT (Ministry of Industry and Information Technology) ICP Filing.

2. Select the access mode. EdgeOne provides you with two access modes, namely NS server access mode and CNAME access mode. The differences between the different access modes are as follows:
Mode
NS Access (Recommended)
CNAME Access
Scenario
You want to change the original DNS provider and host DNS on EdgeOne.
You have hosted the domain name to another DNS provider, such as Tencent Cloud DNSPod, and you do not want to change the DNS provider.
Access mode
You only need to change the settings of the DNS server once at the original DNS provider. After that, you can easily enable secure acceleration for the domain name in the EdgeOne console.
Each time you add a new subdomain and enable secure acceleration, you must add a CNAME record at the corresponding DNS provider.
Verification method
You need to change the URLs of the original NS servers to the ones provided by EdgeOne.
You need to verify the domain name ownership by adding a DNS record or using the verification file.
Scheduling method
After secure acceleration is enabled for the domain name, it points to the nearest EdgeOne node by using the A record.
After secure acceleration is enabled for the domain name, the client access is scheduled to the nearest EdgeOne node by using the CNAME record.
NS Access
CNAME Access
1. On the Select an access mode tab, select NS access.
2. (Optional) In NS Access mode, EdgeOne automatically scans all DNS records for the domain name. You can verify the scan results by comparing them with the original DNS records.
If all the original DNS resolution records are retrieved, clicking Import all to import them to EdgeOne.
If you find that some DNS resolution records are missing, click Add record or Batch import to add them.

3. Click Next. In the NS server access mode, you need to go to the original domain registration service provider and change the domain's DNS server address to the DNS server address provided by EdgeOne. The operation steps can be referred to: Modify DNS server.

4. After the change, EdgeOne automatically detects the current URLs of the NS servers. After settings of the NS servers take effect, click OK.
Note:
The process may be slow with some domain registrars, please be patient.

1. On the Select an access mode tab, select CNAME access and click Next.
2. Verify the site ownership. EdgeOne allows you to verify your site ownership through DNS verification or file verification. For more information, see Verifying Site Ownership.

3. After the site ownership is verified, click OK.

Step 4: Add the Domain Name

The procedure varies based on the access mode you have selected in step 3.
Note:
1. Conversion of Chinese, Korean, and Japanese domain names to punycode and domain names containing underscores are not supported.
2. After you add a domain name, if your origin HOST type is IP address/domain name, the Host Header is the acceleration domain name by default. If your Host Header needs to specify a domain name, you can configure it according to Host Header Rewrite. If the Origin is the object storage origin, the default Host Header is the domain name of the object storage origin.
NS Access
CNAME Access
1. Click Site List in the left sidebar and select the added site to go to the details management page.
2. Choose Domain Name Service > DNS records to go to the DNS management page.
3. Click Add record, specify the record type, host record, and record value, and click Save. The host record is the subdomain name. For example, if the domain name is www.example.com, the host record is www. The record value is the IP address of your origin. For example, if you have built a cross-border e-commerce site based on Cloud Virtual Machine (CVM), and hosted the site on a server whose IP address is 10.1.1.1, the record value is 10.1.1.1. For more information about the DNS record types, see NS Connection.

4. Click Enable acceleration for the domain name.


5. Choose Domain Name Service > Acceleration to view and manage all the accelerated domain names.
1. Click Site List in the left sidebar and select the added site to go to the details management page.
2. Choose Domain Name Service > Domain management. On the Domain management page, click Add Domain.
3. Specify the domain name to be connected to EdgeOne and specify the information of the corresponding origin. Then, click Next.

Configuration Item
Description
Domain name
The domain name accessible to the client. You can enter the value of the host record. EdgeOne supports connecting wildcard domain names. If you want to access the root domain, enter @.
For example, if the domain name is www.example.com, enter www.
Origin type
The address of the resource that is accessed when the client initiates a request. Options: IP/Domain name, Object storage origin, and Origin Group.
IP/Domain name: Select this option to add a single IP address or domain name as the origin.
Object storage origin: This is utilized for the addition of Tencent Cloud COS and buckets that have already activated private read-write permissions of buckets of S3 compatible type. If the bucket is public read-write. IP address/domain access can also be employed.
Origin Group: Select this option to add multiple IP addresses as the origin.
For example, you have built a cross-border e-commerce site based on CVM, and hosted it on a server whose IP address is 10.1.1.1, you can select IP/Domain name and enter 10.1.1.1 in the IP/Domain name field.
IPv6 access
Select whether to enable support for access via IPv6. Refer to the document: IPv6 Access.
Origin-pull protocol
Choose the access protocol supported by your origin. Options include:
Follow protocol: The protocol used during origin-pull is identical to the user's access request protocol.
HTTP: The HTTP protocol is used for origin-pull.
HTTPS: The HTTPS protocol is used for origin-pull.
Origin-pull port
Specify the port to be used during origin-pull. Please ensure that the designated port of your origin server is accessible.
4. (Optional) After you add the domain name, EdgeOne provides you with recommended configurations for different business scenarios to ensure that your business runs securely and smoothly. You can select a recommended configuration as needed and click Next to deploy the configuration, or click Skip.

5. Visit the original DNS provider and change the DNS resolution records by using the CNAME address and resolution records provided by EdgeOne. You must complete the CNAME configuration at this step to direct the DNS resolution of your domain name to EdgeOne and then enable domain acceleration.

6. Complete the CNAME configuration, and then click OK.

Step 5: Perform Access Test

You can perform the following two steps to verify whether your site is connected to EdgeOne and test the acceleration performance:

1. Verify whether your site is connected to EdgeOne

The verification procedure varies based on the access mode you have selected in step 3.
NS Access
CNAME Access
In NS access mode, when the client accesses the accelerated domain, EdgeOne automatically schedule the access to the nearest edge node. You can check whether the IP address of the assigned edge node is on EdgeOne to verify whether the site has been added to EdgeOne.
1. You can obtain the IP address of the assigned edge node by using any of the following methods:
Windows
Mac/Linux
Visit the site
Open the command prompt and run the nslookup -qt=A www.example.com command. Then, check the IP address of the domain obtained by the A record resolution.

Open the terminal and run the dig www.example.com command. Then, check the IP address of the domain obtained by the A record resolution.

Visit www.example.com from a browser, press F12 to open the developer tools, and click any request record to view the IP address to which the request points. Then, copy this IP address.

2. On the IP Location Query page of the EdgeOne console, paste the IP address in the IP field and click Search to check whether the IP address is on EdgeOne. If yes, DNS of the accelerated domain has been switched to EdgeOne.

After you complete the CNAME configuration, EdgeOne automatically detects whether the CNAME configuration has taken effect. In the domain list, if the Status column of the accelerated domain is Activated, the domain is correctly configured and accelerated.

If you have correctly configured the CNAME record, but the status is CNAME unconfigured, this may be caused by the CNAME resolution latency of the DNS provider. In this case, you can manually verify the connection by using the following methods:
Windows
Mac/Linux
Open the command prompt and run the nslookup -qt=cname www.example.com command. Then, check the CNAME information of the domain. If the CNAME information is the same as that provided by EdgeOne, DNS of the accelerated domain has been switched to EdgeOne.

Open the terminal and run the dig www.example.com command. Then, check the CNAME information of the domain. If the CNAME information is the same as that provided by EdgeOne, DNS of the accelerated domain has been switched to EdgeOne.



2. Verify the site acceleration performance

If the site is connected to EdgeOne, EdgeOne can accelerate access to the site.
Before connecting the site to EdgeOne, you can perform the following operations to check the speed of direct access: Open a browser, press F12 to open the developer tools, and then visit the IP address of the server. In this case, visit 10.1.1.1. In the bottom right corner of the developer tools, you can see that it took 1.22s to load the site.

After connecting the site to EdgeOne, you can visit the domain added to EdgeOne, for example, www.example.com, and refresh the page several times. After that, you can see in the bottom right corner that the total loading time of the site has been reduced to 695 ms.


Learn More