Add a domain name to Alibaba Cloud CDN - Quick Start| Alibaba Cloud Documentation Center

To add a domain name to Alibaba Cloud CDN, perform the following steps:

Step 1: Complete basic settings and specify business information
Step 2: Set up origin servers
Step 3: Complete ownership verification

For more information about the health check policies on origin servers, see Configure a health check policy for an origin server.

Prerequisites

An origin server with stable performance is deployed.

Note If the accelerated region is Mainland China Only or Global, you must apply for an Internet Content Provider (ICP) number for the domain name. If the domain name does not have an ICP number, you can use Alibaba Cloud ICP Filing System to apply for one.
Alibaba Cloud CDN is activated. For more information about how to activate Alibaba Cloud CDN, see Activate Alibaba Cloud CDN.

Step 1: Complete basic settings and specify business information

Log on to the Alibaba Cloud CDN console.
In the left-side navigation pane, click Domain Names.
Click Add Domain Name and set the following parameters.


Parameter	Description
Domain Name to Accelerate	Domain name Type: The domain name to be accelerated can be a specific domain name such as `example.aliyundoc.co` or a wildcard domain name such as `.aliyundoc.com`. Domain name format: The domain name must be in lowercase letters. Chinese characters are not supported. Notice* If the domain name contains Chinese characters such as 阿里云.网址, you must apply for an ICP number for the domain name in Chinese characters, and use the tool Punycode to convert the domain name to English letters, such as xn--fiq**.xn--eq. Then, you can specify it as the domain name to be accelerated. Requirements for wildcard domain names: For more information, see Does Alibaba Cloud CDN support wildcard domain names? Notice The specified wildcard domain name and the domain names that match the wildcard domain name must belong to the same Alibaba Cloud account. To request technical support from Alibaba Cloud, submit a ticket. If a wildcard domain name is not added to Alibaba Cloud CDN, you can add domain names that match the wildcard domain name to Alibaba Cloud CDN by using different Alibaba Cloud accounts. You cannot add duplicate domain names to Alibaba Cloud CDN. If the system prompts that the domain name has been added to other Alibaba Cloud services such as ApsaraVideo VOD or Dynamic Route for CDN (DCDN), you can submit a ticket. Each Alibaba Cloud account can add at most 50 domain names to Alibaba Cloud CDN. However, if the sum of the average daily peak bandwidth values of your domain names exceeds 50 Mbit/s, you can submit a ticket to add more domain names to Alibaba Cloud CDN. Make sure that the increase of domain names does not cause business risks. The content delivered from the domain name must be legal and comply with the Terms of Service for Alibaba Cloud CDN.** For more information, see Limits.
Business Type	Notice The business type cannot be modified after it is set. Proceed with caution. Image and small file distribution: accelerates the delivery of small-sized static content on websites, such as e-commerce content and game images. Large file distribution: accelerates the delivery of static files that are larger than 20 MB. On-demand audio and video streaming: accelerates the delivery of audio or video content. DCDN: accelerates the delivery of both static and dynamic content. DCDN can accelerate the delivery of large amounts of dynamic content. If you set Business Type to DCDN, you must follow the instructions to go to the DCDN console to add and configure the domain name. For more information, see Add a domain name.
Region	Mainland China Only: All requests are scheduled to edge nodes that are deployed in mainland China. Requests from outside mainland China are scheduled to edge nodes managed by China Telecom (East China Division). Global: All requests are scheduled to the nearest edge nodes. Global (Excluding Mainland China): All requests are scheduled to edge nodes that are deployed in Hong Kong (China), Macao (China), Taiwan (China), or other countries or regions outside mainland China. However, requests from mainland China are scheduled to edge nodes that are deployed in Japan, Singapore, or Hong Kong (China). Notice If you select Mainland China Only or Global, you must apply for an ICP number for the accelerated domain name. We recommend that you use Alibaba Cloud ICP Filing System to apply for ICP numbers. It may take some time for Ministry of Industry and Information Technology (MIIT) to update data in the database. After you submit domain name information to MIIT, we recommend that you wait 8 hours before you configure the domain name in Alibaba Cloud CDN. The pricing strategies vary based on the accelerated region. Choose an accelerated region based on your business requirements. For more information about the pricing of Alibaba Cloud CDN, see CDN pricing.

Step 2: Set up origin servers

After you complete the basic settings and specify business information, click Add Origin Server.

In the Add Origin Server dialog box, set the following parameters.


Parameter	Description
Origin Info	Select the type of the origin server and enter the address of the origin server. Note You can add at most 20 origin servers. OSS Domain If you use an OSS bucket as the origin server, you can enter the public endpoint of the OSS bucket, for example, `*.oss-cn-hangzhou.aliyundoc.com`. Internal endpoints of OSS buckets are not supported. To view the public endpoint of an OSS bucket, log on to the OSS console. You can also select the endpoint of an OSS bucket that belongs to the current Alibaba Cloud account from the Domain Name drop-down list. IP Enter the public IP addresses of one or more servers. Public IP addresses of Alibaba Cloud Elastic Compute Service (ECS) instances do not need to be reviewed. Site Domain Enter the domain names of one or more origin servers. Note The domain name of the origin server cannot be the same as the domain name to be accelerated. Otherwise, a DNS resolution loop occurs and requests cannot be redirected to the origin server. The domain name must be in lowercase letters. If the domain name contains Chinese characters such as 阿里云.网址, you must apply for an ICP number for the domain name in Chinese characters, and use the tool Punycode to convert the domain name to English letters, such as xn--fiq.xn--eq**. Then, you can specify it as the domain name to be accelerated. Function Compute Domain Enter a Function Compute domain name that belongs to the current Alibaba Cloud account. You must set the Region and Domain Name parameters for the Function Compute domain name. For more information, see Overview.
Priority	You can set priorities to specify primary and secondary origin servers. The primary origin server has a higher priority than the secondary origin servers. Alibaba Cloud CDN preferably redirects requests to the primary origin server. For example, you have specified two origin servers: Server A and Server B. Server A is the primary origin server and Server B is the secondary origin server. In this case, Alibaba Cloud CDN preferentially redirects requests to Server A. If Origin Server A fails, Alibaba Cloud CDN redirects user requests to Origin Server B. After Origin Server A recovers, Alibaba Cloud CDN fails back to Origin Server A.
Weight	If origin servers have the same priority, Alibaba Cloud CDN redirects requests to the origin servers based on their weights. This balances loads among the origin servers. You can specify a weight based on your business requirements. The valid values of origin server weights are 1 to 100. A greater value indicates a higher weight. An origin server with a higher weight receives more user requests. Default value: 10. For example, both Origin Server A and Origin Server B are specified as primary origin servers. The weight of Origin Server A is 80 and the weight of Origin Server B is 20. In this case, Alibaba Cloud CDN redirects user requests to both origin servers at a ratio of 8:2.
Port	The port on the origin server that processes requests. The default port is port 80. You can specify a port based on the settings of your origin server. Valid values are 1 to 65535. Default value: 80. If you specify port 443, requests are redirected to the origin server over HTTPS. If you specify port 80 or a custom port, requests are redirected to the origin server over HTTP. Note If you want Alibaba Cloud CDN to redirect HTTPS requests to origin servers over custom ports, submit a ticket. If Origin Protocol Policy is enabled, custom ports do not take effect. For more information about how to disable the origin protocol policy, see Configure the origin protocol policy. If the origin server is an OSS bucket, OSS determines whether you can specify a custom port.

After the configuration is complete, click OK.
Optional:You can repeat the preceding steps to add more origin servers.

Step 3: Complete ownership verification

After you set up origin servers, click Next.
Optional:If this is the first time the domain name is added to Alibaba Cloud CDN, Alibaba Cloud CDN must verify the ownership of the domain name.

Note For more information, see Verify the ownership of a domain name. If the domain name has already passed the verification, skip this step.
Wait for manual verification.

Note If the domain name does not need to be manually verified, proceed to the next step. In the next step, you can set the parameters based on your business requirements.

It takes one to two business days to complete the verification. If you require prioritized verification, submit a ticket.

After the domain name passes the verification, the status of the domain name changes to Enabled. In this case, the domain name is added to Alibaba Cloud CDN.

Configure a health check policy for an origin server

CDN edge nodes provide Layer 4 (TCP) health checks on origin servers. CDN edge nodes perform health checks on origin servers to check the availability of the origin servers in case back-to-origin routing fails.

If a user sends a Layer 4 connection request to the same IP address and port for two consecutive times, and the origin server is unavailable due to reasons such as connection failures or timeouts for both times, Alibaba Cloud CDN moves the IP address of the origin server from the back-to-origin routing address list to the dead table. Meanwhile, Alibaba Cloud CDN attempts to access origin servers in descending order of priority. If origin servers have the same priority, they are prioritized based on their weights. If the IP address of an origin server remains unavailable for two consecutive times, a scheduled task is started. The task sends Layer 4 TCP probes to the IP address every 5 seconds. The IP address is added to the available IP list only after a TCP connection to the IP address is established.

Note

Probes are sent to IP addresses. If the address of an origin server is a domain name, Alibaba Cloud CDN accesses the secondary origin server only if all the IP addresses that belong to the domain name are unavailable.
Probes automatically skip origin servers that are in the dead table.

What to do next

Add a CNAME record: After a domain name is added to Alibaba Cloud CDN, Alibaba Cloud CDN assigns a CNAME to the domain name. You must add a CNAME record for the domain name before CDN acceleration can take effect.

Note We recommend that you configure the following features before you add a CNAME record for the domain name:

Configure system-recommended features (optional): You can set cache expiration rules and bandwidth caps, increase cache hit ratios, reinforce protection, and improve content delivery performance.
Test whether a domain name is accessible (optional): You can perform this operation to ensure that DNS updates do not effect the services of your website.

Related API operations


Feature	API
Adds a domain name.	AddCdnDomain: Adds a domain name to Alibaba Cloud CDN. BatchAddCdnDomain: Adds multiple domain names to Alibaba Cloud CDN at a time.
Verify the ownership of a domain name	VerifyDomainOwner: Verifies the ownership of a domain name by adding a DNS record. DescribeVerifyContent: Verifies the ownership of a domain name by uploading a verification file.