跳到主要内容
ssl证书按装

SSL 证书域名验证实战:DNS TXT 与文件验证全流程排错指南

SSL 证书域名验证实战:DNS TXT 与文件验证全流程排错指南 — SSL 证书域名验证实战:DNS TXT 与文件验证全流程排错指南

问题背景与根因:域名验证为什么总卡住

SSL/TLS 证书签发前,CA 必须确认申请者对域名拥有控制权,这就是域名验证(Domain Validation)。DV 证书只校验域名控制权,OV/EV 还要校验组织身份。自 2020 年 9 月起,公开信任证书单张有效期上限为 398 天;CA/B Forum SC-081 进一步规定 2026-03-15 起降至 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天。Let’s Encrypt 当前证书有效期仍为 90 天。生命周期缩短后,验证和续期必须自动化,否则很容易因一条 TXT 记录或一个 403 中断业务。

常见验证方式有 DNS-01(TXT 记录)、HTTP-01(/.well-known/acme-challenge/ 文件)、CA 自定义文件验证(如根目录 fileauth.txt)和邮件验证。根因通常不是“CA 慢”,而是:DNS 记录名写错、TXT 值被截断、TTL 与负缓存未过期、CAA 记录未放行、DNSSEC 配置错误、CDN/WAF 拦截验证路径、HTTP 被 301 到尚未签发证书的 HTTPS、网站根目录权限或 SELinux 限制、IPv6 AAAA 记录指向错误源站、通配符证书误用文件验证、以及触发 CA 速率限制。排查时应先确认验证方式,再用 dig、curl 从公网视角复现 CA 的请求。

实操前先记录关键参数:openssl x509 -in cert.pem -noout -subject -issuer -dates 可查看当前证书主体、签发者和有效期;dig +short A example.com、dig +short AAAA example.com 确认解析;dig +short CAA example.com 检查 CAA。若使用商业 CA 的文件验证,确认文件必须放在域名对应站点根目录,且内容完全一致,不能多空格或换行。

证书类型与验证方式选型:DV、OV、EV 与 DNS/文件验证

选型先看业务:个人站点、API、内部测试优先 DV,签发快、成本低;电商、金融、政企对外门户可选 OV/EV,需提交营业执照、组织信息,验证周期更长。品牌方面,Let’s Encrypt 适合自动化,90 天有效期,配合 certbot/acme.sh 续期;商业 CA 的 DV/OV/EV 提供不同有效期和保障,但同样受 398 天及后续 200/100/47 天上限约束。不要把“证书品牌”与“验证方式”混为一谈:同一张 DV 证书既可用 DNS 验证,也可用文件验证。

验证方式选择:需要通配符 *.example.com 时只能用 DNS-01;源站不开放 80/443、或站点在 CDN 后面且回源复杂时,优先 DNS-01;能稳定提供 HTTP 服务、且希望少碰 DNS 权限时,用 HTTP-01 或 CA 文件验证。DNS-01 需要域名解析控制台或 API 权限,记录名为 _acme-challenge.example.com,类型 TXT;HTTP-01 需要 http://example.com/.well-known/acme-challenge/<token> 返回 200 和纯文本 token;商业 CA 文件验证常见要求根目录 fileauth.txt。邮件验证逐渐被淘汰,不建议作为主方案。

快速判断当前证书类型与链:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null,再执行 openssl x509 -noout -subject -issuer -dates。若证书 subject 含 O= 组织字段,通常为 OV/EV;DV 一般只有 CN/SAN。续期策略上,Let’s Encrypt 建议在到期前 30 天续期,商业证书至少提前 30 天,自动化任务要加 --dry-run 验证。

完整实操:DNS TXT 验证(含 dig 与 acme.sh/certbot 命令)

第一步,从 CA 控制台或 ACME 客户端获取记录。以 Let’s Encrypt 为例,单域名和通配符的记录名通常都是 _acme-challenge.example.com,值为一段 Base64URL 字符串。先查现状:dig +short TXT _acme-challenge.example.com @8.8.8.8;若返回空,继续查权威 NS:dig +short NS example.com,再 dig +short TXT _acme-challenge.example.com @ns1.example.net。注意 TXT 值可能被拆成多个引号片段,CA 会拼接,但不要手动加引号或换行。

在 DNS 控制台添加 TXT,TTL 设为 60 或最低值。若已有其他 TXT(SPF、DMARC、Google 验证),不要删除,TXT 允许多条并存。添加后用多个解析器验证:dig +short TXT _acme-challenge.example.com @1.1.1.1、@223.5.5.5、@8.8.8.8。若使用阿里云 DNS 自动签发:export Ali_Key='xxx'; export Ali_Secret='yyy'; acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'。certbot 手动模式:certbot certonly --manual --preferred-challenges dns -d example.com -d '*.example.com',按提示添加两条 TXT 后回车。

同时检查 CAA:dig +short CAA example.com。若存在 CAA,必须包含签发 CA,例如 0 issue 'letsencrypt.org';通配符还需 0 issuewild 'letsencrypt.org'。若返回 SERVFAIL,检查 DNSSEC、NS 配置和域名状态。验证通过前不要删除 TXT,Let’s Encrypt 可能从多个网络位置复检;失败后等待 5-10 分钟再重试,避免触发 too many failed authorizations。

完整实操:文件验证与 HTTP-01(Nginx 根目录、权限、curl 复现)

HTTP-01 的本质是 CA 访问 http://example.com/.well-known/acme-challenge/<token>,期望返回 token 对应的 key authorization 纯文本。先建目录:mkdir -p /var/www/html/.well-known/acme-challenge;写入内容:printf '%s' 'TOKEN.CONTENT' > /var/www/html/.well-known/acme-challenge/TOKEN;授权:chown -R www-data:www-data /var/www/html/.well-known,chmod 755 /var/www/html/.well-known /var/www/html/.well-known/acme-challenge,文件 chmod 644。商业 CA 文件验证则把 CA 给的 fileauth.txt 放到站点根目录,内容必须一字不差。

用 curl 从公网视角复现:curl -i http://example.com/.well-known/acme-challenge/TOKEN;必须看到 HTTP/1.1 200 OK 和完整 token。再测 IPv6:curl -6 -i http://example.com/.well-known/acme-challenge/TOKEN;测重定向:curl -IL http://example.com/.well-known/acme-challenge/TOKEN。若返回 301 到 HTTPS,而 HTTPS 尚未配置证书,CA 可能失败;建议在 80 端口为验证路径单独放行,不要全站强制跳转。若使用 CDN,确认 /.well-known/ 回源到正确站点,WAF 未拦截,且没有缓存旧 404。

常见文件验证要求还包括 MIME 类型为 text/plain、不能有 BOM、不能返回 HTML 错误页。Nginx 可用 default_type text/plain; 强制;Apache 确保 .well-known 目录 Require all granted。若文件存在但 CA 仍报 The key authorization file from the server did not match this challenge,优先检查是否有多个站点根目录、负载均衡节点内容不一致、或 CDN 缓存了旧文件。

配置示例:Nginx、Apache、CAA 与 CDN 放行

Nginx 推荐把 ACME 验证目录独立出来,避免被伪静态或 301 覆盖:

server {
    listen 80;
    server_name example.com www.example.com;
    location ^~ /.well-known/acme-challenge/ {
        root /var/www/letsencrypt;
        default_type text/plain;
        try_files $uri =404;
    }
    location / {
        return 301 https://$host$request_uri;
    }
}

对应文件放在 /var/www/letsencrypt/.well-known/acme-challenge/TOKEN。Apache 配置:

Alias /.well-known/acme-challenge/ /var/www/letsencrypt/.well-known/acme-challenge/
<Directory '/var/www/letsencrypt/.well-known/acme-challenge'>
    Require all granted
    Options -Indexes
</Directory>

CAA 记录示例(在 DNS 控制台添加):example.com. 300 IN CAA 0 issue 'letsencrypt.org';通配符再加 example.com. 300 IN CAA 0 issuewild 'letsencrypt.org';可加 0 iodef 'mailto:security@example.com' 接收违规通知。CDN/WAF 需放行 /.well-known/acme-challenge/ 和根目录 fileauth.txt,关闭人机挑战、Bot 防护和强制 HTTPS 回源,确保回源 Host 与证书域名一致。若源站有多台,逐台写入相同 token 并逐台 curl 验证。

验证配置是否生效:nginx -t && nginx -s reload;apachectl configtest && apachectl graceful;curl -i http://example.com/.well-known/acme-challenge/TOKEN。若使用负载均衡,直接对后端节点 IP 加 Host 头测试:curl -H 'Host: example.com' http://10.0.0.10/.well-known/acme-challenge/TOKEN。

验证方式对比表:DNS-01、HTTP-01、文件验证与邮件验证

方式 适用场景 是否支持通配符 关键要求 常见失败点 验证命令/记录
DNS-01 TXT CDN 后、源站不开放 80/443、通配符 支持 DNS 控制台或 API 权限;TXT 记录名 _acme-challenge 记录名错、TTL/负缓存、CAA、DNSSEC dig +short TXT _acme-challenge.example.com @8.8.8.8
HTTP-01 常规 Web 站点、可开放 80 不支持 返回 200 和纯文本 token;无拦截 301 到坏 HTTPS、403/404、WAF、IPv6 源站错 curl -i http://example.com/.well-known/acme-challenge/TOKEN
CA 文件验证 商业 CA DV/OV、指定根目录文件 通常不支持 根目录 fileauth.txt 内容完全一致 多站点根目录、权限、BOM、缓存 curl -i http://example.com/fileauth.txt
邮件验证 老式 CA 流程、无 DNS/Web 权限 不支持 指定邮箱可收信 邮箱不可达、转发丢失、人工延迟 检查 admin@/postmaster@ 收件

选择顺序建议:能改 DNS 且需要通配符,选 DNS-01;不能碰 DNS 但能开放 80,选 HTTP-01;商业 CA 明确要求文件,按文件验证;邮件验证只作兜底。注意证书最长有效期:398 天是 2020 年后的上限,2026-03-15 起降为 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天;Let’s Encrypt 为 90 天。有效期越短,越要自动化,不要手工续期。

常见错误排查:真实报错与逐条修复

报错 1:DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com - check that a DNS record exists for this domain。说明记录名或域名写错。执行 dig +short TXT _acme-challenge.example.com,再查权威 NS:dig +short NS example.com,直接对权威服务器查询。若使用子域名,记录名可能是 _acme-challenge.sub.example.com,不要漏掉子域。

报错 2:DNS problem: SERVFAIL looking up CAA for example.com。优先检查 DNSSEC 是否配置错误、NS 是否可达、CAA 记录语法是否正确。执行 dig +dnssec CAA example.com;若 CAA 存在但不含当前 CA,添加 0 issue 'letsencrypt.org' 或对应 CA 域名。

报错 3:Invalid response from http://example.com/.well-known/acme-challenge/xxx: 403。用 curl -i 复现,检查 Nginx/Apache 的 location、目录权限、SELinux:getenforce、ls -lZ;必要时 chcon -R -t httpd_sys_content_t /var/www/html/.well-known。WAF 需放行该路径。

报错 4:The key authorization file from the server did not match this challenge。文件内容多了换行、空格或 BOM,或负载均衡节点内容不一致。用 curl -s ... | sha256sum 与本地文件比对;多节点逐台写入。

报错 5:CAA record for example.com prevents issuance。执行 dig +short CAA example.com,补 issue/issuewild;修改后等待 TTL 过期。还有 too many failed authorizations recently,需等待 1 小时再试,并用 certbot renew --dry-run 或 acme.sh --issue --debug 2 先验证。

效果验证:证书链、有效期、CT 日志与自动续期

签发后先验证部署:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName。确认 SAN 包含所有域名,notAfter 符合预期。再验链:openssl verify -CAfile fullchain.pem cert.pem;若报 unable to get local issuer certificate,说明缺中间证书,部署 fullchain.pem 而不是仅 cert.pem。

用 curl 验证 HTTP/2 与跳转:curl -I https://example.com、curl -v --resolve example.com:443:203.0.113.10 https://example.com。检查证书透明度:curl -s 'https://crt.sh/?q=example.com&output=json' | jq '.[0:3]';检查 SSL Labs:curl -s 'https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done' | jq '.endpoints[0].grade'。若浏览器提示不受信任,优先查链、系统时间、SNI 和是否部署了自签证书。

自动续期验证:certbot 执行 certbot renew --dry-run;acme.sh 执行 acme.sh --cron --home /root/.acme.sh。监控到期:openssl x509 -in cert.pem -noout -checkend 2592000,返回非 0 即 30 天内到期。最后把验证路径、CAA、TXT 记录、CDN 放行规则写入运维文档,避免下次换 CA 或换 CDN 时重复踩坑。

常见问题

通常 1-10 分钟,取决于 TTL 和权威 DNS。把 TTL 设为 60,用 dig +short TXT _acme-challenge.example.com @8.8.8.8、@1.1.1.1 多解析器确认;若失败过,注意负缓存,等 5-10 分钟再试。


不能。通配符证书必须使用 DNS-01 验证,因为 HTTP-01 和文件验证只能证明单个具体域名的控制权。DNS 记录名通常为 _acme-challenge.example.com,TXT 值由 CA 生成;同时检查 CAA 的 issuewild 是否放行签发 CA。


先 curl -i 复现,确认返回 403 而非 404。检查 Nginx/Apache 的 location、目录 755、文件 644、SELinux 与 WAF;若全站 301 到 HTTPS,给 /.well-known/acme-challenge/ 单独放行 HTTP,并清理 CDN 缓存。


会。若域名存在 CAA 记录,签发 CA 不在 issue 或 issuewild 中,CA 会拒绝签发。执行 dig +short CAA example.com 检查,添加 0 issue ‘letsencrypt.org’ 或对应 CA 域名,修改后等 TTL 过期再重试。


2020 年 9 月后公开信任证书单张上限为 398 天;CA/B Forum SC-081 规定 2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天。Let’s Encrypt 当前仍为 90 天,建议到期前 30 天自动续期。


多为中间证书缺失或链不完整。部署 fullchain.pem 而非仅 cert.pem,用 openssl verify -CAfile fullchain.pem cert.pem 验证;同时检查 SNI、系统时间、是否误装自签证书,以及 CDN 是否回源到正确证书。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。