DNSPod 二级域名解析模块使用说明
一、模块简介
本模块适用于 魔方业务系统V10,可将一个 DNSPod 父域名拆分为多个独立子域空间进行售卖。
用户购买产品后,可自行注册一个专属子域名前缀,例如注册“a”,即可获得 a.example.com,并在该子域空间内管理 DNS 解析记录。
支持的解析类型:
A、AAAA、CNAME、TXT、SRV
每个产品最多支持三级子域,例如:
a.example.com
www.a.example.com
a.b.c.example.com
同时支持临时 TXT 记录,可用于证书验证等场景,添加后 1 小时自动清理。
二、后台配置
添加 DNSPod 服务器
进入后台“服务器”→“添加服务器”,类型选择“DNSPod 二级域名解析”。
用户名填写腾讯云 SecretId。
密码填写腾讯云 SecretKey。
主机名填写需要出售的父域名,例如 example.com。
IP 地址填写 DNSPod API 接入点。
国内站默认使用:
dnspod.tencentcloudapi.com
国际站使用:
dnspod.intl.tencentcloudapi.com
IP 地址也可以填写自定义 API 接入点。
测试连接
服务器配置完成后,可使用“测试连接”检查 SecretId、SecretKey、父域名、API 接入点以及网络连接是否正常。
创建商品
创建商品时选择“DNSPod 二级域名解析”模块,并关联已经配置好的 DNSPod 服务器。
可配置:
TTL:默认 600 秒。
记录数上限:限制单个产品可以创建的解析记录数量,留空表示不限。
父域名需要提前在 DNSPod 控制台添加并完成解析配置。
三、用户使用
注册子域名
用户购买并开通产品后,进入:
产品详情 → 解析记录
首次使用时需要注册子域名前缀。
例如输入:
a
系统会自动生成:
a.example.com
前缀支持小写字母、数字和连字符,长度不超过 63 个字符,且首尾不能使用连字符。
注册时系统会同时检查本地产品数据和 DNSPod 中的实际记录,确保该前缀没有被占用。
添加解析记录
进入解析记录页面后,可以添加 DNS 解析。
主机记录填写规则:
@ 或留空:解析到当前子域名本身。
www:生成 www.a.example.com。
b.c:生成 a.b.c.example.com。
支持的记录类型:
A:IPv4 地址
AAAA:IPv6 地址
CNAME:域名
TXT:文本内容
SRV:服务记录
临时 TXT
临时 TXT 主要用于证书验证、SPF 校验等一次性场景。
临时 TXT 不占用普通记录数量限制,创建后最多保留 1 小时,系统会自动清理。
四、产品生命周期
产品开通后不会自动分配子域名前缀,需要用户进入解析记录页面自行注册。
产品暂停时,当前子域下的解析记录会全部暂停。
产品恢复时,原有解析记录会恢复启用。
产品删除时,当前子域下的解析记录会被删除。
产品续费不会对 DNSPod 执行额外操作。
临时 TXT 记录由系统定时任务自动清理。
五、注意事项
DNSPod 父域名必须提前添加并配置完成。
SecretId 和 SecretKey 必须正确,并与所使用的国内站或国际站接入点匹配。
不要在已经出售的子域名前缀下手动添加 DNS 记录,否则可能导致用户无法注册该前缀。
免费 DNSPod 套餐可能存在记录数量、线路或 TTL 限制。
DNSPod 新增记录可能存在约 30 秒的索引延迟,刚添加记录后如暂时看不到,请稍后刷新。
到期自动删除功能依赖系统 cron 定时任务,需要开启 cron_due_terminate_*。
临时 TXT 自动清理依赖 FiveMinuteCron 正常运行。
系统会对 SecretId、SecretKey 等敏感信息进行保护,不会直接显示在错误提示或日志中。
用户只能操作属于自己子域名前缀的 DNS 记录,无法操作其他用户的记录。
六、常见问题
测试连接失败:
请检查 SecretId、SecretKey、父域名及 API 接入点配置。
提示父域名不存在:
请先在 DNSPod 控制台添加对应父域名。
提示前缀已被使用:
说明该前缀已经被其他产品注册,或 DNSPod 中已经存在对应记录,请更换前缀。
添加记录提示 LimitExceeded:
可能是 DNSPod 当前套餐存在记录数量或 TTL 限制。
新增记录暂时看不到:
DNSPod 可能存在约 30 秒的索引延迟,请稍后刷新。
到期后记录没有删除:
请检查系统的 cron_due_terminate_* 到期删除任务是否开启。