Alibaba Cloud DNS:Add a DNS record

Limits

• Obtain the public IPv4 address of the target server. Example: 192.0.2.1.

  • If you use Alibaba Cloud ECS, you can view the public IP address in the Alibaba Cloud ECS console.

  • If you use a non-Alibaba Cloud server, contact your service provider to obtain the public IP address.

• If the hostname is not @, A records conflict with NS, CNAME, ALIAS, or URL records when the hostname and resolution line are identical. If you receive a conflict error when adding an A record, delete the conflicting record or change the hostname. For more information, see DNS record conflict rules.

How to set up

1. On the Alibaba Cloud DNS – Public Zone page, click the target domain name to go to the Settings page.

2. Click the Add Record button.

3. Fill in the form fields.

   Field	Description	Recommended value
   Record Type	Different record types require different record values.	Select A from the drop-down list. Resolves the domain name to a specified IPv4 address.
   Hostname	Usually the prefix of a subdomain.	If the domain name is www.example.com, enter www. If the domain name is example.com, enter @. If the domain name is demo.example.com, enter demo. If the domain name is test.blog.example.com, enter test.blog.
   Query Source	Specifies the source of DNS queries. Select Default unless you need to return different record values based on the user’s location. For example, use smart resolution lines such as carriers or regions outside China. For details, see Smart resolution and Custom resolution lines. Important Always set one record with the resolution line Default. This acts as a fallback to prevent resolution failures when no matching resolution line exists.	If you have no special requirements, keep Default. For requests from Beijing and nearby cities, select China_North. For requests from China Telecom, select China Telecom.
   TTL	The time that DNS resolvers cache the resolution result. We recommend setting TTL to 10 minutes. Smaller TTL values make changes take effect faster for end users. For more information, see How to configure TTL.	Edition Free Edition Personal Edition Enterprise Ultimate Edition & Premium Edition Minimum TTL value 600 seconds (10 minutes) 600 seconds (10 minutes) 1 second Maximum TTL value 86400 seconds (24 hours) 86400 seconds (24 hours) 86400 seconds (24 hours)
   Record Values Load Strategy	Round Robin: For A, AAAA, NS, MX, and TXT records, Alibaba Cloud DNS returns all records for the selected resolution line. The local DNS resolver selects the response. If the local DNS resolver returns all addresses, the end user selects randomly. Ratio: Returns the Record Values based on the configured weights. For configuration steps, see Configure weights.	Round Robin
   Record Values	Usually the public IPv4 address of the website server. You can add multiple addresses. When Record Values Load Strategy is set to Ratio, set the Ratio next to each record value. When responding to queries, Alibaba Cloud DNS returns record values based on the preset weight ratio.	If you use Alibaba Cloud ECS: View the public IP address in the Alibaba Cloud ECS console. If you use a non-Alibaba Cloud server: Contact your service provider to get the public IP address.

   Example

   

FAQ

• Does Alibaba Cloud DNS support port-based resolution?

• How do I configure DNS resolution for a domain name registered with a third-party registrar?

• A and AAAA records

A CNAME (Canonical Name) record points a domain name to another domain name. The other domain name then provides the IP address. Common use cases include CDN, enterprise email, and Global Traffic Manager.

Limits

• You have deployed an email server and obtained the domain name from your email service provider.

• If the hostname is not @, MX records conflict with NS or CNAME records when the hostname and resolution line are identical. If you receive a conflict error when adding an MX record, delete the conflicting record or change the hostname. For more information, see DNS record conflict rules.

How to set up

The following example shows the (mailbox) (record)s that you must configure for Alibaba Cloud Enterprise Mailbox:

1. On the Alibaba Cloud DNS – Public Zone page, click the target domain name to go to the Settings page.

2. Click the Add Record button.

3. Fill in the form fields.

   Form field	Description	Recommended value
   Record Type	Different record types require different record values.	Select MX from the drop-down list. MX stands for mail exchanger. Email systems use MX records to locate mail servers based on the domain part of an email address.
   Hostname	Usually the prefix of a subdomain.	If the domain name is www.example.com, enter www. If the domain name is example.com, enter @. If the domain name is demo.example.com, enter demo. If the domain name is test.blog.example.com, enter test.blog.
   Query Source	Specifies the source of DNS queries. Select Default unless you need to return different record values based on the user’s location. For example, use smart resolution lines such as carriers or regions outside China. For details, see Smart resolution and Custom resolution lines. Important Always set one record with the resolution line Default. This acts as a fallback to prevent resolution failures when no matching resolution line exists.	If you have no special requirements, keep Default. For requests from Beijing and nearby cities, select China_North. For requests from China Telecom, select China Telecom.
   TTL	The time that DNS resolvers cache the resolution result. We recommend setting TTL to 10 minutes. Smaller TTL values make changes take effect faster for end users. For more information, see How to configure TTL.	Edition Free Edition Personal Edition Enterprise Ultimate Edition & Premium Edition Minimum TTL value 600 seconds (10 minutes) 600 seconds (10 minutes) 1 second Maximum TTL value 86400 seconds (24 hours) 86400 seconds (24 hours) 86400 seconds (24 hours)
   Record Values Load Strategy	Only Round Robin is supported. For A, AAAA, NS, MX, and TXT records, Alibaba Cloud DNS returns all records for the selected resolution line. The local DNS resolver selects the response. If the local DNS resolver returns all addresses, the end user selects randomly.	Round Robin
   Record Values	Record Value: Obtain this from your email service provider. You can add multiple values. Example: For Alibaba Cloud Email, the required record value is mx1.qiye.aliyun.com. Priority: Lower priority numbers indicate higher priority. For example, email is first sent to 5 (mx1.qiye.aliyun.com). If that fails, email is sent to 10 (mx2.qiye.aliyun.com).	Example: aliyundoc.com 5. Important The above shows how to set up an MX record. To fully set up email, you also need CNAME and TXT records. Contact your email provider for the exact records you need. If you use Alibaba Cloud Email, see Add email resolution.

   Example

   

FAQ

MX records

Limits

• Obtain the IPv6 address of the target server in advance. Example: ff03:0:0:0:0:0:0:c1.

• If the hostname is not @, AAAA records conflict with NS, CNAME, ALIAS, or URL records when the hostname and resolution line are identical. If you receive a conflict error when adding an AAAA record, delete the conflicting record or change the hostname. For more information, see DNS record conflict rules.

How to set up

1. On the Alibaba Cloud DNS – Public Zone page, click the target domain name to go to the Settings page.

2. Click the Add Record button.

3. Fill in the form fields.

   Form field	Description	Recommended value
   Record Type	Different record types require different record values.	Select AAAA from the drop-down list to point the domain name to an IPv6 address, usually the IPv6 address of the website server, such as ff03:0:0:0:0:0:0:c1.
   Hostname	Usually the prefix of a subdomain.	If the domain name is www.example.com, enter www. If the domain name is example.com, enter @. If the domain name is demo.example.com, enter demo. If the domain name is test.blog.example.com, enter test.blog.
   Query Source	Specifies the source of DNS queries. Select Default unless you need to return different record values based on the user’s location. For example, use smart resolution lines such as carriers or regions outside China. For details, see Smart resolution and Custom resolution lines. Important Always set one record with the resolution line Default. This acts as a fallback to prevent resolution failures when no matching resolution line exists.	If you have no special requirements, keep Default. For requests from Beijing and nearby cities, select China_North. For requests from China Telecom, select China Telecom.
   TTL	The time that DNS resolvers cache the resolution result. We recommend setting TTL to 10 minutes. Smaller TTL values make changes take effect faster for end users. For more information, see How to configure TTL.	Edition Free Edition Personal Edition Enterprise Ultimate Edition & Premium Edition Minimum TTL value 600 seconds (10 minutes) 600 seconds (10 minutes) 1 second Maximum TTL value 86400 seconds (24 hours) 86400 seconds (24 hours) 86400 seconds (24 hours)
   Record Values Load Strategy	Round Robin: For A, AAAA, NS, MX, and TXT records, Alibaba Cloud DNS returns all records for the selected resolution line. The local DNS resolver selects the response. If the local DNS resolver returns all addresses, the end user selects randomly. Ratio: Returns the Record Values based on the configured weights. For configuration steps, see Configure weights.	Round Robin
   Record Values	Usually the IPv6 address of the website server. You can enter multiple addresses. When Record Values Load Strategy is set to Ratio, set the Ratio next to each record value. When responding to queries, Alibaba Cloud DNS returns record values based on the preset weight ratio.	Example: ff03:0:0:0:0:0:0:c1.

   Example

   

FAQ

A and AAAA records

Limits

• If the hostname is not @, TXT records conflict with NS or CNAME records when the hostname and resolution line are identical. If you receive a conflict error when adding a TXT record, delete the conflicting record or change the hostname. For more information, see DNS record conflict rules.

• The maximum length of a TXT record value is 8192 characters.

How to set up

1. On the Alibaba Cloud DNS – Public Zone page, click the target domain name to go to the Settings page.

2. Click the Add Record button.

3. Fill in the form fields.

   Form field	Description	Recommended value
   Record Type	The required record value varies based on the record type.	Select TXT from the drop-down list. TXT records are commonly used for tasks such as SSL certificate validation and creating Sender Policy Framework (SPF) records to prevent spam.
   Hostname	The prefix of the subdomain.	If the domain name is www.example.com, enter www. If the domain name is example.com, enter @. If the domain name is demo.example.com, enter demo. If the domain name is test.blog.example.com, enter test.blog.
   Query Source	Specifies the source of DNS queries. Select Default unless you need to return different record values based on the user’s location. For example, use smart resolution lines such as carriers or regions outside China. For details, see Smart resolution and Custom resolution lines. Important Always set one record with the resolution line Default. This acts as a fallback to prevent resolution failures when no matching resolution line exists.	If you have no special requirements, keep Default. For requests from Beijing and nearby cities, select China_North. For requests from China Telecom, select China Telecom.
   TTL	The time that DNS resolvers cache the resolution result. We recommend setting TTL to 10 minutes. Smaller TTL values make changes take effect faster for end users. For more information, see How to configure TTL.	Edition Free Edition Personal Edition Enterprise Ultimate Edition & Premium Edition Minimum TTL value 600 seconds (10 minutes) 600 seconds (10 minutes) 1 second Maximum TTL value 86400 seconds (24 hours) 86400 seconds (24 hours) 86400 seconds (24 hours)
   Record Values Load Strategy	Only Round Robin is supported. For A, AAAA, NS, MX, and TXT records, Alibaba Cloud DNS returns all records that match the selected resolution line. The local DNS resolver then determines which record to use. If the local DNS resolver returns all the record values, the end user's client randomly selects one.	Round Robin
   Record Values	TXT records are commonly used for verification. Obtain the required record value from your certificate service or email service provider. For example, you may need to add a TXT record to verify ownership of a subdomain. You can add multiple TXT records. Note During routine operations and maintenance (O&M), you should clean up unused TXT records. An excessive number of TXT records for a single subdomain can exceed response size limits, which may cause resolution failures on some carrier recursive DNS servers.	Example: 5d597b2c12464a7a8d0dde6b858ce543.

   Example

   

FAQ

TXT records

Limits

• The ALIAS record type is available only in the Ultimate Edition and Premium Edition.

• In the Ultimate Edition, you can configure up to 10 ALIAS records per domain name. In the Premium Edition, there is no limit* on the number of ALIAS records. For more information, see Edition comparison.

  *Unlimited: If you exceed the default system limit during actual use, you can request a parameter limit increase, provided the product remains stable and secure.

• If you downgrade from a paid edition to the Personal Edition or Free Edition, ALIAS records remain but become inactive. If you downgrade from the Premium Edition to the Ultimate Edition and have more than 10 ALIAS records, the records remain active, but you cannot modify them. To modify existing ALIAS records, delete excess records to reduce the total to 10 or fewer.

• The ALIAS record type conflicts with DNSSEC. To use ALIAS records, you must first disable DNSSEC for the domain name.

• ALIAS records conflict with A, AAAA, or CNAME records but not with other record types. For more information, see DNS record conflict rules.

• ALIAS records are supported only in public authoritative DNS resolution. Global Traffic Manager does not support ALIAS records.

Usage notes

• Because ALIAS records rely on public recursive DNS servers, network fluctuations or recursive server failures can cause resolution failures. Therefore, Alibaba Cloud does not guarantee SLA for ALIAS record resolution.

• When performing iterative resolution for ALIAS records, public authoritative DNS resolution uses the ECS field to pass the local DNS server’s source IP address to the recursive server. If the recursive server supports ECS, it can return smart resolution results.

• CDN providers may display an error saying “CNAME record not configured” after you set up an ALIAS record. Report this to the provider and ask them to update their validation logic.

• The TTL for ALIAS record responses is based on the TTL configured for the ALIAS record itself, not the TTL of the external recursive resolution result.

How to set up

1. On the Alibaba Cloud DNS – Public Zone page, click the target domain name to go to the Settings page.

2. Click the Add Record button.

3. Fill in the form fields.

   Form field	Description	Recommended value
   Record Type	Different record types require different record values.	Select ALIAS from the drop-down list. This record type points a domain name to another domain name. Alibaba Cloud DNS automatically performs recursive resolution and returns the final IP address.
   Hostname	Usually the prefix of a subdomain.	If the domain name is www.example.com, enter www. If the domain name is example.com, enter @. If the domain name is demo.example.com, enter demo. If the domain name is test.blog.example.com, enter test.blog.
   Query Source	Specifies the source of DNS queries. Select Default unless you need to return different record values based on the user’s location. For example, use smart resolution lines such as carriers or regions outside China. For details, see Smart resolution and Custom resolution lines. Important Always set one record with the resolution line Default. This acts as a fallback to prevent resolution failures when no matching resolution line exists.	If you have no special requirements, keep Default. For requests from Beijing and nearby cities, select China_North. For requests from China Telecom, select China Telecom.
   TTL	The time that DNS resolvers cache the resolution result. We recommend setting TTL to 10 minutes. Smaller TTL values make changes take effect faster for end users. For more information, see How to configure TTL.	Edition Free Edition Personal Edition Enterprise Ultimate Edition & Premium Edition Minimum TTL value 600 seconds (10 minutes) 600 seconds (10 minutes) 1 second Maximum TTL value 86400 seconds (24 hours) 86400 seconds (24 hours) 86400 seconds (24 hours)
   Record Values Load Strategy	Only Ratio is supported. For configuration steps, see Configure weights.	Ratio
   Record Values	The target domain name. You can add multiple domain names. When Record Values Load Strategy is set to Ratio, set the Ratio next to each record value. When responding to queries, Alibaba Cloud DNS returns record values based on the preset weight ratio.	Example: aliyundoc.com.

   Example

   

Prerequisites

URL forwarding works by resolving the domain name to an Alibaba Cloud forwarding server, which then handles the forwarding. Alibaba Cloud forwarding servers are deployed in the Chinese mainland. Therefore, the domain name must complete ICP filing (filing does not need to be done through Alibaba Cloud). To file with Alibaba Cloud, see ICP filing process.

Limits

• The record value cannot be an IP address.

• The domain name before forwarding cannot contain underscores (_).

• Wildcard resolution is not supported for URL forwarding.

• The target domain name for URL forwarding cannot be a Chinese domain name.

• The domain name before forwarding supports HTTP only, not HTTPS. The target URL supports both HTTP and HTTPS.

• If the hostname is not @, URL records conflict with NS, CNAME, A, or AAAA records when the hostname and resolution line are identical. If you receive a conflict error when adding a URL record, delete the conflicting record or change the hostname. For more information, see DNS record conflict rules.

• URL forwarding is a special feature. Alibaba Cloud DNS does not provide attack prevention. If your domain enters black hole mode because of attacks, URL forwarding will not work. In this case, configure the hostname as an A or CNAME record instead.

How to set up

1. On the Alibaba Cloud DNS – Public Zone page, click the target domain name to go to the Settings page.

2. Click the Add Record button.

3. Fill in the form fields.

   Form field	Description	Recommended value
   Record Type	Explicit URL Forwarding forwarding displays the target URL in the browser address bar and loads the target site’s content. Implicit URL Forwarding forwarding means that when you access a domain name configured with Implicit URL Forwarding forwarding, the domain name in the browser address bar remains unchanged, but the displayed website content originates from the target website.	Select Explicit URL Forwarding or Implicit URL Forwarding from the drop-down list.
   Hostname	The prefix of a subdomain.	If the domain name is www.example.com, enter www. If the domain name is example.com, enter @. If the domain name is demo.example.com, enter demo. If the domain name is test.blog.example.com, enter test.blog.
   Query Source	Specifies the source of DNS queries. Select Default unless you need to return different record values based on the user’s location. For example, use smart resolution lines such as carriers or regions outside China. For details, see Smart resolution and Custom resolution lines. Important Always set one record with the resolution line Default. This acts as a fallback to prevent resolution failures when no matching resolution line exists.	If you have no special requirements, keep Default. For requests from Beijing and nearby cities, select China_North. For requests from China Telecom, select China Telecom.
   TTL	The time that DNS resolvers cache the resolution result. We recommend setting TTL to 10 minutes. Smaller TTL values make changes take effect faster for end users. For more information, see How to configure TTL.	Edition Free Edition Personal Edition Enterprise Ultimate Edition & Premium Edition Minimum TTL value 600 seconds (10 minutes) 600 seconds (10 minutes) 1 second Maximum TTL value 86400 seconds (24 hours) 86400 seconds (24 hours) 86400 seconds (24 hours)
   Record Values Load Strategy	Only Round Robin is supported.	Round Robin
   Record Values	An existing website. Note For Explicit URL Forwarding: Supports 301 permanent redirects and 302 temporary redirects. A 301 status indicates that the resource at the old address A has been permanently moved. Search engines crawl the new content and replace the old URL with the redirected URL. A 302 status indicates that the resource at the old address A remains accessible. This redirect is temporary, moving from old address A to new address B. Search engines crawl the new content but retain the old URL.	Example: www.aliyun.com.

   Example

   Explicit URL Forwarding

   Implicit URL Forwarding

FAQ

URL forwarding

Limits

• Root domain delegation is not supported (the hostname cannot be set to @). To delegate the root domain to another DNS provider, update the DNS server addresses directly at your domain registrar. For more information, see Modify domain name DNS servers.

• If the hostname is not @, NS records conflict with other record types when the hostname and resolution line are identical. If you receive a conflict error when adding an NS record, delete the conflicting record or change the hostname. For more information, see DNS record conflict rules.

How to set up

1. Add the subdomain to Alibaba Cloud DNS and obtain the DNS server addresses assigned to the subdomain. For steps, see Subdomain management.

2. Go to the authoritative DNS server for the root domain and modify the subdomain’s DNS records. For example, using Alibaba Cloud public authoritative DNS: Go to the Alibaba Cloud DNS – Public Zone page, click the target domain name to go to the Settings page.

3. Click the Add Record button.

4. Fill in the form fields.

   Form field	Description	Recommended value
   Record Type	To delegate subdomain resolution to another DNS provider, add an NS record.	Select NS from the drop-down list.
   Hostname	Usually the prefix of a subdomain.	If the domain name is www.example.com, enter www. If the domain name is example.com, enter @. If the domain name is demo.example.com, enter demo. If the domain name is test.blog.example.com, enter test.blog.
   Query Source	Specifies the source of DNS queries. Select Default unless you need to return different record values based on the user’s location. For example, use smart resolution lines such as carriers or regions outside China. For details, see Smart resolution and Custom resolution lines. Important Always set one record with the resolution line Default. This acts as a fallback to prevent resolution failures when no matching resolution line exists.	If you have no special requirements, keep Default. For requests from Beijing and nearby cities, select China_North. For requests from China Telecom, select China Telecom.
   TTL	The time that DNS resolvers cache the resolution result. We recommend setting TTL to 10 minutes. Smaller TTL values make changes take effect faster for end users. For more information, see How to configure TTL.	Edition Free Edition Personal Edition Enterprise Ultimate Edition & Premium Edition Minimum TTL value 600 seconds (10 minutes) 600 seconds (10 minutes) 1 second Maximum TTL value 86400 seconds (24 hours) 86400 seconds (24 hours) 86400 seconds (24 hours)
   Record Values Load Strategy	Only Round Robin is supported. For A, AAAA, NS, MX, and TXT records, Alibaba Cloud DNS returns all records for the selected resolution line. The local DNS resolver selects the response. If the local DNS resolver returns all addresses, the end user selects randomly.	Round Robin
   Record Values	The record value is the domain name of the DNS server you want to authorize. Note Other DNS providers usually provide multiple DNS server addresses. Configure multiple NS records with the same hostname but different record values.	Example: Tencent Cloud DNS server domain name ns3.dnspod.net.

   Example

Limits

• If the hostname is not @, SRV records conflict with NS or CNAME records when the hostname and resolution line are identical. If you receive a conflict error when adding an SRV record, delete the conflicting record or change the hostname. For more information, see DNS record conflict rules.

How to set up

1. On the Alibaba Cloud DNS – Public Zone page, click the target domain name to go to the Settings page.

2. Click the Add Record button.

3. Fill in the form fields.

   Form field	Description	Recommended value
   Record Type	An SRV record identifies which server provides a specific service. It also provides the service’s address, port, priority, and weight.	Select SRV from the drop-down list. This option points the domain name to another domain name, which then provides the IP address.
   Hostname	The hostname format for an SRV record is usually “service name.protocol type”.	Example: _sip._tcp
   Query Source	Specifies the source of DNS queries. Select Default unless you need to return different record values based on the user’s location. For example, use smart resolution lines such as carriers or regions outside China. For details, see Smart resolution and Custom resolution lines. Important Always set one record with the resolution line Default. This acts as a fallback to prevent resolution failures when no matching resolution line exists.	If you have no special requirements, keep Default. For requests from Beijing and nearby cities, select China_North. For requests from China Telecom, select China Telecom.
   TTL	The time that DNS resolvers cache the resolution result. We recommend setting TTL to 10 minutes. Smaller TTL values make changes take effect faster for end users. For more information, see How to configure TTL.	Edition Free Edition Personal Edition Enterprise Ultimate Edition & Premium Edition Minimum TTL value 600 seconds (10 minutes) 600 seconds (10 minutes) 1 second Maximum TTL value 86400 seconds (24 hours) 86400 seconds (24 hours) 86400 seconds (24 hours)
   Record Values Load Strategy	Only Round Robin is supported.	Round Robin
   Record Values	Format: Priority Weight Port Target domain	Example: 0 5 5060 www.cloud-example.com.

   Example

Limits

• If the hostname is not @, CAA records conflict with NS or CNAME records when the hostname and resolution line are identical. If you receive a conflict error when adding a CAA record, delete the conflicting record or change the hostname. For more information, see DNS record conflict rules.

How to set up

1. On the Alibaba Cloud DNS – Public Zone page, click the target domain name to go to the Settings page.

2. Click the Add Record button.

3. Fill in the form fields.

   Form field	Description	Recommended value
   Record Type	CAA records let domain owners specify which certificate authorities (CAs) may issue SSL/TLS certificates for their domain. This prevents unauthorized third parties from obtaining certificates for the domain from other CAs, avoids incorrect certificate issuance, and improves website security.	Select CAA from the drop-down list.
   Hostname	Usually the prefix of a subdomain.	If the domain name is www.example.com, enter www. If the domain name is example.com, enter @. If the domain name is demo.example.com, enter demo. If the domain name is test.blog.example.com, enter test.blog.
   Query Source	Specifies the source of DNS queries. Select Default unless you need to return different record values based on the user’s location. For example, use smart resolution lines such as carriers or regions outside China. For details, see Smart resolution and Custom resolution lines. Important Always set one record with the resolution line Default. This acts as a fallback to prevent resolution failures when no matching resolution line exists.	If you have no special requirements, keep Default. For requests from Beijing and nearby cities, select China_North. For requests from China Telecom, select China Telecom.
   TTL	The time that DNS resolvers cache the resolution result. We recommend setting TTL to 10 minutes. Smaller TTL values make changes take effect faster for end users. For more information, see How to configure TTL.	Edition Free Edition Personal Edition Enterprise Ultimate Edition & Premium Edition Minimum TTL value 600 seconds (10 minutes) 600 seconds (10 minutes) 1 second Maximum TTL value 86400 seconds (24 hours) 86400 seconds (24 hours) 86400 seconds (24 hours)
   Record Values Load Strategy	Only Round Robin is supported.	Round Robin
   Record Values	flag: Default is 0. If a CA does not recognize this record, it ignores it. tag: Supports three values: issue, issuewild, and iodef. issue: Authorizes a single CA to issue any type of certificate for the domain. issuewild: Authorizes a single CA to issue wildcard certificates for the domain. iodef: Sends violation reports to an email address. value: Enter the CA’s domain name or an email address for violation notifications. Example: "ca.cloud-example.com". (Include double quotes.)	Example: 0 issue "ca.cloud-example.com"

   Example

Limits

If the hostname is not @, SVCB records conflict with NS or CNAME records when the hostname and resolution line are identical. SVCB records also conflict between alias mode and service mode. If you receive a conflict error when adding an SVCB record, delete the conflicting record or change the hostname. For more information, see DNS record conflict rules.

How to set up

1. On the Alibaba Cloud DNS – Public Zone page, click the target domain name to go to the Settings page.

2. Click the Add Record button.

3. Fill in the form fields.

   Form field	Description	Recommended value
   Record Type	An SVCB record is a service binding record. It discloses supported protocols and Service Parameters for service discovery.	Select SVCB from the drop-down list.
   Hostname	Usually the prefix of a subdomain.	If the domain name is www.example.com, enter www. If the domain name is example.com, enter @. If the domain name is demo.example.com, enter demo. If the domain name is test.blog.example.com, enter test.blog.
   Query Source	Specifies the source of DNS queries. Select Default unless you need to return different record values based on the user’s location. For example, use smart resolution lines such as carriers or regions outside China. For details, see Smart resolution and Custom resolution lines. Important Always set one record with the resolution line Default. This acts as a fallback to prevent resolution failures when no matching resolution line exists.	If you have no special requirements, keep Default. For requests from Beijing and nearby cities, select China_North. For requests from China Telecom, select China Telecom.
   TTL	The time that DNS resolvers cache the resolution result. We recommend setting TTL to 10 minutes. Smaller TTL values make changes take effect faster for end users. For more information, see How to configure TTL.	Edition Free Edition Personal Edition Enterprise Ultimate Edition & Premium Edition Minimum TTL value 600 seconds (10 minutes) 600 seconds (10 minutes) 1 second Maximum TTL value 86400 seconds (24 hours) 86400 seconds (24 hours) 86400 seconds (24 hours)
   Record Values	Priority: A non-negative integer (0–65535) that specifies which SVCB record to try first. Lower numbers indicate higher priority. If a service has multiple SVCB records, clients sort them by priority and start with the highest priority (lowest number). Similar to the priority parameter in MX records for email. Note Priority 0: Alias mode. Do not set Service Parameters. Similar to a CNAME record, it points to another service name. Non-zero priority: Service mode. Define service parameters. Destination Zone Name: The domain name of the server the client should connect to. In alias mode (priority 0), the target domain is another service name the client should resolve. In service mode, the target domain is usually the hostname of the actual service. The client resolves this domain to obtain the service’s IP address. Example: www.example.com. Service Parameters: Key-value pairs that define service configuration and required features. These include protocol versions, application-layer protocol lists (such as ALPN), transport layer security requirements (such as TLS version), transport parameters, and IP address hints. Service Parameters give service providers a way to guide clients and provide pre-connection information to optimize performance and security. Example: alpn="h2" ipv4hint="223.5.5.5" port="443" ech="MTIzNDU2Nzg=" Note Common Service Parameters: alpn="h3,h2": Supports HTTP/2 and HTTP/3. ipv4hint="223.5.XX.XX": IPv4 address hint for the target domain. ipv6hint="2400:3200::XX": IPv6 address hint for the target domain. port="443": Port number. ech="MTIzNDU2Nzg=": Base64-encoded ECH configuration string. mandatory="alpn,port": List of required parameters. no-default-alpn: No default application-layer protocol. If present, alpn must be specified. dohpath="/dns-query{?dns}": URI template for DNS over HTTPS (DoH) access. Separate key-value pairs with spaces. Maximum length is 1024 characters.

   Example

An HTTPS record is a specialized SVCB record designed specifically for HTTPS services. HTTPS records support the same key-value parameters as SVCB records, but they are interpreted and processed assuming the service protocol is HTTPS.

HTTPS records let website operators provide more detailed information about their HTTPS service, including available IP addresses and supported protocols or service parameters. This ensures clients use the best configuration on first connection, reducing handshake latency, lowering connection failure rates, and enhancing user privacy.

Limits

If the hostname is not @, HTTPS records conflict with NS or CNAME records when the hostname and resolution line are identical. HTTPS records also conflict between alias mode and service mode. If you receive a conflict error when adding an HTTPS record, delete the conflicting record or change the hostname.

How to set up

1. On the Alibaba Cloud DNS – Public Zone page, click the target domain name to go to the Settings page.

2. Click the Add Record button.

3. Fill in the form fields.

   Form field	Description	Recommended value
   Record Type	An HTTPS record is a specialized DNS record for HTTPS services. It enables clients to negotiate secure HTTPS connection protocols and select optimal service endpoints, improving the security and reliability of HTTPS access.	Select HTTPS from the drop-down list.
   Hostname	Usually the prefix of a subdomain.	If the domain name is www.example.com, enter www. If the domain name is example.com, enter @. If the domain name is demo.example.com, enter demo. If the domain name is test.blog.example.com, enter test.blog.
   Query Source	Specifies the source of DNS queries. Select Default unless you need to return different record values based on the user’s location. For example, use smart resolution lines such as carriers or regions outside China. For details, see Smart resolution and Custom resolution lines. Important Always set one record with the resolution line Default. This acts as a fallback to prevent resolution failures when no matching resolution line exists.	If you have no special requirements, keep Default. For requests from Beijing and nearby cities, select China_North. For requests from China Telecom, select China Telecom.
   Record Values	Priority: A non-negative integer (0–65535) that specifies which HTTPS record to try first. Lower numbers indicate higher priority. If a service has multiple HTTPS records, clients sort them by priority and start with the highest priority (lowest number). This works similarly to the priority parameter in MX records for email. Note Priority 0: Alias mode. Do not define service parameters. Like a CNAME record, it points to another service name. Non-zero priority: Service mode. Define service parameters. Destination Zone Name: The domain name of the server the client should connect to. In alias mode (priority 0), the target domain is another service name the client should resolve. In service mode, the target domain is usually the hostname of the actual service. The client resolves this domain to obtain the service’s IP address. Example: www.example.com. Service Parameters: Key-value pairs that define service configuration and required features. These include protocol versions, application-layer protocol lists (such as ALPN), transport layer security requirements (such as TLS version), transport parameters, and IP address hints. Service Parameters give service providers a way to guide clients and provide pre-connection information to optimize performance and security. Example: alpn="h2,h3" ipv4hint="223.5.XX.XX" ipv6hint="2400:3200::XX" port="443" Note Examples: alpn="h3,h2": Supports HTTP/2 and HTTP/3. ipv4hint="223.5.XX.XX": IPv4 address hint for the target domain. ipv6hint="2400:3200::XX": IPv6 address hint for the target domain. port="443": Port number. mandatory="alpn,port": List of required parameters. no-default-alpn: No default application-layer protocol. If present, alpn must be specified. dohpath="/dns-query{?dns}": URI template for DNS over HTTPS (DoH) access. Separate key-value pairs with spaces. Maximum length is 1024 characters.	Example: aliyundoc.com.
   TTL	The time that DNS resolvers cache the resolution result. We recommend setting TTL to 10 minutes. Smaller TTL values make changes take effect faster for end users. For more information, see How to configure TTL.	Edition Free Edition Personal Edition Enterprise Ultimate Edition & Premium Edition Minimum TTL value 600 seconds (10 minutes) 600 seconds (10 minutes) 1 second Maximum TTL value 86400 seconds (24 hours) 86400 seconds (24 hours) 86400 seconds (24 hours)

   Example