Overview
Menu

Adding A Domain Name for Acceleration

This document describes how to connect your domain name to EdgeOne and enable domain acceleration.

Prerequisites

1. You have connected the site (such as example.com) to EdgeOne. If you want to accelerate domain names in Chinese mainland AZs or global AZs, please complete ICP filing first.
2. 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: 10.1.1.1.
3. If the site is connected via CNAME, you must verify ownership of the domain name. If the site is connected via NS, you must modify DNS server addresses first.

Directions

The procedure for adding subdomain names varies based on the access mode you have selected.
NS Access
CNAME Access
1. Log in to the EdgeOne console. Click the target site in the site list to display second-level menus for site management.
2. In the left sidebar, click Domain Name Service > Acceleration to go to the domain management page.
3. You can select Add domain name or Quick add.

Add domain name
Quick add
1. Click Add domain name to add an domain name for acceleration.
2. Specify the domain name to be connected to EdgeOne and specify the information of the corresponding origin. Then, click Next.

Item
Description
Domain name for acceleration
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 settings
Origin is 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.
Note:
1. It is suggested that your origin should be configured in the same region as the acceleration availability zone. For example, if the acceleration zone is the Chinese mainland availability zone, please configure the origin-pull to be domestic. If the origin is located in the Global availability zone (excluding Chinese mainland), cross-border access may exist during origin-pull, and we cannot ensure the origin-pull effect. If you need to accelerate the access of customers in the Chinese mainland, and the origin is in the Global availability zone (excluding Chinese mainland), you can refer to cross-region security acceleration (overseas site).
2. If your acceleration zone is the Global availability zone, you can add corresponding rules in the rule engine, select Client geographic location as the matching condition, select Modify origin as the operation, and origin-pull to different origins based on different regions to ensure the origin-pull effect.

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.
3. (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 the configuration is displayed in the Rule Engine module. Click Complete to deploy the configuration, or click Skip.

1. Click Quick add to add an domain name for acceleration.
2. Specify the domain name to be connected to EdgeOne and specify the information of the corresponding origin.

Item
Description
Domain name for acceleration
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 settings
Origin is 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: Select this option to add a Tencent Cloud COS bucket or an AWS S3 bucket as the origin.
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.
Note:
1. It is suggested that your origin should be configured in the same region as the acceleration availability zone. For example, if the acceleration zone is the Chinese mainland availability zone, please configure the origin-pull to be domestic. If the origin is located in the Global availability zone (excluding Chinese mainland), cross-border access may exist during origin-pull, and we cannot ensure the origin-pull effect. If you need to accelerate the access of customers in the Chinese mainland, and the origin is in the Global availability zone (excluding Chinese mainland), you can refer to cross-region security acceleration (overseas site).
2. If your acceleration zone is the Global availability zone, you can add corresponding rules in the rule engine, select Client geographic location as the matching condition, select Modify origin as the operation, and origin-pull to different origins based on different regions to ensure the origin-pull effect.

3. Click Save.

1. Log in to the EdgeOne console. Click the target site in the site list to display second-level menus for site management.
2. In the left sidebar, click Domain Name Service > Acceleration to go to the domain management page.
3. You can select Add domain name or Quick add.

Add domain name
Quick add
1. Click Add domain name to add an domain name for acceleration.
2. Specify the domain name to be connected to EdgeOne and specify the information of the corresponding origin. Then, click Next.

Item
Description
Domain name for acceleration
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 settings
Origin is 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: Select this option to add a Tencent Cloud COS bucket or an AWS S3 bucket as the origin.
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.
Note:
1. It is suggested that your origin should be configured in the same region as the acceleration availability zone. For example, if the acceleration zone is the Chinese mainland availability zone, please configure the origin-pull to be domestic. If the origin is located in the Global availability zone (excluding Chinese mainland), cross-border access may exist during origin-pull, and we cannot ensure the origin-pull effect. If you need to accelerate the access of customers in the Chinese mainland, and the origin is in the Global availability zone (excluding Chinese mainland), you can refer to cross-region security acceleration (overseas site).
2. If your acceleration zone is the Global availability zone, you can add corresponding rules in the rule engine, select Client geographic location as the matching condition, select Modify origin as the operation, and origin-pull to different origins based on different regions to ensure the origin-pull effect.

3. (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 the configuration is displayed in the Rule Engine module. Click Next to deploy the configuration, or click Skip.

4. You must complete the CNAME configuration to direct the DNS resolution of the domain name to EdgeOne and then enable domain acceleration. EdgeOne will assign a CNAME address to the domain name. Please visit the DNS provider and configure CNAME records for the domain name.

5. Complete the CNAME configuration, and then click OK.
1. Click Quick add to add an domain name for acceleration.
2. Specify the domain name to be connected to EdgeOne and specify the information of the corresponding origin.

Item
Description
Domain name for acceleration
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 settings
Origin is 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: Select this option to add a Tencent Cloud COS bucket or an AWS S3 bucket as the origin.
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.
Note:
1. It is suggested that your origin should be configured in the same region as the acceleration availability zone. For example, if the acceleration zone is the Chinese mainland availability zone, please configure the origin-pull to be domestic. If the origin is located in the Global availability zone (excluding Chinese mainland), cross-border access may exist during origin-pull, and we cannot ensure the origin-pull effect. If you need to accelerate the access of customers in the Chinese mainland, and the origin is in the Global availability zone (excluding Chinese mainland), you can refer to cross-region security acceleration (overseas site).
2. If your acceleration zone is the Global availability zone, you can add corresponding rules in the rule engine, select Client geographic location as the matching condition, select Modify origin as the operation, and origin-pull to different origins based on different regions to ensure the origin-pull effect.

3. Click Save.
4. You must complete the CNAME configuration to direct the DNS resolution of the domain name to EdgeOne and then enable domain acceleration. EdgeOne will assign a CNAME address to the domain name. Please visit the DNS provider and configure CNAME records for the domain name.



Verifying Domain Name Acceleration

The verification procedure varies based on the access mode you have selected.
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.
You can obtain the IP address of the assigned edge node as instructed below.
Windows
Mac/Linux
1. 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.

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.

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

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 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 not Activated, this may be caused by the CNAME resolution latency of the DNS provider. In this case, you can manually verify the connection as instructed below.
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.