Zones and records
Create a DNS zone, delegate nameservers and pass the NS check, then add, bulk-import and export records.
This page covers putting a domain on Yeap Cloud DNS: creating the zone, changing the nameservers at your registrar, confirming delegation, and adding and managing records.
Create a zone
- Go to DNS管理 → 区域管理 (DNS Management → Zones) and click 创建区域 (Create zone) at the top right.
- Step 1, 输入域名 (Enter domain): in 区域名称 (Zone name), enter the apex domain, for example
example.com. Internationalized domain names such as中国.comwork too. They are stored in Punycode, and the list still shows the original name. 描述 (Description) is optional. - Step 2, 选择套餐 (Choose plan): pick a DNS plan for this zone. A free plan activates right away. With a paid plan, you'll be asked to pay after the zone is created, and the zone activates once the invoice is paid.
- Step 3, 完成配置 (Finish): the page shows the Nameserver 列表 (Nameserver list), which are the nameservers assigned to this zone. Click 复制 (Copy) next to each one and keep them.
A domain can exist as only one zone on the platform, and each plan subscription can be linked to only one zone. If you see "Zone already exists", the domain has already been added.
When the zone is created, the system adds its SOA record and the root (@) NS records. These are system records. You can't edit or delete them, and they count toward the record quota.
Change nameservers (delegation)
In your registrar's control panel, set the domain's nameservers to the ones shown in step 3. Copy them exactly as the console shows them, and don't make up your own.
- Enter all of the assigned nameservers and remove any others. Otherwise some queries will still go to your old provider.
- You can look up and copy these nameservers at any time. They're on the 名称服务器 (NS) card at the top of the zone's records page.
- Nameserver changes usually take anywhere from a few minutes to a few hours to spread worldwide. The time depends on the registry and on how long the old NS records were cached.
Once a zone is active, it's published to its assigned nameservers. You don't have to wait for the NS switch. For a migration with no downtime, first recreate all of your existing records in the console. Then check the answers with dig @<assigned-nameserver> www.example.com. Change the nameservers at your registrar only after that.
NS check and zone status
The 状态 (Status) column in the zone list shows each zone's status:
| Status | Meaning |
|---|---|
| 活跃 (Active) | The plan is valid and the zone is published to the nameservers |
| 待激活 (Pending) | The paid plan isn't paid yet, so the zone isn't published |
| 已暂停 / 未激活 / 已终止 (Suspended / Inactive / Terminated) | The zone is suspended or its plan has lapsed, and it no longer answers queries. Contact support if you're not sure why |
If a zone is Active but the domain's NS records don't point to us yet, it also shows a 待接入 (Awaiting delegation) tag under the status.
How the check works: the platform looks up the domain's current NS records through public DNS. If at least one of them matches a nameserver assigned to the zone, the domain counts as delegated and the 待接入 tag goes away.
- Zones waiting for delegation are checked automatically in the background, in batches about every 10 minutes.
- To check right away, click the 检查NS是否已切换到我们的服务器 (Check whether NS points to us) icon on the zone's row. If the domain isn't delegated yet, a dialog shows 当前NS (the current NS found on the public internet) next to 应该指向 (the assigned nameservers you should use). You can copy the values from there.
待接入 is only a reminder. Even before the NS switch, the zone already answers queries on our nameservers.
Add and manage records
In the zone list, click the 管理记录 (Manage records) icon to open the records page, then click 添加记录 (Add record). Each record has these fields:
| Field | Description |
|---|---|
| 名称 (Name) | The host, relative to the zone. @ is the apex, www means www.example.com, and * is a wildcard. Letters, digits, hyphens and underscores (as in _dmarc) are allowed. Spaces are not |
| 类型 (Type) | See the table below |
| 内容 (Content) | The record value |
| TTL | Cache time in seconds. New records default to 3600. Allowed range is 1–604800 (7 days). Larger values are lowered to 604800 |
| 优先级 (Priority) | Priority for MX and SRV. For A/AAAA/CNAME it acts as a weight. See Geo routing |
| 备注 (Comment) | An optional note |
| 调度线路 (Routing line) | A, AAAA and CNAME only. See Geo routing |
Supported record types
| Type | What to enter in Content | Example |
|---|---|---|
| A | An IPv4 address | 203.0.113.10 |
| AAAA | An IPv6 address | 2001:db8::10 |
| CNAME | The target hostname | app.example.net |
| MX | The mail server hostname. Put the preference in the Priority field | Content mx1.example.com, priority 10 |
| TXT | Any text, up to 4096 characters. Quotes are added for you, and text over 255 bytes is split into several strings automatically | v=spf1 include:_spf.example.com ~all |
| NS | A nameserver hostname, used to delegate a subdomain to another DNS provider | Name dev, content ns1.other-dns.com |
| SRV | weight port target. Put the priority in the Priority field | Name _sip._tcp, content 5 5060 sip.example.com, priority 10 |
| CAA | flags tag value, where tag is issue, issuewild or iodef | 0 issue "letsencrypt.org" |
| PTR | A hostname | host.example.com |
For content that is a hostname (CNAME, MX, NS, PTR, and the SRV target), you can include or leave off the trailing dot. The system treats it as a fully qualified name either way.
Validation rules
- A CNAME can't share a name with any other record. For example, if
wwwalready has an A record, you can't add a CNAME forwww, and the reverse is also true. The apex (@) always has NS and SOA records, so the apex can't be a CNAME. - The apex SOA and NS records are managed by the system. The console marks them "系统记录，不可修改" (system record, can't be changed).
- If the content is malformed, the save is rejected with an error. Examples are an invalid IP in an A record, or SRV content that isn't in
weight port targetform.
Bulk import
On the records page, click 更多操作 → 批量导入 (More → Bulk import):
Enter one record per line in the text box, or click 从文件导入 (Import from file) to load a text or CSV file. Use this format:
textname|type|TTL|priority|content|geo|commentFor example:
textwww|A|3600|0|203.0.113.10||Web server mail|MX|3600|10|mail.example.com||Mail serverComma-separated CSV works too. Name, type and content are required. A blank TTL defaults to 3600 and a blank priority defaults to 0. The geo field is for advanced use and is normally left blank.
Click 预览导入数据 (Preview) to check how the lines were parsed, then click 导入 (Import).
When the import finishes, you'll see how many records succeeded and how many failed. Each record is validated on its own, so a failure on one line (bad format, CNAME conflict, quota exceeded) doesn't stop the others.
Download the zone file
Click 更多操作 → 下载 Zone 文件 (More → Download zone file) to download the zone's current configuration as a text file (<zone>.zone). This is handy for backups and for checking your records.
In the downloaded file, A, AAAA and CNAME lines carry extra fields that the platform uses for geo routing. The file is not standard BIND format. Remove those fields before importing the file at another DNS provider.
Edit or delete a zone
- 编辑区域 (Edit zone): you can change the zone's description. The zone name can't be changed.
- 删除区域 (Delete zone): click it and confirm. After deletion, the platform's nameservers stop answering for the domain, and the domain stops resolving.
If the domain is still in use, first change its nameservers at your registrar to your new DNS provider and wait for the change to take effect. Delete the zone only after that. If the zone has DNSSEC turned on, remove the DS record first, as described in DNSSEC.