文档目录

手动解析 TXT 指引

手动验证时 TXT 记录怎么填:主机记录、完整名称、记录类型、记录值四个字段的含义,常见 DNS 服务商的填写位置与生效等待时间。

选择「手动解析」后,平台会生成一条 TXT 验证记录,需要你到域名所在 DNS 服务商的控制台手工添加。这一篇把每个字段怎么填讲清楚。

页面上的四行信息

申请页第二步会给出一张逐行可复制的记录卡片:

字段含义怎么填
主机记录DNS 控制台里「主机记录 / Host / 名称」栏要填的部分照抄页面给的主机记录(通常是 _acme-challenge 或 _acme-challenge.子域前缀)
完整名称这条解析的完整域名不确定主机记录怎么填时,把服务商切换成「完整名称」模式整条照抄
记录类型固定为 TXT下拉选择 TXT
记录值一串证明域名归属的随机字符整条复制粘贴,不要手工敲、不要漏字符
最稳妥的抄法

优先「主机记录 + 记录值」分开抄;如果你的服务商(如部分 Cloudflare 界面)只让填完整名称,就直接整条照抄完整名称那一行。

主机记录的层级问题

主机记录填什么,取决于你在 DNS 控制台里管理的是哪一级域名:

  • 给 example.com 签发:主机记录填 _acme-challenge,服务商域名选 example.com。
  • 给 api.example.com 签发:主机记录填 _acme-challenge.api,服务商域名选 example.com。
  • 拿不准就直接用「完整名称」整条照抄,两种填法效果一致。

常见服务商的填写位置

服务商位置注意
阿里云(万网)域名解析 → 添加记录,记录类型选 TXT主机记录框直接填页面给的值
腾讯云 DNSPod域名解析 → 添加记录主机记录留空代表 @,这里必须填 _acme-challenge 前缀
CloudflareDNS → Records → Add record代理状态保持「仅 DNS」(灰云),TXT 记录本身不受代理影响
华为云 / 其他解析设置 → 添加 TXT 记录逻辑一致:名称 + 类型 TXT + 值

等多久能校验

  • DNS 记录的生效时间由服务商 TTL 决定,一般几分钟,最长可能到十几分钟。
  • 平台校验会沿着公共递归解析链查询,本地刚保存不代表全网可见,「保存成功」后稍等片刻再点校验。
  • 点校验如果提示「校验暂未开始」(申请还留着),等解析同步到位后回到这一步再校验一次即可,不必整单重来。
这些情况校验一定不过
  • 记录值漏字符或多空格 —— 删掉重加,整条复制。
  • 加在了错误的一级域名下(比如把 api 前缀漏了)—— 对照「完整名称」核对。
  • 域名开了 CDN/代理导致解析链被改写 —— TXT 记录本身不受影响,但确认没有同名冲突记录。

嫌手动麻烦?

到 域名托管 给域名配置一次 CNAME 委托,之后的每次申请都由系统自动写入解析记录,手动解析只在首次配置时用一次。