用 acme.sh 的 DNS-01 一次性签一批子域证书

· tls

机器上挂了二十多个站点,每个都要证书。开始的时候用 HTTP-01,后来发现两个问题:80 端口被占用或者被重定向得乱七八糟,以及通配符证书根本没法用 HTTP-01 签。

为什么选 DNS-01

DNS-01 只要求能把一条 TXT 记录写进域名的解析里,跟 80 端口、跟站点能不能访问完全无关。机器上没有公网入口也能签,也能签通配符。

前提是手里有域名商的 API 凭据。DNSPod 用 dns_tencent,凭据放在 acme.sh 的 account.conf 里,签发时不用再传。

一条命令签一个

/opt/acme.sh/acme.sh --home /root/.acme.sh \
  --issue --dns dns_tencent --server letsencrypt \
  -d notes.example.com --keylength ec-256

--server 要显式写 letsencrypt。不写的话默认走 ZeroSSL,免费额度有每日上限,批量签的时候会被挡住。

一条命令签多个名字,把 -d 重复几次就行,它们会进同一张证书的 SAN。SAN 里的名字互相没有关系也能放,证书主题用第一个。

装到 nginx 的目录里

签发完不要手工 cp,用 --install-cert,把重载命令一起给它:

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

这样每次续期之后 nginx 会自动重载,不用人管。

cron 里一定要清掉代理变量

这条踩过。cron 起来的环境里可能带着 /etc/environment 里的 http_proxy,acme.sh 走 DNS 接口时会被塞进代理,报 TLS error 35 之类的握手错误。

现在 /root 下的续期脚本第一件事就是 unset 掉 http_proxy https_proxy all_proxy 以及它们的大写版本,然后再 exec acme.sh --cron。

目录归属

/etc/nginx/cert 下每个域名一个目录,fullchain 和 privkey 各一份。私钥 600,父目录 755。nginx 的 master 是 root,读得到就好。

顺手记一句:ECC 私钥只有两百多字节,第一次看到会以为是空文件。