Bobay Stack 波贝自建栈

运维与排障 / 2026-08-05

Nginx + acme.sh:用 DNS-01 把证书这件事自动化

HTTP-01 需要 80 端口和公网可达,DNS-01 不需要。代价是要一个能改 DNS 的 API Token。

7 MIN READ BY BOBAY.TOP 更新于 2026-08-11 ↖ 全部笔记
Nginx + acme.sh:用 DNS-01 把证书这件事自动化

证书自动化最容易断的地方不是签发,是续期之后服务没重载。DNS-01 的好处是把"证明域名归属"这件事从 80 端口挪到了 DNS 记录上,内网机器、反代后面的机器都能签。

为什么选 DNS-01

  • 机器不在公网,80 端口过不来
  • 想签泛域名(*.example.com),HTTP-01 做不了
  • 不想为了续期临时开放 80

代价是:你需要一个能改 DNS 的 API Token,并且这个 Token 得能长期用(或定期更新)。

Cloudflare 的写法

export CF_Token="<仅 Zone.DNS 编辑权限的 Token>"
acme.sh --issue --dns dns_cf -d example.com -d www.example.com --keylength ec-256

权限最小化很重要:这个 Token 只要 DNS 编辑权限,不要给 Zone 全权,更不要给账号级权限。

安装到 Nginx 并重载

acme.sh --install-cert -d example.com --ecc \
  --key-file       /etc/nginx/certs/example.com.key \
  --fullchain-file /etc/nginx/certs/example.com.fullchain.pem \
  --reloadcmd      "nginx -t && systemctl reload nginx"

--reloadcmd 里带 nginx -t 是个好习惯:配置坏了就不会重载,线上还是旧配置,不会把站点搞挂。

Nginx 侧的最小配置

ssl_protocols TLSv1.2 TLSv1.3;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
add_header Strict-Transport-Security "max-age=31536000" always;

HSTS 一旦下发,回退很麻烦(浏览器会记住一年)。先在测试域名上跑一段时间再上生产。

续期验证

acme.sh --list
acme.sh --renew -d example.com --force

强制续期一次,看证书文件时间戳有没有变、Nginx 有没有重载、浏览器有没有拿到新证书。三步都过,才算真的自动化了。

为什么不用 HTTP-01

HTTP-01 要 80 端口可达、要临时写 /.well-known/acme-challenge/,还要保证重定向不把它吃掉。站上一旦有强制 HTTPS 或 CDN 回源改写,验证失败率立刻上升。DNS-01 只写一条 TXT,和站点路由、重定向、防火墙全部解耦。

代价是:你必须有一个能改 DNS 的 API 凭证。Cloudflare 的 token 粒度要收窄到 Zone:DNS:Edit 加单个 zone,别用全局 key。

一次完整流程

# 1. 先手动跑一次,确认 TXT 能发出去
acme.sh --issue --dns dns_cf -d bobay.top -d '*.bobay.top' --staging

# 2. 去掉 --staging 正式签发
acme.sh --issue --dns dns_cf -d bobay.top -d '*.bobay.top'

# 3. 装到 nginx 目录,并配置 reload
acme.sh --install-cert -d bobay.top \
  --key-file /etc/nginx/ssl/bobay.key \
  --fullchain-file /etc/nginx/ssl/bobay.crt \
  --reloadcmd "nginx -s reload"

--staging 那一步很重要:正式环境有速率限制(同一域名每周 5 次),调试期用 staging 试通,别拿生产额度去排错。

续期与验证

acme.sh 装完后会写一条 cron,默认每天检查、到期前 30 天续。真正要验的不是"有没有 cron",而是续期后 nginx 有没有吃到新证书:

openssl x509 -in /etc/nginx/ssl/bobay.crt -noout -dates
echo | openssl s_client -connect bobay.top:443 -servername bobay.top 2>/dev/null | openssl x509 -noout -dates

两条命令的 notAfter 必须一致。不一致说明 reload 没生效,或者 nginx 读的是另一份文件。

踩过的两个坑

  • 通配符和根域要分开签:*.bobay.top 不覆盖 bobay.top,必须写成 -d bobay.top -d '*.bobay.top'。
  • CF 代理开着时验证会"看起来成功":curl 打到的是 Cloudflare 边缘证书,不是你源站那张。验证源站必须直连 IP 加 --resolve。

补一句:续期失败往往不是证书问题,而是 DNS token 过期。CF token 虽然没有过期时间,但被手动删掉就会立刻失效——建议在续期脚本里加一条"TXT 写入失败就告警",别等证书到期才发现。

Nginxacme.shTLSDNS-01

参考

acme.sh DNS 模式 ↗ Nginx SSL 配置 ↗