All Products
Search

This Product

    HTTPDNS:Add domain names

    Document Center

    HTTPDNS:Add domain names

    Last Updated:Dec 08, 2025

    This document describes how to add and manage domain names for resolution in the HTTPDNS console.

    Add a domain name

    1. Log on to the EMAS console.

    2. In the navigation pane on the left, choose HTTPDNS > Resolution Management > Add Domain Names.

    3. Click Add Domain Name. Enter a valid specific domain name or wildcard domain name, and then click OK.

      Examples:

      1. Specific domain name: for example, www.aliyun.com and a.aliyun.com.

      2. Wildcard domain name: for example, *.aliyun.com. This matches subdomains such as a.aliyun.com, b.aliyun.com, and a.b.aliyun.com.

      3. Wildcard domain names for top-level domains (TLDs), such as *.com, *.cn, and *.net, are not supported.

    Note

    • Domain name additions and deletions take effect in about one minute.

    • Each account can have a maximum of 200 domain name rules.

    Any domain name resolution and blacklist for DoH

    The DNS over HTTPS (DoH) standard does not include an authentication mechanism. In practice, DoH is often applied to an entire system, which makes it difficult to list every domain name. A whitelist alone cannot meet all security and availability requirements. Therefore, to prevent risks such as fraudulent usage and support more resolution scenarios, HTTPDNS provides a Resolve all domain names: Yes option. It also includes a blacklist for fine-grained control.

    When you use DoH for resolution, domain name resolution requests are matched and controlled in the following order:

    • Requests are first matched against the domain name list (whitelist) and then against the blacklist.

    • If Resolve all domain names is set to No, only domain names in the domain name list are resolved.

    • If Resolve all domain names is set to Yes, the domain name list is ignored and all domain names are resolved.

    • The blacklist has a higher priority than the domain name list. If a domain name exists in both the domain name list and the blacklist, the blacklist rule applies, and resolution is denied.

    Important

    • Some network libraries or frameworks probe DoH availability using specific domain names. If you allow resolution for only certain domain names, you must add the probe domain names to the resolution whitelist. Otherwise, DoH may not work correctly.

      • Qt WebEngine and Electron use www.gstatic.com.

      • The Chromium Embedded Framework (CEF) and Chrome browser use google.com.

    Delete a domain name

    In the domain name list, click Delete next to the domain name that you want to remove. Confirm the deletion to remove the domain name rule.

    Note

    • After a domain name rule is deleted, HTTPDNS no longer resolves domain names that match that rule.

    • You can restore a deleted domain name only by adding it again.

    View domain name data

    In the domain name list, click View next to a domain name to see its resolution data.

    Note

    Domain name resolution data is available on the following day (T+1).