运维与排障 / 2026-08-05
Nginx + acme.sh:用 DNS-01 把证书这件事自动化
HTTP-01 需要 80 端口和公网可达,DNS-01 不需要。代价是要一个能改 DNS 的 API Token。
证书自动化最容易断的地方不是签发,是续期之后服务没重载。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 写入失败就告警",别等证书到期才发现。