一张证书覆盖 4 个域名,90 天自动续期,部署到 Nginx 自动重载,全程无人值守。 本文记录一次完整的迁移过程,包括 6 个真实踩到的坑。
一、手动更新 SSL 证书那些血泪史
如果你正在用云厂商的免费 SSL 证书,大概率经历过这个循环:
控制台申请 → 等签发 → 下载 zip → 解压 → 传到服务器 → 改 Nginx 配置 → reload → 三个月后再来一遍
这套流程的痛点不在于"麻烦",而在于它会忘。三个月足够长,长到你一定会忘。突然用户反映小程序报错了,排查半天发现是 SSL 证书到期了,瞬间整个人的心情都不好了。所以我不得不采取手段,把这根刺拔掉。
本文的方案用一句话概括:把证书签发搬进服务器,让它自己去要证书。
技术栈:
| 角色 | 作用 |
|---|---|
| Let's Encrypt | 免费 CA,90 天有效期,全球浏览器信任 |
| acme.sh | 跑在服务器上的 ACME 客户端,负责申请、续期、安装 |
| DNSPod API | 只用来加一条临时 TXT 记录,证明域名归属 |
| cron | 每天检查一次,到点自动续 |
文中
example.com代表你的域名,<你的SecretId>这类尖括号内容需要替换成你自己的值。
二、痛点:90 天一次的手动循环
云厂商的免费证书从 2021 年起有效期调整为 90 天,官方文档里写得很明白:
- 一个账号最多 50 张
- 不支持泛域名
- 不支持多域名(一个域名一张)
- 证书吊销或到期后 24 小时才释放额度
最后一条很容易被忽略。假设你有 4 个域名,一年要续 4 次,那就是 16 张/年。50 张额度,三年就耗尽了。
而且免费证书没有自动续费。厂商提供的"自动续费"是给付费证书扣款用的流程,官方指引里最后一步写得很清楚:
证书签发成功后,请您务必手动将新证书更新到关联云资源。
三、为什么自带的"证书托管"救不了你
这是很多人踩过的认知坑。云厂商确实有"证书托管"功能,看起来像是自动部署,但官方文档原文是:
如果您的 SSL 证书仅用于部署至云资源,开启云资源托管,可实现新证书自动更新到云资源;如果您的证书用在非云资源,即使您的 SSL 证书已开启证书托管服务,仍然需要手动将新证书安装到您的 Web 服务中。
我给大家解读一下:
| 你的证书用在哪 | 托管有没有用 |
|---|---|
| CLB / CDN / WAF / API 网关 | ✅ 有用 |
| 自己服务器上的 Nginx | ❌ 没用,还是得手动 |
绝大多数个人项目和中小项目,证书就是装在自己服务器上的 Nginx 里。所以这条路走不通。
四、方案选型
4.1 三条路
| 方案 | 全自动 | 泛域名 | 多域名一张 | 改动量 |
|---|---|---|---|---|
| 云厂商免费证书 + 手动 | ❌ | ❌ | ❌ | 每 90 天一次 |
| 云厂商免费证书 + API 脚本 | ⚠️ 自己写 | ❌ | ❌ | 大 |
| Let's Encrypt + acme.sh | ✅ | ✅ | ✅ | 一次配置 |
第三条路的优势是:它本身就是为自动化设计的协议,不是"能自动化",而是"只能自动化"。
4.2 为什么必须用 DNS-01 验证
ACME 协议有三种域名验证方式:
| 方式 | 原理 | 限制 |
|---|---|---|
| HTTP-01 | 在网站根目录放个文件,CA 来访问 | 需要 80 端口对外可达 |
| TLS-ALPN-01 | 在 443 端口做 TLS 握手验证 | 需要 443 可用且没有其他服务占用 |
| DNS-01 | 在 DNS 里加一条 TXT 记录 | 需要 DNS API 权限 |
DNS-01 有两个关键优势:
- 完全不需要开放任何端口。国内服务器 80 端口未备案会被拦,HTTP-01 直接死路
- 支持泛域名。这是另外两种方式做不到的
代价是你得给 acme.sh 一个能改 DNS 的 API 密钥------这也是本文安全部分要重点讲的地方。
4.3 一张证书还是多张
Let's Encrypt 支持多域名证书(SAN),一张证书最多 100 个域名。
我最终把 4 个域名放进了一张证书:
example.com
www.example.com
二级域名1.example.com
二级域名2.example.com
好处很直接:
| 每域名一张 | 一张多域名 | |
|---|---|---|
| 证书数量 | 4 | 1 |
| 续期任务 | 4 个 | 1 个 |
| 配置文件 | 4 对路径 | 1 对路径 |
| 新增域名 | 单独签一张 | 重签整张 |
代价是:任何一个域名验证失败,整张证书都签不下来。但同一主域下的子域名走同一套 DNS API,这个风险很低。
五、几个必须先搞懂的概念
5.1 ACME 是什么
ACME(Automatic Certificate Management Environment)是一套协议,规定了"客户端如何自动向 CA 申请证书"。
它把传统流程里的"填表、等邮件、下载、上传"全部变成了 API 调用。Let's Encrypt 是这套协议最广为人知的实现。
5.2 续期时机:从固定 60 天到 ARI
老版本 acme.sh 的续期逻辑很简单:签发后 60 天(即剩余 30 天)续期。
新版引入了 ARI(ACME Renewal Information)------CA 会在签发时告诉你一个建议的续期窗口,客户端按这个窗口来。
实际日志长这样:
yaml
ARI suggestedWindow: 2027-01-11T15:59:18Z to 2027-01-13T11:10:08Z
Next renewal time picked from ARI window: 2027-01-12T09:53:07Z
5.3 文件为什么要 install-cert 而不是直接用
acme.sh 把证书放在 ~/.acme.sh/<domain>_ecc/ 下。但官方明确不建议直接用这个目录,原因有两个:
- 这个目录结构可能随版本变化
- 直接引用的话,续期后如果没 reload,你根本不知道
正确做法是 --install-cert 把证书"安装"到你指定的稳定路径,并注册一个 reload 命令。
这一步是整个方案的核心。 它把"续期"和"生效"绑在了一起。
六、实战教学
6.1 环境
本文环境:
- Ubuntu 24.04
- Nginx 1.24,apt 安装
- 域名解析在 DNSPod
- acme.sh 与 Nginx 同机
如果你用 CentOS,把 apt 换成 yum、cron 换成 crond 即可,其余不变。
6.2 建云账号子用户(最小权限)
这一步不能省。 直接把主账号密钥放到服务器上,等于把整个云账号交出去。
第一步:建子用户
在云厂商的访问管理(CAM)里,进入用户列表 → 新建用户 → 自定义创建:
- 用户名:
ssl-auto - 访问方式:只勾「编程访问」,不要勾控制台登录
- 权限:先跳过,策略后面单独建
第二步:建自定义策略
策略 → 新建自定义策略 → 按策略语法创建 → 空白模板:
json
{
"version": "2.0",
"statement": [
{
"effect": "allow",
"resource": ["*"],
"action": [
"dnspod:DescribeRecordFilterList",
"dnspod:DescribeRecordList",
"dnspod:CreateRecord",
"dnspod:DeleteRecord"
]
}
]
}
只有 4 个动作:查记录、加记录、删记录。不能改域名注册信息,不能动其他云资源。
第三步:绑定并建密钥
把策略绑给 ssl-auto,然后在用户的「API 密钥」标签页新建密钥。
⚠️ SecretKey 只显示一次,关掉页面就永远看不到了。
6.3 安装 acme.sh(国内网络的坑)
官方一键安装:
bash
curl https://get.acme.sh | sh -s email=<你的邮箱>
但在国内服务器上,这条命令大概率卡死。 原因:get.acme.sh 那个脚本本身只有 1KB,很快;但它接着要去 GitHub 拉 acme.sh 本体,国内访问 GitHub 经常长时间 0 字节。
我卡了两分钟,最后改用国内镜像仓库:
bash
# 镜像仓库与上游同步,可从 Gitee 克隆
git clone --depth 1 https://gitee.com/neilpang/acme.sh.git
cd acme.sh
./acme.sh --install -m <你的邮箱>
--install 是纯本地操作,不再联网,所以 clone 成功就等于装好了。
bash
source ~/.bashrc
acme.sh --version
# https://github.com/acmesh-official/acme.sh
# v3.1.5
6.4 签发 4 域名证书
先把默认 CA 设为 Let's Encrypt(acme.sh 默认是 ZeroSSL,需要额外注册):
bash
acme.sh --set-default-ca --server letsencrypt
导入密钥(域名解析在 DNSPod,用 dns_tencent 插件):
bash
export Tencent_SecretId="<你的SecretId>"
export Tencent_SecretKey="<你的SecretKey>"
签发:
bash
acme.sh --issue --dns dns_tencent \
-d example.com \
-d www.example.com \
-d 二级域名1.example.com \
-d 二级域名2.example.com \
--keylength ec-256
几个参数值得解释:
| 参数 | 说明 |
|---|---|
--dns dns_tencent |
用 DNSPod API 做验证 |
-d example.com |
第一个 -d 是主域名,决定证书目录名 |
--keylength ec-256 |
ECC 证书,体积是 RSA 的 1/4,握手更快 |
第一个 -d 很重要 ,因为后续所有 --install-cert、--renew 都要用这个域名来定位证书。
执行过程会看到:
erlang
Adding TXT value: xxx for domain: _acme-challenge.example.com
The TXT record has been successfully added.
...
Let's check each DNS record now. Sleeping for 20 seconds first.
...
Cert success.
中间那 20 秒是在等 DNS 传播,正常。
6.5 安装证书并绑定重载
bash
mkdir -p /etc/nginx/cert/example.com
acme.sh --install-cert -d example.com --ecc \
--key-file /etc/nginx/cert/example.com/privkey.pem \
--fullchain-file /etc/nginx/cert/example.com/fullchain.pem \
--reloadcmd "nginx -t && systemctl reload nginx"
三个参数:
--key-file:私钥落点--fullchain-file:完整证书链(含中间证书),Nginx 用这个--reloadcmd:续期成功后自动执行的命令
--ecc 不能漏。ECC 证书存在 example.com_ecc 目录,不加这个参数 acme.sh 会去找 RSA 目录,报"证书不存在/域名不匹配"。
执行完,这些配置会被写进 ~/.acme.sh/example.com_ecc/example.com.conf:
bash
grep -E "Le_RealFullChainPath|Le_RealKeyPath|Le_ReloadCmd" \
~/.acme.sh/example.com_ecc/example.com.conf
输出:
ini
Le_RealKeyPath='/etc/nginx/cert/example.com/privkey.pem'
Le_RealFullChainPath='/etc/nginx/cert/example.com/fullchain.pem'
Le_ReloadCmd='__ACME_BASE64__START_...'
那个 __ACME_BASE64__ 就是 nginx -t && systemctl reload nginx------acme.sh 用 base64 存是为了避开引号转义问题。
顺带一提:
Le_RealCertPath是空的,这是正常的。我们用 fullchain,路径存在Le_RealFullChainPath里。
6.6 Nginx 配置
nginx
server {
listen 443 ssl;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/cert/example.com/fullchain.pem;
ssl_certificate_key /etc/nginx/cert/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_session_cache shared:SSL:10m;
# OCSP 装订,国内访问能快一点
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/cert/example.com/fullchain.pem;
}
四个 server 块引用同一对文件,改的时候用 sed 批量替换比手改安全:
bash
sed -i 's#/etc/nginx/cert/old/#/etc/nginx/cert/example.com/#g' /etc/nginx/conf.d/site.conf
改完必须核对:
bash
grep -rn "ssl_certificate" /etc/nginx/conf.d/
确认每一行都指向新路径,再往下走。
6.7 验证:查的是"网站实际返回的证书"
很多人只查磁盘文件:
bash
openssl x509 -in /etc/nginx/cert/example.com/fullchain.pem -noout -dates
这不够。 它只能证明文件是对的,不能证明 Nginx 真的在用。
正确的验证方式是模拟一次 HTTPS 握手:
bash
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null \
| openssl x509 -noout -issuer -dates
4 个域名批量:
bash
for d in example.com www.example.com 二级域名1.example.com 二级域名2.example.com; do
echo "== $d"
echo | openssl s_client -connect $d:443 -servername $d 2>/dev/null \
| openssl x509 -noout -issuer -dates
done
6.8 续期演练(最容易被跳过的一步)
为什么必须做 :首次签发是在 SSH 交互式 shell 里跑的,你的 export 还在环境变量里。但 90 天后触发续期的是 cron------它没有你的环境变量,可能用不同的 shell,不同的 PATH。
不演练,你根本不知道那天会不会失败。而失败的表现是 90 天后网站突然打不开。
bash
acme.sh --renew -d example.com --ecc --force
看日志结尾:
javascript
Installing key to: /etc/nginx/cert/example.com/privkey.pem
Installing full chain to: /etc/nginx/cert/example.com/fullchain.pem
Running reload cmd: nginx -t && systemctl reload nginx
Reload successful
看到 Reload successful 才算真的通。
再确认文件真的被覆盖了:
bash
stat -c '%y %n' /etc/nginx/cert/example.com/*
# 2026-11-13 22:13:49 .../fullchain.pem
# 2026-11-13 22:13:49 .../privkey.pem
--force会计入 Let's Encrypt 每周 5 张重复证书的限额,跑一次就够,别反复跑。
6.9 监控:让它在登录时就撞见你
自动化最怕的不是失败,是静默失败。
acme.sh 有一个容易忽略的行为:--install-cert 是先写证书文件、再执行 --reloadcmd。如果 reload 失败,证书已经换新、续期时间戳也更新了,下次 cron 不会再重试------Nginx 还在用旧证书,直到过期你才发现。
所以必须有一个"从外部看"的检查。
如果不想配邮件或 Webhook,有个很轻的方案:把检查结果挂到 SSH 登录界面上。
脚本:
bash
cat > /usr/local/bin/cert-status.sh <<'EOF'
#!/usr/bin/env bash
DOMAINS="example.com www.example.com 二级域名1.example.com 二级域名2.example.com"
WARN_DAYS=21
warn=0
printf '%-24s %-8s %-10s %s\n' "域名" "剩余" "签发者" "到期时间"
echo "------------------------------------------------------------------"
for d in $DOMAINS; do
out=$(echo | openssl s_client -connect "$d:443" -servername "$d" 2>/dev/null \
| openssl x509 -noout -enddate -issuer 2>/dev/null)
if [ -z "$out" ]; then printf '%-24s %s\n' "$d" "连接失败"; warn=1; continue; fi
end=$(echo "$out" | grep notAfter | cut -d= -f2)
iss=$(echo "$out" | grep issuer | sed 's/.*CN *= *//')
left=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
[ "$left" -lt "$WARN_DAYS" ] && warn=1
printf '%-24s %-8s %-10s %s\n' "$d" "${left}天" "$iss" "$end"
done
if [ "$warn" -eq 1 ]; then
echo
echo "⚠️ 有域名剩余不足 ${WARN_DAYS} 天(或连接失败),自动续期可能出问题了!"
fi
EOF
chmod +x /usr/local/bin/cert-status.sh
挂到 /etc/profile.d/:
bash
cat > /etc/profile.d/cert-status.sh <<'EOF'
case $- in
*i*) [ -x /usr/local/bin/cert-status.sh ] && /usr/local/bin/cert-status.sh ;;
esac
EOF
chmod +x /etc/profile.d/cert-status.sh
case $- in *i*) 保证只在交互式 shell 执行,scp、sftp、ssh host 'cmd' 不受影响。
效果:每次登录服务器,第一屏就是
yaml
域名 剩余 签发者 到期时间
------------------------------------------------------------------
example.com 89天 YE1 Feb 11 13:15:13 2027 GMT
www.example.com 89天 YE1 Feb 11 13:15:13 2027 GMT
二级域名1.example.com 89天 YE1 Feb 11 13:15:13 2027 GMT
二级域名2.example.com 89天 YE1 Feb 11 13:15:13 2027 GMT
我一开始挂的是
/etc/update-motd.d/,结果登录什么都不显示。排查发现 PAM 配置正常、脚本也能跑,问题出在/run/motd.dynamic这个中间缓存上。Ubuntu 24.04 某些云镜像里这套机制会失效,换profile.d后就稳了。
七、6 个真实踩到的坑
坑 1:curl | sh 卡在 0 字节
现象 :curl https://get.acme.sh | sh 第二条进度条一直是 0。
原因:脚本要回 GitHub 拉本体,国内网络经常长时间无响应。
解法 :改用镜像仓库克隆后本地 --install。
坑 2:nginx -T 什么都不输出
现象 :nginx -T 2>/dev/null | grep ssl_certificate 输出为空,以为没配证书。
原因 :普通用户跑 nginx -T 打不开 error log,直接退出;2>/dev/null 又把报错吞了。
解法 :sudo -i 切 root 再跑。别用 2>/dev/null 掩盖错误。
坑 3:dns_tencent 和 dns_dp 是两套东西
DNSPod 有两个体系,很容易混:
| 域名在哪 | 插件 | 环境变量 |
|---|---|---|
| 云厂商「云解析 DNS」 | --dns dns_tencent |
Tencent_SecretId / Tencent_SecretKey |
| DNSPod 独立账号 | --dns dns_dp |
DP_Id / DP_Key(Token) |
用错了会一直报 DNS 验证失败,而且报错信息不会直接告诉你用错了插件。
坑 4:ECC 证书漏了 --ecc
现象 :--install-cert 报"证书不存在/域名不匹配"。
原因 :--keylength ec-256 签发的证书存在 <domain>_ecc 目录,不加 --ecc 会去 RSA 目录找。
解法 :签发、安装、续期、吊销,全程都要带 --ecc。
坑 5:密钥截图等于泄露
这是后果相当严重的一个。
创建 API 密钥时弹窗会显示 SecretId 和 SecretKey。我截图发出去确认了一下------这个动作等于把密钥公开了。
这把密钥的权限里有 dnspod:CreateRecord 和 DeleteRecord,意味着持有者可以删掉域名的 A 记录、换成别的 IP。这不是"泄露一个标识符",是"把域名解析的控制权交出去"。
处理:立即在控制台禁用并删除该密钥,重新创建一把,这次直接复制粘贴到终端,不经过任何中间环节(聊天窗口、截图、剪贴板工具)。
教训:
SecretKey 只允许出现在两个地方------创建时的弹窗,和你服务器终端的
export命令。存进密码管理器后就当它不存在。
坑 6:一张证书过期 49 天,没人发现
迁移时跑检查脚本,发现 4 个域名里有一个的证书:
yaml
二级域名2.example.com -49天 TrustAsia Sep 25 01:59:59 2026 GMT
已经过期 49 天。 也就是说,这个站点对外提供无效证书将近两个月,任何访问者都会看到浏览器的红色警告页。
这件事本身就是最好的论据:没有监控的自动化,只是把"手动忘掉"变成了"自动忘掉"。
八、成本与收益
成本:一次性配置约 30 分钟,不产生额外费用。
收益:
- 每年省下 4 次 × 4 个域名 = 16 次手动操作
- 降低"证书过期导致全站警告"的风险
- 以后加子域名只改 Nginx 配置,证书一张通吃
- 服务器上只多了一个
~/.acme.sh目录和一个 cron 任务
风险:依赖云 API 密钥。密钥失效 = 续期失败,所以监控是必需品。
九、写在最后
这套方案的思路其实很简单:把"人记得去做"变成"机器定期检查"。
90 天的有效期设计,本质上是在逼所有人自动化------毕竟没有任何人能在三个月里可靠地记住一件事。
如果你还在手动续证书,可以找个低峰时段迁移一次,之后基本不用再操心。