宝塔 SSL 证书自动续期怎么配?7 步实操、真实报错排查与 acme.sh 备选方案
宝塔 SSL 证书自动续期不是证书自身行为,而是由面板计划任务每天调用 /www/server/panel/script/remind_ssl.py,在证书剩余有效期 ≤30 天时向 Let's Encrypt 重新签发 90 天新证书,前提是 crond 正常运行、80 端口可被外网访问、面板 Python 环境完好。 最快验证命令:openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -dates 看 notAfter,再 tail -n 50 /www/server/cron/.log 看是否有续签记录。 手动补一次续期:/www/server/panel/pyenv/bin/python3 /www/server/panel/script/remind_ssl.py;失败细节写在 /www/server/panel/logs/error.log 里。 Let's Encrypt 频率限制要记住:每注册域名每周 50 张、同一组域名每周 5 张重复证书、验证失败每小时 5 次,出现 too many failed authorizations 需停 1 小时再试。 面板内置续期不可控时,用 acme.sh v3.0.9+ 接管,默认 60 天续期,--reloadcmd 中执行 /www/server/nginx/sbin/nginx -t && /www/server/nginx/sbin/nginx -s reload,证书仍写回宝塔目录即可与面板共存。
为什么宝塔面板的 SSL 证书会「自动过期」?先看 6 个根本原因
直接回答:宝塔本身不会「续期失败」,绝大多数过期是续期链条上的某一环断了而你收不到告警。Let’s Encrypt 免费证书只有 90 天寿命,任何一个环节静默失效,站点都会在第 91 天挂掉。下面 6 个原因按发生频率排序。
- 90 天是硬期限,不是宝塔的设定。据 CA/Browser Forum Baseline Requirements 与 Let’s Encrypt 官方文档,免费 DV 证书
notAfter固定为签发后 90 天;Let’s Encrypt 建议在剩余 30 天(约 1/3 寿命)时续期,宝塔的remind_ssl.py也按≤30天这个阈值判断。先自己确认剩余天数:
# 查看线上证书的实际有效期,域名换成你的
echo | openssl s_client -servername example.com -connect example.com:443 2>/dev/null
| openssl x509 -noout -subject -dates
# 输出示例:
# subject=CN = example.com
# notBefore=Mar 1 00:00:00 2025 GMT
# notAfter=May 30 00:00:00 2025 GMT ← 相差 90 天,不是 365 天
- 续期靠 crontab 驱动,证书自己不会「续」。创建证书时宝塔会写入一条计划任务,执行
/www/server/panel/pyenv/bin/python3 /www/server/panel/script/remind_ssl.py。任务被误删、周期被改成「每月」、服务器迁移后 crontab 未恢复,都会导致静默过期。检查命令:
crontab -l | grep -i ssl
# 正常(宝塔 9.x 默认每天执行一次):
# 30 1 * * * /www/server/panel/pyenv/bin/python3 /www/server/panel/script/remind_ssl.py
# 异常:输出为空,或周期写成 0 3 1 * *(每月 1 号才跑一次)
- 「日志每天没动静」其实是正常现象。脚本每天跑一次,但只有剩余天数 ≤30 天才真正发起 ACME 请求,所以一张 90 天证书大约每 60 天才出现一条续签成功记录。别把「日志空」当成故障信号,要盯的是剩余天数。
- HTTP-01 验证依赖 80 端口可达。Let’s Encrypt 会请求
http://example.com/.well-known/acme-challenge/<token>。安全组只放行 443、Nginx 对该路径 301 强跳后目标仍返回 404、或 CDN 回源屏蔽了/.well-known/,都会让验证失败。自测方法:
curl -I http://example.com/.well-known/acme-challenge/probe-test
# 期望:HTTP/1.1 404 Not Found(路径可达、文件不存在即为正常)
# 异常:连接超时,或 301 到 https 后仍 404/403 —— 续期必失败
- 出站网络受限会静默失败。国内部分 IDC 到
acme-v02.api.letsencrypt.org:443出站不稳定,脚本捕获异常后只写日志、不告警。真实报错长这样:
curl -sS -o /dev/null -w '%{http_code} %{time_total}sn'
--connect-timeout 8 https://acme-v02.api.letsencrypt.org/directory
# 正常:200 0.8s
# 异常:curl: (7) Failed to connect to acme-v02.api.letsencrypt.org port 443 after 8001 ms: Connection timed out
- 面板版本与 Python 环境差异。7.x 早期版本的 SSL 模块存在续期漏写 bug,8.x 重写了证书模块,9.x 行为更稳定;若执行过
bt 16修复或更换过 pyenv,脚本路径可能失效。
| 面板版本 | 证书模块行为 | 自动续期注意点 |
|---|---|---|
| 7.4 及更早 | 旧 SSL 逻辑,续期任务偶发漏写 | 建议升级或 bt 16 修复后复查 crontab |
| 8.x | 重写证书模块,统一走 remind_ssl.py |
迁移服务器后必须确认任务已恢复 |
| 9.2.0(当前稳定版) | 续期失败有分级日志与面板提示 | 仍需自行监控 443 出站与 80 入站 |
换句话说,宝塔的「自动续期」= 90 天证书 + 每日 crontab + 剩余 30 天阈值 + 80 端口验证 + 443 出站。这五者任一断裂,表现都是「某天突然过期」。据 Mozilla Server Side TLS 指南,生产环境应把证书剩余有效期纳入监控指标,而不是依赖 CA 的邮件提醒——邮件常常进了垃圾箱。
宝塔 SSL 证书自动续期的完整操作步骤(7 步)
宝塔ssl证书自动续期的七步里,真正容易卡住的只有三处:面板任务没写进系统 crontab、验证路径被 301 跳转吃掉、续期成功后进程没 reload。下面每一步都给出可复制的命令和默认值,照着做一遍即可定位断点。
-
确认面板版本与证书状态。登录面板,右上角版本号建议 ≥ 9.0(8.x 的证书路径为
/www/server/panel/vhost/cert/<域名>/,9.x 沿用同一路径)。在「网站 → 站点 → SSL」确认颁发者为 Let’s Encrypt、到期时间落在 30 天内,再用命令核对磁盘上的实际文件:openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -issuer -dates # 输出示例(R11 是 Let's Encrypt 的中间证书 CN) # issuer=C = US, O = Let's Encrypt, CN = R11 # notBefore=Jun 1 00:00:00 2025 GMT # notAfter=Aug 30 23:59:59 2025 GMT -
检查计划任务是否存在。进入「计划任务」,类型选「Shell 脚本」,找名称含「SSL 自动续签」的任务,确认状态为「启用」、周期为「每天」,记下列表第一列那串 32 位任务 ID(后续查日志要用)。若该任务被删除,面板不会自动重建,这是「宝塔ssl证书自动续期」失效最常见的原因。
-
确认 crond 在跑。面板任务最终靠系统 cron 拉起,服务停了任务就是死的:
systemctl status crond --no-pager | head -3 # Ubuntu/Debian 用 systemctl status cron # 期望输出:Active: active (running) crontab -l | grep -c "/www/server/cron/" # 返回值应 ≥1;返回 0 说明面板任务未写入系统 crontab,重存一次任务即可 -
手动触发一次。在计划任务列表点「执行」,或直接跑:
/www/server/panel/pyenv/bin/python3 /www/server/panel/script/remind_ssl.py证书尚未进入 30 天窗口时脚本会跳过并返回成功,属预期行为,不会消耗 Let’s Encrypt 的签发配额。据 Let’s Encrypt 官方文档,同一注册域名每周签发上限为 50 张(Certificates per Registered Domain),盲目重试才会踩限。
-
放行验证路径。编辑
/www/server/panel/vhost/nginx/<域名>.conf,确保 acme-challenge 段落位于return 301之前且段内无跳转,否则 HTTP-01 校验会拿到 301 而失败:location ^~ /.well-known/acme-challenge/ { default_type "text/plain"; root /www/wwwroot/example.com; # 与站点根目录一致 try_files $uri =404; }云服务器安全组需放行入方向 80/TCP(源 0.0.0.0/0)。放行后用
curl -I http://example.com/.well-known/acme-challenge/test验证返回 404 而不是 301/403。典型失败报错为:Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404或urn:ietf:params:acme:error:unauthorized。 -
确认续期后会 reload。宝塔内置续签成功后自动写回证书文件并 reload Nginx;若改用 acme.sh 接管,必须显式加
--reloadcmd,否则文件更新而进程仍持有旧证书,浏览器看到的还是过期证书。acme.sh --install-cert -d example.com --key-file /www/server/panel/vhost/cert/example.com/privkey.pem --fullchain-file /www/server/panel/vhost/cert/example.com/fullchain.pem --reloadcmd "nginx -t && nginx -s reload" # 缺少此行 = 续期无效 -
加一层监控兜底。在「计划任务」新建每天 09:00 执行的 Shell 脚本,读取 notAfter 判断剩余天数:
#!/bin/bash # /www/server/panel/script/check_ssl_expiry.sh CERT="/www/server/panel/vhost/cert/example.com/fullchain.pem" END=$(date -d "$(openssl x509 -in "$CERT" -noout -enddate | cut -d= -f2)" +%s) LEFT=$(( (END - $(date +%s)) / 86400 )) [ "$LEFT" -lt 15 ] && echo "SSL 剩余 ${LEFT} 天:$CERT" | mail -s "SSL 告警" ops@example.com exit 090 天有效期减去 30 天续签窗口,意味着从首次失败到真正过期还有约 60 天、至少 3 次重试机会——前提是告警能送到人手上。
| 对比项 | 宝塔内置续签 | acme.sh 接管 |
|---|---|---|
| 触发者 | 面板计划任务「SSL 自动续签」 | acme.sh 自建 crontab(acme.sh --install-cronjob,每日随机分钟执行) |
| 续签窗口 | 到期前 30 天 | 默认到期前 60 天,可用 --days 调整 |
| 证书落盘 | /www/server/panel/vhost/cert/<域名>/ |
--install-cert 指定路径 |
| Nginx 重载 | 自动 | 必须 --reloadcmd |
| 排错日志 | 计划任务执行日志 | ~/.acme.sh/acme.sh.log |
两种方式不要同时启用:内置任务与 acme.sh 各自续签会互相覆盖 fullchain.pem,并可能触发 Let’s Encrypt 的重复签发限制。选定其一后,把另一方的 crontab 条目注释掉。
配置与命令示例:计划任务、remind_ssl.py、acme.sh 接管脚本
问:宝塔面板自己写进去的续期任务到底长什么样,怎么看它有没有跑?
在面板「网站 → SSL → Let’s Encrypt」里申请证书时,宝塔会往系统 crontab 里写一条以哈希值命名的任务,实际执行的是 /www/server/cron/ 下的同名脚本(内部会调用 remind_ssl.py 做到期检查)。先确认这条任务是否还在:
# 查看宝塔写入的 SSL 续期任务;任务脚本名是 32 位哈希,grep 不到时改用 ls 逐个看
crontab -l | grep -i ssl
# 典型输出:
# 0 0 * * * /bin/bash /www/server/cron/3f8a1c9d2e4b5a6c7d8e9f0a1b2c3d4e >> /www/server/cron/3f8a1c9d2e4b5a6c7d8e9f0a1b2c3d4e.log 2>&1
# 按修改时间倒序找最新的任务脚本和日志
ls -lt /www/server/cron/ | head -5
# 查看最近一次执行的输出,报错都在这里
tail -n 50 /www/server/cron/3f8a1c9d2e4b5a6c7d8e9f0a1b2c3d4e.log
若 crontab -l 里已无对应行,说明任务被删(常见于面板重装、手动清理 crontab),此时面板不会再自动续期,只能靠下面的 acme.sh 或 certbot 接管。
问:怎么直接验证证书还剩多少天?
# 读取宝塔存放证书的固定路径,一次看到主体、签发者与起止时间
openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem
-noout -subject -issuer -dates
# 典型输出:
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R11
# notBefore=Oct 31 07:59:59 2025 GMT
# notAfter=Jan 30 07:59:59 2026 GMT
据 Let’s Encrypt 官方公告,R11 是 2024 年起启用的 RSA 中间证书;若 issuer 仍显示 CN = R3,说明这张证书签发较早,链上中间证书已过时,建议立即重签。命令语法参见 OpenSSL 文档 x509(1) 手册页。
问:想用 acme.sh 接管,完整命令序列是什么?
# 1) 安装 acme.sh(v3.0.9+),安装器会自动写入 cron
curl https://get.acme.sh | sh -s email=ops@example.com
# 2) 切换默认 CA 为 Let's Encrypt(新版本默认已是 ZeroSSL,必须显式指定)
/root/.acme.sh/acme.sh --set-default-ca --server letsencrypt
# 3) Webroot 方式签发,ECDSA P-256 证书;泛域名需改用 --dns dns_ali 等 DNS API
/root/.acme.sh/acme.sh --issue -d example.com -d www.example.com
-w /www/wwwroot/example.com --keylength ec-256
# 4) 写回宝塔目录并让 Nginx 重载;--ecc 必须与 ECDSA 证书配套,RSA 证书要去掉
/root/.acme.sh/acme.sh --install-cert -d example.com --ecc
--key-file /www/server/panel/vhost/cert/example.com/privkey.pem
--fullchain-file /www/server/panel/vhost/cert/example.com/fullchain.pem
--reloadcmd "/www/server/nginx/sbin/nginx -t && /www/server/nginx/sbin/nginx -s reload"
# 5) 核对自动续期:cron 条目与下次续期时间
crontab -l | grep acme.sh
# 0 0 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null 2>&1
/root/.acme.sh/acme.sh --list
acme.sh 的 --cron 默认在剩余 60 天时触发续期(--days 60,可调 1–89),--list 输出的 Next renew 列即依据此阈值计算。签发与续期协议遵循 RFC 8555(ACME)。
问:不想装 acme.sh,certbot 怎么用?
# Ubuntu 22.04:Nginx 插件会自动改配置并 reload
apt install -y certbot python3-certbot-nginx
certbot --nginx -d example.com -d www.example.com
# 续期由 systemd timer 驱动,每天两次
systemctl list-timers | grep certbot
# 不消耗 Let's Encrypt 配额(每周 50 张/域名)地完整演练续期
certbot renew --dry-run
| 方案 | 续期触发者 | 默认续期阈值 | 适用场景 |
|---|---|---|---|
| 宝塔内置(remind_ssl.py) | 面板写入的 crontab 任务,每日 00:00 | 到期前约 30 天 | 证书由面板签发、不想引入额外工具 |
| acme.sh | 自带 cron,每日 00:00 | --days 60(可调) |
多域名、泛域名、需 DNS API 验证 |
| certbot | systemd timer certbot.timer,每天两次 |
到期前 30 天 | Ubuntu/Debian 原生生态、纯 Nginx 站点 |
三者不要同时启用:同一域名被两套工具轮番重签,容易触发 Let’s Encrypt 的重复证书限流(同一组精确域名每周 5 张)。接管前先删掉旧方案的 crontab 行或
systemctl disable --now certbot.timer。
方案选型对比:宝塔内置续签 / acme.sh / certbot / 付费证书怎么选
先说结论:四类方案的差别不在“能不能续期”,而在续期窗口和证书写入磁盘的路径:前者决定你有多长的故障缓冲期,后者决定多套工具会不会互相覆盖。把这两点想清楚,宝塔ssl证书自动续期就能做成可观测、可回滚的流程,而不是“某天早上突然全站 HTTPS 报错”。
| 方案 | 续期触发方式 | 默认续期窗口 | 证书存放路径 | 适用场景 | 成本区间 |
|---|---|---|---|---|---|
| 宝塔内置 Let’s Encrypt | 面板计划任务每日调用 remind_ssl.py |
剩余 ≤ 30 天 | /www/server/panel/vhost/cert/<域名>/ |
单机、站点数 < 50、只用面板运维 | 0 元 |
| acme.sh v3.0.9+ | crontab 每天 0 点执行 --cron |
剩余 60 天(--days 可调) |
/root/.acme.sh/<域名>/ |
DNS-01 泛域名、多机批量、对接阿里云/腾讯云 DNS API | 0 元 |
| certbot 2.x / 3.x | systemd timer 驱动,每天两次 | 剩余 30 天 | /etc/letsencrypt/live/<域名>/ |
Debian/Ubuntu 原生生态、习惯 systemd 排障的团队 | 0 元 |
| 付费商业证书(DV/OV) | 无自动续期,到期前人工重签替换 | 无(建议到期前 30 天操作) | 由服务商决定 | 需要 OV 组织验证、合规审计、内网策略限制免费 CA | DV 200–800 元/年;OV 800–3000 元/年;通配符 DV 800–2000 元/年 |
宝塔内置方案的执行过程与手动验证方式。面板的续签逻辑并不神秘:每天由 cron 调用 remind_ssl.py 扫描站点证书,剩余有效期 ≤ 30 天时重新申请。这与 Let’s Encrypt 官方文档中“官方客户端在证书剩余 30 天时触发续期”的建议窗口一致。想确认任务是否真的在跑,不要只看面板 UI:
# 手动触发一次续签扫描(等价于每日计划任务的行为),观察输出
btpython /www/server/panel/class/remind_ssl.py
# 查看最近执行过的 cron 脚本及其日志(文件名即任务 ID)
ls -lt /www/server/cron/ | head -20
# 直接翻续签相关记录,失败原因通常只写在这里,不会弹告警
grep -iE "ssl|acme|cert|error" /www/server/cron/*.log | tail -50
它的短板也在这:失败静默。日志按任务 ID 分散在 /www/server/cron/ 下,没有邮件或 webhook 通知,只能靠你自己加监控。站点数量上到几十个之后,建议改用 acme.sh 统一管理。
acme.sh 的价值在于把“签发”和“分发”解耦。默认 --cron 在剩余 60 天时续期,窗口比宝塔宽一倍,留出的排障时间更充裕:
# 安装(v3.0.9+),安装器会自动写入 crontab:
# 0 0 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null
curl https://get.acme.sh | sh -s email=ops@example.com
# 用阿里云 DNS API 签发泛域名,--days 可把续期阈值改成 45 天
acme.sh --issue -d example.com -d '*.example.com' --dns dns_ali --days 45
# 关键:--install-cert 把证书分发到宝塔的读取路径,--reloadcmd 续期后自动重载 Nginx
acme.sh --install-cert -d example.com
--key-file /www/server/panel/vhost/cert/example.com/privkey.pem
--fullchain-file /www/server/panel/vhost/cert/example.com/fullchain.pem
--reloadcmd "nginx -t && nginx -s reload"
# 验证当前阈值与 cron 是否生效
acme.sh --cron --home /root/.acme.sh --days 45
crontab -l | grep acme.sh
certbot 靠 systemd timer,不是 cron。Ubuntu/Debian 上 certbot.timer 每天 00:00 与 12:00 各触发一次,certbot renew 只在剩余 30 天内才真正签发,所以高频触发并不浪费配额:
systemctl list-timers | grep certbot # 确认 certbot.timer 处于 active
certbot renew --dry-run # 演练,不消耗 Let's Encrypt 速率限制
ls -l /etc/letsencrypt/live/example.com/ # fullchain.pem / privkey.pem 均为软链接
混用两套工具最典型的后果是互相覆盖,并触发 Let’s Encrypt 的速率限制。真实报错长这样:
Error creating new order :: too many certificates (5) already issued for this exact set of domains in the last 168 hours
或 Nginx 直接起不来:PEM_read_bio_X509_AUX() failed (SSL: error:0480006C:PEM routines::no start line)——通常是 certbot 与宝塔同时往同一路径写入,一方写了privkey.pem而另一方只更新了fullchain.pem。原则:同一个域名只允许一个客户端持有私钥。
趋势提醒:自动化续期正在从“可选项”变成“必选项”。CA/B Forum 已通过 SC-081 决议,公开信任证书的最长有效期将分三步收紧:2026-03-15 降至 200 天、2027-03-15 降至 100 天、2029-03-15 降至 47 天。对使用付费 DV/OV 证书的团队意味着手工替换频率从“一年一次”变成“两个月一次甚至更短”,因此把宝塔ssl证书自动续期交给脚本,比继续人工换证书更省事也更安全。
常见报错与排查:这 6 条报错信息你大概率会碰到
自动续期失败基本落在三类:出站网络不通、ACME 验证过不去、证书与私钥文件配不上。先看速查表定位,再按条目执行命令——绝大多数情况不需要删证书重签。
| 报错关键字 | 根因 | 一线处置 | 是否必须等待 |
|---|---|---|---|
| curl: (7) Connection timed out | 出站 443 被限 / DNS 异常 | 改 DNS-01 验证 | 否 |
| too many failed authorizations | 触发失败验证速率限制 | 修好 80 端口后停手 | 是,约 1 小时 |
| DNS problem: NXDOMAIN | 解析未生效或 A 记录错机 | dig 比对公网 IP | 是,等 TTL |
| key values mismatch | 证书与私钥不配对 | 比对 modulus | 否 |
| Problem binding to port 80 | standalone 抢端口失败 | 换 webroot / nginx 模式 | 否 |
| AttributeError: ‘NoneType’ | 面板 Python 环境或缓存损坏 | bt 菜单修复面板 | 否 |
1. curl: (7) Failed to connect to acme-v02.api.letsencrypt.org port 443: Connection timed out
先分辨是 DNS 还是出站封禁:握手到 SSL connection using TLSv1.3 说明网络通,卡在 Connected 之前则是 443 出站被限。注意 ACME 目录地址由 RFC 8555 §7.1 规定,换 --server 指向同一地址毫无意义,应整体切到 DNS-01。
# 判断卡在哪一步:DNS 解析 / TCP 连接 / TLS 握手
curl -vI https://acme-v02.api.letsencrypt.org/directory 2>&1 |
grep -E "Could not resolve|Connected|SSL connection"
# 切 DNS-01 验证,绕开 80 端口回源(阿里云 DNS 示例)
export Ali_Key="LTAI5t***"
export Ali_Secret="***"
/root/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'
2. Error creating new order :: too many failed authorizations recently
据 Let’s Encrypt 速率限制文档,同一账户对同一主机名每小时最多 5 次验证失败,超限后继续重试只会不断刷新计时窗口。停手,先确认挑战路径可访问,再等 1 小时滚动窗口过去。
- 服务器维护 · 网站代维护 · 服务器托管代维
- APP/小程序 HTTPS · SSL网站加密证书 · CA证书配置
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
# 先确认 80 端口与 .well-known 可达,再发起申请
curl -I http://example.com/.well-known/acme-challenge/test.txt
3. DNS problem: NXDOMAIN looking up A for example.com
解析未生效,或 A 记录指向了别的机器。用公共 DNS 比对服务器公网 IP,新记录建议等 TTL(常见 600s)过期后再申请,否则验证节点仍读到旧缓存。
dig +short example.com @8.8.8.8
curl -s https://api.ipify.org; echo # 本机公网出口,两者必须一致
4. nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:X509_check_private_key:key values mismatch)
证书与私钥不配对,多因续期时只替换了其中一个文件,或 acme.sh 与宝塔面板同时写同一目录。按 OpenSSL 文档,两文件的 modulus 摘要必须完全一致。
cd /www/server/panel/vhost/cert/example.com
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in privkey.pem | openssl md5
# 两行输出不同 → 用同一份 fullchain.pem + privkey.pem 成对覆盖
5. Failed to renew certificate example.com with error: Problem binding to port 80: Could not bind to IPv4 or IPv6
certbot 的 standalone 模式要独占 80 端口,而 Nginx 已占用。不要为续期停站点,改用 webroot 或 nginx 插件。
certbot renew --webroot -w /www/wwwroot/example.com
# 或:certbot renew --nginx
6. 面板任务日志出现 AttributeError: ‘NoneType’ object has no attribute ‘get’,或 remind_ssl.py 直接退出
这是面板 Python 环境或配置缓存损坏,与证书本身无关。SSH 执行 bt,在菜单里选「修复面板」(各版本编号不同,以菜单文字为准),修复后重跑一次续期脚本,同时盯住错误堆栈。
bt # 菜单中选「修复面板」
tail -f /www/server/panel/logs/error.log # 另开窗口观察堆栈
怎么确认自动续期真的生效?5 种验证方法
为什么”配好了”不等于”续成功了”?
宝塔面板的计划任务返回码为 0,并不代表证书真的换了——它只说明脚本跑完了。据 Let’s Encrypt 文档,证书有效期 90 天,官方建议在剩余 30 天内完成续期;宝塔的”续签 Let’s Encrypt 证书”任务(7.7 及以上版本内置,8.x 路径不变)默认每日检查一次,剩余约 30 天时触发,acme.sh 3.x 则默认 --days 60 后才自动续期,certbot 默认剩余 30 天。验证必须落到文件、服务、日志、公网、演练五个层面,缺一层就可能出现”磁盘上新、线上还是旧”的静默故障。
第 1 层:文件层——证书文件真的变了吗?
# 记录 notBefore / notAfter(OpenSSL 1.1.1 与 3.x 输出格式一致,RFC 5280 定义)
openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -dates
# notBefore=Jul 1 00:00:00 2025 GMT
# notAfter=Sep 29 23:59:59 2025 GMT ← 续期后此值应向后推进约 90 天
# 直接算剩余天数(依赖 GNU coreutils 的 date -d,CentOS 7+/Ubuntu 18.04+ 均可用)
echo $(( ( $(date -d "$(openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -enddate | cut -d= -f2)" +%s) - $(date +%s) ) / 86400 ))
续期前后各跑一次,notAfter 未变化即判定失败。剩余天数长期停在 60~90 天不动,说明续期任务根本没触发。
第 2 层:服务层——Nginx 加载的是新证书吗?
# 磁盘上的序列号
openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -serial
# 线上 443 实际返回的序列号;-servername 必须带,否则可能拿到默认站点的证书
echo | openssl s_client -connect 127.0.0.1:443 -servername example.com 2>/dev/null | openssl x509 -noout -serial -dates
两者序列号必须一致。不一致几乎只有一个原因:证书换了但 Nginx 没 reload。此时执行 /www/server/nginx/sbin/nginx -t && /www/server/nginx/sbin/nginx -s reload。若 nginx -t 报 nginx: [emerg] cannot load certificate "/www/server/panel/vhost/cert/example.com/fullchain.pem": BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory),则是续期脚本把文件删了却没写回,需检查磁盘空间与 /www/server/panel/vhost/cert/example.com/ 目录权限(默认 root:root,目录 755、私钥 600)。
第 3 层:日志层——脚本自己说了什么?
# 宝塔计划任务日志,任务 ID 在面板「计划任务」列表里看
tail -n 100 /www/server/cron/<任务ID>.log
grep -iE "success|renew|cert" /www/server/cron/<任务ID>.log
# 面板自身异常
tail -f /www/server/panel/logs/error.log
# acme.sh 方案:日志在 /root/.acme.sh/acme.sh.log
grep "renew" /root/.acme.sh/acme.sh.log | tail -n 20
日志里出现 Challenge failed、Timeout during connect 多为 80/443 端口被占用或 CDN 回源拦截;出现 too many failed authorizations 说明已触发 Let’s Encrypt 的失败验证频率限制(每小时每账号每域名 5 次)。
第 4 层:外部层——公网看到的是哪张证书?
curl -vI https://example.com 2>&1 | grep -E "expire date|issuer"
# 或在浏览器打开 https://crt.sh/?q=example.com ,CT 日志(RFC 6962)通常几分钟内出现新条目
curl -s "https://crt.sh/?q=example.com&output=json" | grep -o '"not_after":"[^"]*"' | tail -n 3
再用 SSL Labs(https://www.ssllabs.com/ssltest/)顺带确认链完整性与 OCSP Stapling 状态;据 Mozilla 服务器端 TLS 建议,链不完整会让部分安卓客户端直接握手失败,而这类问题在本地 openssl s_client 里往往看不出来。
第 5 层:演练式验证——主动跑一遍完整流程
# acme.sh:--force 强制重签,会真实消耗一次签发配额
/root/.acme.sh/acme.sh --renew -d example.com --force
# certbot:--dry-run 走 staging 环境,不消耗生产配额
certbot renew --dry-run
注意 Let’s Encrypt 的 Duplicate Certificate 限额为每注册域名每周 5 张,--force 不宜频繁使用;生产环境建议每季度演练一次,主要目的是确认 reload 命令、私钥权限和 crontab 里的 PATH 仍然有效。
| 验证层 | 核心命令 | 能证明什么 | 典型失败信号 |
|---|---|---|---|
| 文件层 | openssl x509 -noout -dates |
证书文件确实被替换 | notAfter 不变、剩余天数长期 >60 |
| 服务层 | s_client -servername 比对 -serial |
Nginx 已加载新证书 | 序列号不一致 |
| 日志层 | tail /www/server/cron/<ID>.log |
续期任务被调度并成功执行 | Challenge failed、端口占用 |
| 外部层 | curl -vI / crt.sh / SSL Labs |
公网视角与链完整性 | CT 无新条目、评级掉到 B |
| 演练层 | --force / certbot renew --dry-run |
流程与权限可复现 | reload 报 emerg、权限被改 |
泛域名、多站点、CDN 场景下的续期注意事项
泛域名证书为什么不能走「文件验证」?因为 HTTP-01 要求 CA 能从公网访问 http://<主机名>/.well-known/acme-challenge/<token>,而 *.example.com 本身不是可解析的主机名。据 Let’s Encrypt 官方文档《Challenge Types》,通配符证书只能用 dns-01 验证。宝塔面板的路径是:网站 → 站点 → SSL → Let’s Encrypt → 勾选域名后,把「验证方式」从默认的文件验证切换为DNS 验证,再选择服务商(阿里云 / 腾讯云 DNSPod / Cloudflare / 华为云)并填入 API 密钥。阿里云子账号只需授予 AliyunDNSFullAccess;密钥在面板数据库中明文存储,务必同时开启面板二次验证。用 acme.sh 时等价命令如下(适用 acme.sh 3.x,默认证书有效期 90 天,安装后自动写入 cron:0 0 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null):
export Ali_Key="LTAI5t********" # RAM 子账号 AccessKey
export Ali_Secret="****************"
~/.acme.sh/acme.sh --issue --dns dns_ali
-d example.com -d '*.example.com' # 通配符必须加单引号,防止 shell 展开
--keylength ec-256 # ECDSA P-256,默认是 2048 位 RSA
--dnssleep 120 # 阿里云解析 TTL 默认 600s,留足传播时间
多站点批量续期会不会撞配额?会。据 Let’s Encrypt《Rate Limits》,限制按「注册域名」而非主机名计算:
| 限制项 | 阈值 | 典型踩坑场景 |
|---|---|---|
| Certificates per Registered Domain | 每 7 天 50 张 | 50 个二级域名各签一张,一次批量续期即触顶 |
| Duplicate Certificate | 每 7 天 5 张(同一组域名) | 反复手动重签同一站点 |
| Failed Validations | 每主机名每小时 5 次 | DNS 未生效就重试 |
| New Orders | 每账户 3 小时 300 个 | 上千站点集中续期 |
把 50 个二级域名合并成一张 *.example.com 通配符证书,额度消耗降到 1/50,这是宝塔 SSL 证书自动续期在多站点场景下最省事的一步。
套了 CDN 为什么续期成功了浏览器还是旧证书?因为续期只改了源站文件,阿里云 CDN、腾讯云 EdgeOne、Cloudflare 的边缘节点仍持有旧证书副本。要么在续期后用云厂商 API 推送(阿里云 SetCdnDomainSSLCertificate、腾讯云 DeployCertificateInstance),要么改成「回源 HTTPS + 边缘自有证书」的分离策略,把边缘证书到期时间单独纳入监控——两侧证书的到期日通常不同步。
负载均衡后面挂了 3 台源站怎么办?要么每台都跑续期任务,要么一台集中签发后分发。set -e 保证任一节点失败即中断,避免出现「两台新、一台旧」:
#!/bin/bash
set -euo pipefail
D=example.com
for h in 10.0.1.11 10.0.1.12; do
scp -q /etc/nginx/ssl/$D.pem root@$h:/etc/nginx/ssl/$D.pem
ssh root@$h 'nginx -t && nginx -s reload' # 先测试再热加载,失败即退出
done
ssl_stapling 还要不要开?Let’s Encrypt 已公告自 2025 年 8 月 6 日起停止 OCSP 响应服务(据 Let’s Encrypt《Ending OCSP Support》),继续配置 ssl_stapling on; 会在 error.log 反复刷 OCSP responder timed out 或 "ssl_stapling" ignored, no OCSP responder URL in the certificate。建议先注释掉 ssl_stapling / ssl_stapling_verify,改用 ssl_crl 做吊销校验,注意这会带来额外的下载开销。
同一张证书被 Postfix、Dovecot、MySQL 复用呢?只 reload Nginx 远远不够。把这些命令用 && 串进 acme.sh 的 --reloadcmd,任一失败即中断并由 cron 邮件告警:
~/.acme.sh/acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.pem
--reloadcmd "systemctl reload nginx && systemctl reload postfix && systemctl restart dovecot && mysql -e 'ALTER INSTANCE RELOAD TLS'"
其中 ALTER INSTANCE RELOAD TLS 需 MySQL 8.0.16+(MariaDB 无此语法,只能 systemctl restart mariadb),执行前确认已设置 ssl_cert / ssl_key 指向新文件。
宝塔的续期脚本每天运行一次,只在证书剩余有效期 ≤30 天时真正发起续签,因此 90 天的 Let's Encrypt 证书大约每 60 天续一次。只要「SSL 自动续签」计划任务处于启用状态、crond 在运行、80 端口可被外网访问,就不会漏;三者任一失效都会静默失败,建议额外加一条剩余天数
按出现频率排序:一是 80 端口未放行或 .well-known/acme-challenge 路径被强制跳转 HTTPS 拦截,报 404/超时;二是出站访问 acme-v02.api.letsencrypt.org 超时,报 curl: (7) Connection timed out;三是反复重试触发每小时 5 次的失败验证限制,报 too many failed authorizations recently。前两种修配置,第三种只能等 1 小时。
单机、站点少时宝塔内置够用,成本为零且无需记命令;需要泛域名、多机分发、失败告警时 acme.sh 更可控,它的 –reloadcmd 和 –install-cert 能把「签发—写入—reload」串成一条链路。两者可以共存,但不要同时写同一份证书文件:建议用 acme.sh 接管后,在宝塔计划任务里把「SSL 自动续签」停用,证书仍写回 /www/server/panel/vhost/cert//,面板界面照常显示到期时间。
能,但必须用 DNS-01 验证。宝塔在申请时选择「DNS 验证」并填入云厂商 API 密钥(支持阿里云、腾讯云 DNSPod、Cloudflare 等),续期脚本会调用同一套 API 自动添加 TXT 记录。如果面板版本较旧或云厂商不在支持列表,改用 acme.sh 的 –dns dns_ali / dns_dp 插件更稳妥。
先比对序列号:openssl x509 -in fullchain.pem -noout -serial 与 echo | openssl s_client -connect 127.0.0.1:443 -servername 域名 2>/dev/null | openssl x509 -noout -serial。不一致说明 Nginx 没 reload,执行 /www/server/nginx/sbin/nginx -t && /www/server/nginx/sbin/nginx -s reload;一致但浏览器仍显示旧证书,多半是 CDN 边缘缓存或本地浏览器会话缓存,需要到 CDN 控制台更新证书并强制刷新。
有,且不会拉黑但会临时拒绝。据 Let's Encrypt 官方文档,限制包括每注册域名每周 50 张证书、同一组域名每周 5 张重复证书、验证失败每小时 5 次、新订单每账户每 3 小时 300 个。触顶后报 rateLimited 或 too many failed authorizations,等待窗口滚动即可恢复,不需要换域名或换账号。
重装面板会重建 crontab,原任务通常丢失,但证书文件若保留在 /www/server/panel/vhost/cert/ 下仍可继续使用直到到期。迁移服务器后建议执行 crontab -l | grep "/www/server/cron/" 确认任务存在,再手动跑一次 /www/server/panel/pyenv/bin/python3 /www/server/panel/script/remind_ssl.py 验证脚本路径与权限,最后检查安全组 80 端口是否放行。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。