Bind a domain name and configure DNS resolution

Updated at:
Copy as MD

To make your website accessible through a custom domain name, you need to add the domain name, configure DNS resolution, and set up CDN acceleration.

Overview

To access your website using a custom domain name, you must complete three steps: bind the domain name in your website's backend, configure DNS records to point the domain name to the web server, and confirm that CDN acceleration is automatically enabled. This topic provides procedures for two resolution methods: one-click resolution and manual resolution.

Prerequisites

  • You have a valid domain name. You can purchase a domain name from Alibaba Cloud or another domain registrar.

  • Per regulations, you must complete an ICP filing for your domain name to use a Chinese mainland node.

  • If you use the one-click resolution method, ensure the domain name is in your current Alibaba Cloud account and that you have granted the necessary permissions.

Background

Domain name resolution (DNS resolution) is the process of translating a human-readable domain name, such as example.com, into a server IP address. After binding a domain name, you need to add a CNAME record to point it to the record value provided by Wanxiaozi. This allows access to your website through the custom domain name.

The system provides two resolution methods based on domain ownership:

  • One-click resolution (recommended): This method is for domain names registered with Alibaba Cloud and managed in the current Alibaba Cloud account. The system automatically configures the DNS settings, making the process simple.

  • Manual resolution: This method is for domain names registered with other providers or not managed in the current Alibaba Cloud account. You must add the DNS records manually.

Step 1: Bind a domain name

Associate the domain name with your website application. You can do this in one of the following two ways:

Option 1: Quick binding

When you publish your website, Wanxiaozi prompts you to bind a domain name. Enter a domain name from your account to complete the quick binding process.

Option 2: Bind in the website backend

  1. Log on to the Wanxiaozi console. In the navigation pane on the left, choose Wanxiaozi AI Website Builder.

  2. Find the website application you want to manage and click Application Management to access the website management backend.

  3. In the left-side navigation pane, select Website Management > Domain Management to go to the Domain Management page.

  4. Click Bind Domain, enter the full domain name you want to use, and click OK to complete the binding.

Notes

  • The number of custom domains that you can bind to a website varies by edition. To point multiple domain names to the same website, purchase an edition that supports the number of custom domains you need, as listed in Specifications and pricing.

  • After binding a domain name, the system automatically adds the www subdomain. For example, after binding aliyun.com, www.aliyun.com is added automatically, allowing browsers to access your site using the www subdomain.

  • CDN and HTTPS are not supported for Chinese-character domains, but this does not affect normal DNS resolution or website access.

Step 2: Configure DNS resolution

Choose the appropriate resolution method based on your domain registrar and account ownership:

Domain registrar

Account ownership

Recommended option

Description

Alibaba Cloud

Current account

One-click resolution

The system completes the resolution configuration automatically. This is the recommended method.

Other account

Manual resolution

You need to switch to the account that owns the domain name or get authorization to complete the resolution.

Other providers

—

Manual resolution

You need to add the DNS record manually at your domain registrar.

Option 1: Use one-click resolution (recommended)

For domain names in your current Alibaba Cloud account, the system automatically configures the resolution after binding. Wait 2 to 3 minutes for the record value to be generated. If the status does not update, refresh the page manually or click Retry.

  1. ICP filing: Per regulations, you must complete an ICP filing for your domain name if you use a Chinese mainland node.

  2. Account authorization: If you are using this feature for the first time, follow the prompts to grant the necessary permissions.

Note

If you cannot use one-click resolution, confirm that your domain name was purchased from Alibaba Cloud. If you purchased it from another registrar, you must first transfer the domain name to Alibaba Cloud.

Option 2: Manual resolution

  1. ICP filing: Per regulations, you must complete an ICP filing for your domain name if you use a Chinese mainland node.

  2. DNS resolution verification: If your domain name is not registered with Alibaba Cloud or is not in your current account, you must verify ownership by configuring a TXT record.

    1. In the binding status list, click Verify Now, and copy the host record and record value from the pop-up window.

      The window shows the record type as TXT. Go to your domain name's DNS provider to configure the corresponding TXT record. After configuring the record, click Click to Verify.

    2. Go to your domain resolution console and add the TXT record.

      • For domain names not registered with Alibaba Cloud: Add the TXT record through your domain registrar's control panel.

      • For domain names in a different Alibaba Cloud account: Switch to the correct account to perform this operation.

      For an Alibaba Cloud domain name, for example: Switch to the Alibaba Cloud account that owns the domain name, then log on to the Alibaba Cloud DNS console. Go to the Public Authoritative DNS page and click DNS Settings next to the corresponding domain name.

    3. Return to the Wanxiaozi Domain Management page and click Click to Verify. If verification fails, reconfigure the TXT record and try again.

  3. Get the record value. After successfully adding the domain name, wait 2 to 3 minutes for a record value to be generated. Once generated, copy this value.

    In the domain name list, find the Resolution Status column and click Resolve Now. In the Domain Name Resolution dialog box that appears, go to the CNAME Resolution section and click the copy icon next to the record value.

  4. Configure DNS records. For an Alibaba Cloud domain name, for example, log on to the Alibaba Cloud DNS console, find the domain name, and go to its DNS Settings page. Click Add Record. You need to add the following two DNS records.

    1. Record 1: Add a CNAME record for the www subdomain

      • Record type: CNAME

      • Host record: www

      • Record value: Paste the record value you copied in the preceding step.

      • TTL: 10 minutes

    2. Record 2: Add a CNAME record for the root domain

      • Record type: CNAME

      • Host record: @ (@ represents the root domain. Some DNS providers may require this field to be left blank.)

      • Record value: Paste the record value you copied in the preceding step.

      • TTL: 10 minutes

Step 3: Verify the resolution

After adding DNS records, they must propagate across the internet, which takes time based on the TTL (Time to Live) value. Use one of the following methods to verify the resolution:

  1. Open a terminal or command prompt and run one of the following commands:

    • Use the ping command: ping www.example.com (replace www.example.com with your actual domain name).

    • Use the nslookup command: nslookup www.example.com.

  2. Check if the returned result contains the CNAME record value you configured in Step 2.

Propagation time:

  • Alibaba Cloud DNS: Changes typically take effect within 1 to 10 minutes.

  • Other DNS providers: Propagation may take longer (up to 48 hours), depending on the domain name's TTL settings.

Step 4: Check CDN status

Once the domain name resolution takes effect, the system automatically enables CDN acceleration for the domain name. This process takes about 5 to 10 minutes. You can check the result in the CDN Status column on the CDN Management page.

  1. Log on to the Wanxiaozi console. In the navigation pane on the left, choose Wanxiaozi AI Website Builder.

  2. On the application list, find the website you want to manage and click Application Management.

    This action opens the management backend for the selected application.

  3. On the application Overview page, click the Website Management button.

  4. In the navigation pane on the left, choose Website Management > CDN Management.

    Alibaba Cloud CDN has certain usage limits that may cause automatic CDN activation to fail. If the status is abnormal, refer to "Troubleshoot CDN status" below.

    If the CDN status is abnormal, the CDN Status column in the domain name list displays the specific reason, such as The domain does not have an ICP filing.

Note

The CDN acceleration scope for Chinese mainland nodes is global. The CDN acceleration scope for Hong Kong (China) nodes is global, excluding the Chinese mainland.

FAQ

What should I do if the CDN status remains "Configuring" for a long time after adding a domain name?

After the domain name resolution takes effect, automatic CDN acceleration takes about 5 to 10 minutes. If the status is still "Configuring" after 10 minutes, try the following:

  • Refresh the page to see if the status has updated.

  • On the CDN Management page, find the corresponding domain name and click Resubmit.

  • If the issue persists, check that your domain name has a valid ICP filing and that the DNS records are configured correctly.

CDN status alerts and troubleshooting

CDN status alert

Solution

The domain does not have an ICP filing

Complete the ICP filing. After it is approved, wait 7 to 24 hours, and then click the Resubmit button in the Actions column to enable CDN again.

CDN acceleration is not supported for Chinese domains

CDN acceleration is not supported for the Chinese-character domain you have bound. This does not affect domain name resolution.

The domain has already been added

Use the intelligent workflow tool. Enter Domain is occupied by a CDN-related product and follow the steps. Then, click the Resubmit button in the Actions column to enable CDN again.

Operation timed out. Please try again.

The CDN activation timed out. Click the Resubmit button in the Actions column to enable CDN again.

The number of domains exceeds the limit. Please contact customer service.

Each Alibaba Cloud account can add a maximum of 50 accelerated domain names. If you have reached this limit, you must disable or delete unused accelerated domain names in the CDN management console.

Domain does not exist or does not belong to the current user

Please log in to the account that purchased the domain name and grant authorization.

You do not have permission to operate this domain

If the domain name has special restrictions allowing only specified accounts to operate it, please switch to the authorized account and try again.

No permission to operate this domain

This message may appear if the domain name is restricted to a specific account. We recommend using the administrator account that purchased the domain name to grant authorization.

The domain is on the Alibaba Cloud blocklist

Domains associated with pirated software, unlicensed medical or pharmaceutical sites, or illegal content (such as pornography, drugs, or gambling) are typically on the Alibaba Cloud blocklist. Please submit a ticket for assistance.

The domain is being configured. Please try again later

Please wait a moment and try again.

The domain is being added. Do not submit again

The domain name is being added. Please do not submit the request again.

The system is being upgraded. Please try again later

Please wait a moment and try again.

You do not have permission to perform this operation

This can happen if you are using a RAM user that lacks the required permissions.

Failed to add CDN. Please verify the domain

Click Verify Domain to get the record type, host record, and record value. Then, log on to the Alibaba Cloud DNS console. On the DNS resolution page, find the domain name, click DNS Settings, and then click Add Record. Enter the provided record type, host record, and record value.

How do I configure resolution for a domain name not registered with Alibaba Cloud?

For domain names registered with another provider, you need to add CNAME records at your domain registrar. The steps are as follows:

  1. Log on to your domain registrar's management console and find the domain resolution or DNS management page.

  2. Add two CNAME records: one with the host record as www and another with the host record as @ (or leave it blank). For both records, use the record value provided on the Wanxiaozi Domain Management page.

  3. Save the changes and wait for the DNS to propagate (usually within 10 minutes). Return to the Wanxiaozi Domain Management page to check the CDN status.

Why are CDN and HTTPS not supported for Chinese-character domains?

Chinese domain names are not supported for CDN acceleration or HTTPS certificate configuration because their encoding format is different from the Punycode encoding used for standard international domain names. You can still use Chinese domain names for normal DNS resolution and website access, but you cannot use the CDN acceleration or HTTPS encryption features.

How many domain names can be bound to one website?

The number of custom domains that you can bind to a website varies by edition. To point multiple domain names to the same website, purchase an edition that supports the number of custom domains you need, as listed in Specifications and pricing. After adding a domain name like aliyun.com, the system automatically adds the www version (www.aliyun.com) to ensure visitors can access your site via the www subdomain.

Each Alibaba Cloud account is limited to 50 accelerated domain names in the CDN product. If you need to add more, you must disable or delete unused accelerated domain names in the CDN management console.

How long does it take for DNS records to take effect?

The time it takes for a DNS record to take effect depends on its TTL (Time to Live) setting and the caching behavior of DNS servers worldwide. Typically:

  • Alibaba Cloud DNS: Changes usually take effect within 1 to 10 minutes.

  • Other DNS providers: Propagation may take longer (up to 48 hours), depending on the domain name's TTL settings.

If a record has not taken effect after an extended period, you can use the ping or nslookup command to verify if the domain name is resolving to the correct record value.