Add a service domain name

Prerequisites

• You have a domain name and a stable origin server.

  Note

  • If the service location is set to Chinese Mainland Only or Global, the domain name must have an ICP filing. Apply through the Alibaba Cloud ICP Filing system.

  • If the service location includes the Chinese mainland, complete real-name verification.

• DCDN is activated. Activate DCDN.

Step 1: Configure basic information

1. Log on to the DCDN console.

2. In the left-side navigation pane, click Domain Names.

3. On the Domain Names page, click Add Domain Name and configure the basic information.

   Note

   The first time you add a domain name, verify ownership of the root domain. Verify the ownership of a domain name. Skip this step if you have already verified the root domain.

   

   Parameter	Description
   Business Type	DCDN: Accelerates dynamic and static content delivery. IP Application Accelerator: Accelerates applications that use non-HTTP protocols, particularly for services that use custom Layer 4 protocols, to reduce latency and improve access performance. Note If the business type is set to IP Application Accelerator, Location only supports Chinese Mainland Only.
   Location	Select a service location. When the service location is Chinese Mainland Only or Global, the domain name must have an ICP filing. Complete the filing through the Alibaba Cloud ICP Filing system. Allow 8 hours after filing completion before configuring the domain name due to MIIT system delays. Note Pricing varies by service location. DCDN pricingDCDN pricing.
   Domain Name to Accelerate	Format: The domain name must be in lowercase letters, such as example.com. Domain names that contain uppercase letters are invalid. If the domain name contains Chinese characters, such as 阿里云.网址, you must apply for an ICP number for the domain name and use the Punycode tool to convert the Chinese domain name into its ASCII equivalent, such as xn--fiq****.xn--eq****. Requirements for wildcard domain names: Dynamic Content Delivery Network (DCDN) supports wildcard domain names. For more information about the limits on wildcard domain names, see Does DCDN support wildcard domain names? The wildcard domain name that you specify and the domain names that match the wildcard domain name must belong to the same Alibaba Cloud account. Otherwise, an error message appears when you add domain names. If a wildcard domain name is not added to an Alibaba Cloud account, you are allowed to add the subdomains of the wildcard domain name to multiple Alibaba Cloud accounts. When you add wildcard domain names such as .aliyundoc.com along with associated specific domain names such as example.aliyundoc.com to DCDN, the maximum specific domain names that can be accelerated is 500. Note The first 500 specific domain names that match the wildcard domain name can be accelerated by DCDN. You cannot add domain names that have been added to other Alibaba Cloud services. If the system prompts that the domain name is added to other Alibaba Cloud services such as ApsaraVideo VOD and Alibaba Cloud CDN, submit a request. Each Alibaba Cloud account can add a maximum of 50 domain names to DCDN. If the average daily peak bandwidth of your domain names exceeds 50 Mbit/s, you can apply to add more domain names to DCDN. For more information, see Quota management. The content that is delivered from the domain name must be legal and comply with the Terms of Service for DCDN. For more information, see Limits. Length: A domain name cannot exceed 67 characters in length. ICP filing: If you set the service location of a domain name to Global or Chinese Mainland Only, you need to apply for an ICP number for the domain name. We recommend that you use Alibaba Cloud ICP Filing System to apply for ICP numbers. Domain name reclaiming: If your domain name remains disabled for 120 days, DCDN automatically deletes the configuration records that are related to the domain name. This rule also applies to domain names that fail ownership verification. If you want to continue using the domain name, you must add the domain name in the DCDN console again. Domain name disabling: For more information, see Announcement on adjustments to domain name offline rules. Sandbox: If an accelerated domain name becomes the target of an attack, such as DDoS attack or HTTP flood attack, or faces significant increases in bandwidth or QPS due to traffic spikes that have not been reported to Alibaba Cloud, DCDN reserves the right to add the attacked domain name to a sandbox based on factors such as the service status of the domain name and the impact of the attack. This ensures that the acceleration services of other users can work as expected. For more information about sandboxes, see Introduction to sandboxes. If the attack is severe, other accelerated domain names in the same account are also added to the sandbox, and the addition of new domain names to the account is restricted.
   Resource Group	Select the default or a custom resource group. Create a resource group.
   Tag	Tag Key: Select an existing key or enter a new one. Prefix-based search is supported. You can add a maximum of 20 tag keys at a time. Tag Value: Select an existing value or enter a new one. You can leave the value empty. Note For more information about the rules for creating a new tag, see Tag rules.

Step 2: Configure an origin server

Configure an origin server after setting up the basic information.

1. In the Origin Information section, click Add Origin Server.

2. In the Add Origin Server dialog box, configure the following parameters.

   

   Parameter	Description
   Type	Select the origin server type and enter its address (up to 67 characters). You can add up to 20 origin servers per domain name. OSS Domain If you use an Object Storage Service (OSS) bucket as the origin server, you can enter the public domain name of the OSS bucket, such as ***.oss-cn-hangzhou.aliyundoc.com. You can obtain the public domain name of an OSS bucket in the OSS console. You can also select the domain name of an OSS bucket that belongs to the current Alibaba Cloud account from the Domain Name drop-down list. IP: You can configure one or more IP addresses for an origin server. Internal IP addresses are not supported. IPv4 addresses and IPv6 addresses are supported. At least one of the IP addresses must be an IPv4 address. If you use a public IP address of an Alibaba Cloud Elastic Compute Service (ECS) instance as the address of the origin server, the IP address is exempt from manual review. You need to obtain the permissions to configure origin fetch over IPv6 in advance. Otherwise, updates to settings about IPv6 will be ineffective. For more information, see Configure origin fetch over IPv6. Origin Domain: You can configure one or more origin domain names. Configuration rules for origin domains (click to expand rule details) The origin domain cannot be the same as the accelerated domain name. Otherwise, a back-to-origin error occurs due to loop resolution. The format of the origin domain name: The domain name must be 1 to 67 characters in length, and can contain lowercase letters, digits, and hyphens (-). Example: example.com. The domain name cannot contain Chinese characters, uppercase letters, or special characters other than hyphens (-). The domain name cannot be only a hyphen (-). A hyphen (-) in a domain name cannot be followed by another hyphen (-). The domain name cannot start or end with a hyphen (-). 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 Punycode tool to convert the Chinese characters into English letters, such as xn--fiq****.xn--eq****. Then, you can specify the converted domain name as the domain name that you want to accelerate. You can add the domain name of an Alibaba Cloud Application Load Balancer (ALB) instance, such as example.hangzhou.alb.aliyuncs.com, as the address of an origin server.
   Priority	The priority setting determines which origin servers are primary and which are secondary. Primary origin servers have a higher priority than secondary ones. When Alibaba Cloud DCDN performs an origin fetch, it first attempts to connect to a primary origin server. If a primary origin server fails (for example, if a TCP connection cannot be established), requests are automatically routed to a secondary origin server. The valid range for priority is 0 to 127, where a smaller value indicates a higher priority. The default priority for a primary origin is 20, and for a secondary origin is 30. To configure other values, you must submit a ticket. For example, if you have two origin servers, A and B, where A is the primary and B is the secondary, Alibaba Cloud DCDN will first route origin fetch requests to server A. If server A fails (for example, the TCP connection fails), requests will be routed to server B. When server A becomes available again, traffic will fail back from B to A.
   Weight	When multiple origin servers have the same priority, Alibaba Cloud DCDN distributes origin fetch requests among them based on their assigned weight, enabling weighted load balancing. You can set the weight for each origin server based on its capacity. Valid values: 1 to 100. A higher value means the origin server receives a larger proportion of requests. Default value: 10. For example, if you have two origin servers, A and B, both with primary priority, and you set the weight of A to 80 and B to 20, requests will be distributed between them at an 8:2 ratio. Note Weight-based routing applies only to static content by default. To apply it to dynamic content, enable dynamic load balancing. Configure back-to-origin routing to retrieve dynamic content. The actual request distribution may not match configured weights in some cases: Low back-to-origin QPS (for example, less than 10 QPS) can cause uneven distribution. If requests come from one or a few IP addresses, DCDN routes them to the same node and may direct most requests to one origin server due to persistent TCP connections. To verify weight distribution, use a third-party monitoring tool with probe clients across diverse locations and ISPs.
   Port	Select a port that your origin server supports. Port 80: DCDN retrieves content from the origin server through port 80. Port 443: DCDN retrieves content from the origin server through port 443. The origin server must support HTTPS. Note DCDN supports only ports 80 and 443 by default. To use a custom port, submit a ticket.

3. After you complete the configuration, click OK.

4. Optional: Repeat the preceding steps to add more origin servers.

Step 3: Submit for review

1. Agree to the Compliance Warranty Regarding Cross-border Data Transfers, and then click Next.

2. Wait for a manual review.

   Note

   • If your domain name does not require manual review, proceed to complete the recommended configurations.

   • A new domain name typically becomes active within 10 minutes, though activation may take up to 30 minutes in rare cases. If it exceeds 30 minutes, Alibaba Cloud engineers will intervene.

What to do next

• Check whether a domain name is accessible (optional): Test domain accessibility before going live to avoid service disruption. If the test succeeds, configure the CNAME record.

• Configure a CNAME: DCDN assigns a CNAME to your domain. Add a CNAME record at your DNS provider to point the domain to this CNAME and enable acceleration.

FAQ

• What should I do if DCDN reports that my domain name is already in use by another cloud service or Alibaba Cloud account?

• My domain has an ICP filing, but DCDN reports it does not. What should I do?

• If I add a root domain to DCDN, are its subdomains also accelerated?

• How do I apply DCDN to a root domain name and subdomain names?

• How do I disable or remove an accelerated domain name?

Related documents

• Learn about accelerated domain name.

• Add domain names programmatically with AddDcdnDomain and BatchAddDcdnDomain.

• Configure an origin server for an accelerated domain name.

• Change the service location of an accelerated domain name.