登录
首页 >  文章 >  php教程

宝塔SSL证书过期怎么更新?教程详解

时间:2026-04-13 20:28:28 483浏览 收藏

宝塔面板SSL证书自动续签失效并非小概率事件,而是常因计划任务丢失、HTTP验证通道受阻(如CDN或端口封锁)、Nginx未重载新证书或ACME缓存损坏等隐蔽原因导致“静默过期”——看似续签成功,浏览器却仍在使用过期证书。本文直击四大核心故障场景,手把手教你快速定位并修复:找回/重建每日续签计划任务、切换至更稳定的DNS验证模式、强制校验并重启Web服务确保证书生效、清理损坏缓存重建ACME索引,并给出带安全校验的增强型自动脚本,助你彻底告别证书过期引发的HTTPS中断与安全警告。

宝塔面板SSL证书过期如何更新_设置自动续签避免服务中断

自动续签脚本失效,先看计划任务有没有被删

宝塔的自动续签不是后台常驻服务,而是靠计划任务每天调用一次 /www/server/panel/pyenv/bin/python /www/server/panel/class/acme_v2.py --renew=1。如果这个任务没了,证书就彻底“静默过期”。常见情况是手动清空过计划任务、面板升级后重置配置、或误点删除。

  • 登录宝塔 → 【计划任务】→ 搜索“SSL”或“Let’s Encrypt”,没结果就是丢了
  • 新建任务:类型选【Shell脚本】,周期设【每天】,脚本内容严格复制上面那条命令(注意路径里是 python,不是 python3
  • 别用 python3 替代,/www/server/panel/pyenv/bin/python 是宝塔专用环境,混用会报 ModuleNotFoundError: No module named 'requests' 类错误
  • 添加后点【执行一次】,立刻看日志里有没有 |- 开始续签域名续签成功 字样

手动续签失败?重点查验证通道是否通

Let’s Encrypt 续签卡在“验证失败”,90% 是因为 HTTP-01 挑战走不通——比如你开了 CDN、用了 NAT、80 端口被封,或者 DNS 解析还没切到当前服务器。这时候不能硬等自动任务,得切 DNS-01 验证。

  • 进网站 → 【SSL】→ 【Let’s Encrypt】→ 点【设置】→ 把验证方式从“文件验证”改成“DNS 验证”
  • 选好你的云厂商(阿里云、腾讯云等),填入 API Key 和 Secret,保存后重新申请一次证书
  • DNS 验证不依赖 80 端口,全程后台加删 _acme-challenge TXT 记录,更适合自动续签
  • 如果之前手动改过 TXT 记录,去 DNS 控制台清掉所有以 _acme-challenge 开头的残留条目,否则新验证会超时

续签成功但 HTTPS 还报错?证书没 reload

宝塔脚本执行完续签后会尝试重载 Nginx/Apache,但这步可能静默失败——比如配置语法有错、Nginx 进程卡死、或磁盘满导致 reload 被跳过。浏览器看到的还是旧证书,但日志里却显示“续签成功”。

  • 每次续签后,手动执行 nginx -t 确认配置语法正确,再 bt restart nginx 强制重启
  • 在计划任务脚本末尾追加检查逻辑,例如:
    /www/server/panel/pyenv/bin/python /www/server/panel/class/acme_v2.py --renew=1 && nginx -t && bt restart nginx
  • 别信“续签成功”就万事大吉,打开浏览器访问 https://你的域名,点地址栏锁图标看证书有效期是否已更新

证书突然全不续了?ACME 缓存和订单状态坏了

当多个站点一起续签失败,且日志里没有具体域名报错,大概率是 acme_v2.py 的缓存索引损坏了——比如删过网站但没清理对应证书配置,或 orders 缓存文件写坏,导致脚本直接跳过所有待续签项。

  • 先停面板:bt stop
  • 备份证书配置:cp -r /www/server/panel/vhost/cert/ /www/backup/cert_$(date +%s)
  • 删掉 ACME 缓存目录:rm -rf /www/server/panel/vhost/letsencrypt
  • 重启面板:bt start,再手动点一次某个网站的【续签】,让脚本重建缓存
  • 之后再跑自动任务,通常就能恢复识别所有待续签域名

最麻烦的不是续不上,而是续上了却没生效——reload 失败、Nginx 没加载新证书、CDN 还缓存着旧证书。建议把 bt restart nginx 加进自动脚本,并每周手动抽查一次证书实际有效期。

以上就是本文的全部内容了,是否有顺利帮助你解决问题?若是能给你带来学习上的帮助,请大家多多支持golang学习网!更多关于文章的相关知识,也可关注golang学习网公众号。

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>