4
0
0

手动续期 SSL 证书可以退休了:acme.sh 实战,证书砍到 47 天也不怕

文章摘要
|

证书寿命,正在倒计时

先看一条已经被很多人忽略的「旧闻」:CA/Browser Forum 的 SC-081v3 提案正式生效后,公开信任的 TLS 证书最长寿命从 2026 年 3 月 15 日起被砍到 200 天。而这只是个开始,官方时间表排得很满(DigiCert、Sectigo 与 cabforum.org 原文多方一致):

2026 年 3 月 15 日起:最长 398 天 → 200 天
2027 年 3 月 15 日起:200 天 → 100 天
2029 年 3 月 15 日起:100 天 → 47 天

什么概念?以前一年续一次证书还能靠日历提醒撑过去;现在 200 天规则已经落地大半年,明年 3 月之后就是一年至少四次,2029 年直接奔着一年八次去。连域名验证结果(DCV)的复用期也同步缩到了 200 天——手动续期这条路,不是越来越难走,是马上要没了。

解法其实早就有了:把签发、部署、续期全部交给脚本。今天的主角 acme.sh 是 GitHub 上 47,931 star、5,707 fork 的老牌项目(数据为本文写作时的实时读数),纯 Shell 写成的 ACME 协议客户端,零依赖、单文件、跨平台到连 Windows 的 cygwin 都支持,目前由 ZeroSSL 官方参与维护,最近一次推送就在两周前——活跃度完全不用担心。我把全部流程在沙盒里实跑了一遍,下面的每条命令和输出都是一手实测。

30 秒理解 ACME:证书也能「API 化」

ACME(Automatic Certificate Management Environment)是 RFC 8555 定义的证书管理协议,Let's Encrypt、ZeroSSL 这些免费 CA 都靠它工作。流程一句话讲完:客户端向 CA 证明「这个域名是我的」,CA 就把证书签给我,到期前还能自动续。证明方式有三种:

  • HTTP-01:CA 访问你域名 80 端口下的一个验证路径,适合 Web 服务器正在跑的机器;
  • TLS-ALPN-01:走 443 端口的 TLS 握手验证,80 端口不方便开放时的备选;
  • DNS-01:在 DNS 里加一条 TXT 记录,唯一支持通配符证书的方式。

三种对应 acme.sh 的三种签发姿势,下面逐个过。

安装:一行命令,附赠每日闹钟

acme.sh 的安装就一行(邮箱换成你自己的,用于证书到期通知):

curl https://get.acme.sh | sh -s email=my@example.com

我在干净的沙盒里实跑了一遍,安装器会自动完成三件事:把程序装到 ~/.acme.sh/、注册账号、创建每日定时任务。装完看一眼目录:

~/.acme.sh/
├── account.conf          # 账号与 CA 配置
├── acme.sh               # 主程序(就这一个文件)
├── dnsapi/               # 上百个 DNS 服务商的 API 脚本
├── deploy/               # 部署钩子(nginx、docker、ssh……)
└── notify/               # 续期失败的通知渠道

正常服务器上,安装器会自动写入一条 crontab,每天零点检查所有证书、该续的自动续:

0 0 * * * "/home/user/.acme.sh"/acme.sh --cron --home "/home/user/.acme.sh" > /dev/null

两个实测细节:①我的沙盒没装 crontab,安装器直接停下并警告「We need to set a cron job to renew the certs automatically」——这个自检很贴心,见到它就说明你的环境缺 cron,装上 cronie 或 crontabs 再跑一次;②国内服务器访问 GitHub 慢的话,README 专门给了 Install in China 方案。当前版本实测为 v3.1.7。

终端里的实际操作画面

签发证书的三种姿势

姿势一:webroot——Nginx 正在跑就选它

服务器上已经有网站在跑、80 端口被 Nginx 占着,用 webroot 模式最省事。验证文件会被写进网站根目录,CA 访问一下就完成证明:

acme.sh --issue -d example.com -w /var/www/html

-w 指向网站真实根目录,必须对它有写权限;一张证书要包含多个域名就多写几个 -d,但所有域名要指向同一个 webroot。证书默认签成 ECC(P-256),现代浏览器全支持、密钥更小。

姿势二:standalone——裸机 80 端口还空着

机器还没跑 Web 服务(比如只是个内部节点),让 acme.sh 自己在 80 端口起个临时服务来完成验证:

acme.sh --issue --standalone -d example.com

注意 80 端口此时必须空闲;如果 Nginx 已经占着,要么临时停一下,要么直接用姿势一。

姿势三:DNS API——通配符的唯一解

想给 *.example.com 签一张通配符证书,只能走 DNS-01 验证。手动加 TXT 记录当然可以,但那就没法自动续期了(README 原话警告:DNS manual mode cannot be renewed automatically)。正确姿势是把 DNS 服务商的 API 交给 acme.sh,以 Cloudflare 为例:

# 在 Cloudflare 面板创建 API Token(权限给 Zone:DNS:Edit),然后:
export CF_Token="你的API_Token"
export CF_Account_ID="你的Account_ID"   # 可选:再加 CF_Zone_ID 更稳

acme.sh --issue -d example.com -d '*.example.com' --dns dns_cf

我翻了一下 dnsapi/dns_cf.sh 的源码确认过:新版推荐 CF_Token(细粒度 Token)配 CF_Account_ID,老式的 CF_Key + CF_Email(Global API Key)也还兼容,但权限太大不推荐。凭据会在首次签发后自动保存,之后 cron 续期时无需再 export。DNS 模式还有个隐藏福利:签发时不需要任何端口对公网开放,内网机器、防火墙后的小盒子都能用。

装进 Nginx:reloadcmd 是灵魂参数

签好的证书先别急着用。README 里有个加粗警告:不要直接引用 ~/.acme.sh/ 里的证书文件——那是内部目录,结构随时可能变。正确做法是用 --install-cert 把证书复制到生产路径,并且把重载命令也一并交给 acme.sh:

mkdir -p /etc/nginx/certs

acme.sh --install-cert -d example.com   --key-file       /etc/nginx/certs/example.com.key   --fullchain-file /etc/nginx/certs/example.com.pem   --reloadcmd      "nginx -s reload"

然后 Nginx 的 server 块里这样配:

server {
    listen 443 ssl;
    server_name example.com;

    ssl_certificate     /etc/nginx/certs/example.com.pem;
    ssl_certificate_key /etc/nginx/certs/example.com.key;

    # ...其他配置
}

为什么说 reloadcmd 是灵魂?acme.sh 官方文档的原话翻译过来大意是:证书可以自动续,但没有正确的 reloadcmd,新证书就不会刷进正在运行的 Nginx,你的网站会继续端着旧证书直到过期——续了等于白续。把这个参数写上,续期-部署-重载就真正成了无人值守的闭环。如果用 systemd,写成 systemctl reload nginx 也一样。

自动续期:装完就可以忘了它

到这里,每日 cron 会替你盯着所有证书。我在沙盒里手动跑了一次 acme.sh --cron,没有证书待续时它安静得像个合格的管家:

$ ~/.acme.sh/acme.sh --cron
[Fri Nov 6 07:27:27 CST 2026] ===Starting cron===
[Fri Nov 6 07:27:27 CST 2026] ===End cron===

续期策略默认是「每 30 天检查续一次」,并且已经跟进了 RFC 9773 的 ARI 机制:如果 CA 通过 renewalInfo 接口建议提前或延后续期(比如发生大规模吊销事件),acme.sh 会自动采纳 CA 建议的窗口期,还会在窗口内随机挑时间续,避免全球客户端挤同一秒打爆 CA。想知道某张证下次什么时候续:

acme.sh --info -d example.com
# 输出里的 Le_NextRenewTimeStr 就是下次续期时间

改了配置想立刻验证整条链路?强制续一次最快:

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

看到 nginx 被 reload、新证书就位,闭环就算验收通过了。

踩坑清单(都是文档里加粗写着的)

  • 忘配 reloadcmd:最常见的翻车点,证书续了但 Nginx 端着旧的,浏览器照样报过期;
  • DNS 用手动模式:每次续期都要人肉加 TXT 记录,通配符党务必走 DNS API 模式;
  • 默认 CA 是 ZeroSSL 不是 Let's Encrypt:两家都免费、都够用,但如果你就是想换:acme.sh --set-default-ca --server letsencrypt(我用 --help 实测确认过参数);
  • 80 端口不通导致 webroot 验证失败:云服务器记得在安全组放行 80,或干脆改走 DNS API。

写在最后

证书寿命从 398 天到 200 天再到规划中的 47 天,行业方向很明确:短寿命 + 自动化才是安全的常态,靠人肉记忆续期的时代正在终结。acme.sh 这类工具的价值就在于把这件每年重复 N 次的苦差事压成一次性的配置成本——一行安装、一条签发命令、一个 reloadcmd,之后就可以彻底忘了它的存在。

如果你的服务器上还躺着一张手动申请的证书,趁下一个到期日之前,把这条自动化流水线搭起来吧。

以上内容为 GLM 5.3 Agent 整合定时发布。

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!

手动续期 SSL 证书可以退休了:acme.sh 实战,证书砍到 47 天也不怕
/archives/tech-blog-2026-11-06
作者
番茄酱唉
发布于
2026-11-06
许可协议
CC BY-NC-SA 4.0

评论

欢迎来到我的博客!