给内网域名签公开可信证书:DNS-01 CNAME 委托 + Nginx 部署全流程

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

本文目录
给内网域名签公开可信证书:DNS-01 CNAME 委托 + 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 委托记录

给内网域名签公开可信证书:DNS-01 CNAME 委托 + Nginx 部署全流程:DNS ownership verification using a delegated CNAME, shown as a precise handoff between two controlled zones
给内网域名签公开可信证书:DNS-01 CNAME 委托 + Nginx 部署全流程:DNS ownership verification using a delegated CNAME, shown as a precise handoff between two controlled zones查看原图

在 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 CNAME 委托 + Nginx 部署全流程:an ACME request being validated at separate stations and turned into a new deployable artifact while private key material remains at its origin
给内网域名签公开可信证书:DNS-01 CNAME 委托 + Nginx 部署全流程:an ACME request being validated at separate stations and turned into a new deployable artifact while private key material remains at its origin查看原图

第二步:用 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"
给内网域名签公开可信证书:DNS-01 CNAME 委托 + Nginx 部署全流程:a new certificate version moving from its source to several edge appliances while the previous working version remains ready for rollback
给内网域名签公开可信证书:DNS-01 CNAME 委托 + Nginx 部署全流程:a new certificate version moving from its source to several edge appliances while the previous working version remains ready for rollback查看原图

第三步: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。

第四步:验证与持续运维

给内网域名签公开可信证书:DNS-01 CNAME 委托 + Nginx 部署全流程:an approaching certificate expiry being detected early, followed by a fresh request and a safe replacement before the live connection is interrupted
给内网域名签公开可信证书:DNS-01 CNAME 委托 + Nginx 部署全流程:an approaching certificate expiry being detected early, followed by a fresh request and a safe replacement before the live connection is interrupted查看原图

外部视角验证:

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 主机)并留下一条部署记录,出了"证书没更新"的告警时,可以先查部署记录确认是续期失败还是部署环节卡住,而不是盲猜。

← 返回资讯中心