给内网域名签公开可信证书:DNS-01 CNAME 委托 + Nginx 部署全流程
内网服务无法用 HTTP-01 验证时,可以用 CNAME 把验证委托给专门的 ACME 域名完成 DNS-01 签发。本文给出从准备 DNS 记录到 Nginx 部署、再到签发验证的完整操作步骤和排查要点。
本文目录

很多团队的 Grafana、GitLab 内网实例跑在 grafana.internal.example.com 这类域名上,没有公网入口,防火墙只放行办公网。想给它配一张浏览器不报警的证书,HTTP-01 走不通——Let's Encrypt 的验证服务器根本够不到你的机器。常见误解是"内网域名只能自签",其实 DNS-01 验证完全不关心你的 Web 服务在哪,只要能控制 DNS 就行。
更麻烦的一层是:很多人不想把主域名的 DNS API 密钥放到每台服务器上。这时 CNAME 委托就派上用场了——把 _acme-challenge 记录指向一个专门用于签发的子域,API 凭据只需要那个子域的权限。
前置条件
- 域名
example.com的 DNS 由支持 API 的服务商托管(Cloudflare、DNSPod 等均可) - 目标主机已安装 Nginx,内网可通过
grafana.example.com访问到它 - 能创建一个新的子域(本文用
acme-certs.example.com)并给它单独的 API Token
第一步:配置 CNAME 委托记录

在 example.com 的 DNS 里加一条记录:
_acme-challenge.grafana.example.com CNAME grafana.acme-certs.example.com签发时,ACME 客户端只需在 acme-certs.example.com 这个域下写入 TXT 记录。主域的 API 密钥不出现在服务器上,泄漏面小了很多。
验证委托是否生效:
dig +short CNAME _acme-challenge.grafana.example.com
# 应返回 grafana.acme-certs.example.com.注意末尾的点。少了它,有些解析器会拼出奇怪的相对域名,签发时报"TXT record not found",让你怀疑人生。

第二步:用 DNS-01 签发证书
在 CertbotX 中实践:CertbotX 原生支持 DNS-01 的 CNAME 委托模式。在控制台为 acme-certs.example.com 配置好 DNS API 凭据后,签发任务里直接填 grafana.example.com,客户端会自动沿着 CNAME 找到委托域写 TXT,不需要手动指定。签完后证书进入到期前自动续期队列,续期走同样的委托路径,全程无人工介入。
如果先在命令行上手动验证流程,acme.sh 的等价写法大致是:
export CF_Token="仅含 acme-certs 子域权限的 Token"
acme.sh --issue --dns dns_cf \
-d grafana.example.com \
--challenge-alias grafana.acme-certs.example.com签发成功后立刻检查证书内容,确认 SAN 里是你想要的名字:
openssl x509 -in /path/to/grafana.example.com.cer -noout -text | grep -A1 "Subject Alternative Name"
第三步:Nginx 配置 HTTPS
一份最小可用配置:
server {
listen 443 ssl;
server_name grafana.example.com;
ssl_certificate /etc/nginx/ssl/grafana.example.com/fullchain.cer;
ssl_certificate_key /etc/nginx/ssl/grafana.example.com/grafana.example.com.key;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
}
}几个容易踩的坑:
ssl_certificate要用 fullchain(服务器证书 + 中间证书),只放叶子证书,部分旧客户端会报"证书链不完整"。- 改完先
nginx -t再 reload,别直接重启——配置有错时重启会把在跑的服务一起带走。 - 证书文件权限收紧到
600,属主 root。
第四步:验证与持续运维

外部视角验证:
openssl s_client -connect grafana.example.com:443 -servername grafana.example.com </dev/null 2>/dev/null | openssl x509 -noout -dates -issuer确认两点:颁发者是 Let's Encrypt 的当前中间 CA,notAfter 和签发时间对得上。
内网服务有一个特有的小坑:客户端机器必须能解析 grafana.example.com。如果内网 DNS 和公网 DNS 分家(split-horizon),确保内网视图里这个域名指向内网 IP,而 _acme-challenge 的 CNAME 在公网视图可见——两者各管各的,不冲突。
证书是 90 天有效期,真正的风险不在签发而在续期。CertbotX 的部署记录与审计功能在这里比较实用:每次自动续期后,证书会被推送到对应的 Agent(也就是这台 Nginx 主机)并留下一条部署记录,出了"证书没更新"的告警时,可以先查部署记录确认是续期失败还是部署环节卡住,而不是盲猜。