宝塔面板 SSL 证书服务实战:一键申请、第三方证书部署、自动续签与报错排查
一、问题背景与根因:宝塔站点为什么会“突然不安全”
宝塔面板的“SSL 证书服务”本身不是 CA,它把 CSR 生成、域名验证(HTTP-01 / DNS-01)、证书签发、私钥托管、Nginx/Apache reload 这一整套流程封装成图形界面,底层调用 acme.sh(对接 Let’s Encrypt、ZeroSSL)以及商业 CA 的代理商 API。证书默认落在 /www/server/panel/vhost/cert/站点名/。
站点掉 HTTPS,90% 是以下三个根因之一:
- 有效期不断缩短。按 CA/Browser Forum 规定,2020-09-01 起公开信任的 TLS 证书最长有效期已降为 398 天;SC-081 已排期进一步压缩:2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天。Let’s Encrypt 则固定 90 天,并在 2025 年起提供 6 天有效期的 shortlived 配置。不配置自动续签,证书必然过期。
- 证书链不完整。只部署站点证书、没带中间证书。桌面 Chrome 能靠 AIA 抓取补齐,Android WebView、Java 客户端、微信小程序会直接握手失败。
- 验证通道被堵。80 端口被 CDN 回源、云安全组、伪静态规则或防盗链拦截,HTTP-01 校验返回 404,签发失败。
典型故障表现:浏览器 NET::ERR_CERT_DATE_INVALID、小程序 request:fail ssl hand shake error、Nginx 访问日志出现 495 状态码、支付回调验签失败。下面按“检查 → 签发 → 部署 → 加固 → 续签 → 排错 → 验证”的顺序给出可直接执行的方案,环境为宝塔面板 9.x + Nginx 1.24/1.26 + OpenSSL 3.x。
二、完整实操(一):前置检查与面板 / acme.sh 签发
点“申请”之前先过 5 项硬指标,能省掉大部分重试(Let’s Encrypt 对同一域名每小时最多 5 次失败校验,超限要等 1 小时)。
1)解析与端口
dig +short example.com A
dig +short www.example.com A
dig +short AAAA example.com # 有 AAAA 记录时必须保证 IPv6 也可达
ss -lntp | grep -E ':80|:443'
firewall-cmd --permanent --add-service=http --add-service=https && firewall-cmd --reload # CentOS/AlmaLinux
ufw allow 80,443/tcp && ufw status numbered # Ubuntu/Debian
云服务器还需在控制台安全组放行 80、443 入方向。
2)时间同步(ACME 的 JWS 请求带时间戳,偏差超过 5 分钟会报 nonce 无效或签名失败)
timedatectl set-ntp true
chronyc tracking | head -3
3)验证目录可公开访问
mkdir -p /www/wwwroot/example.com/.well-known/acme-challenge
echo ok > /www/wwwroot/example.com/.well-known/acme-challenge/test
curl -s http://example.com/.well-known/acme-challenge/test # 必须返回 ok
返回 404 时依次检查:站点根目录是否指向正确、伪静态规则是否吞掉了该路径、面板“防跨站攻击(open_basedir)”开关、CDN 是否缓存了 404。
路径 A:面板一键申请。进入 网站 → 站点 → 设置 → SSL → Let's Encrypt,勾选主域名与 www,验证方式选“文件验证”;泛域名必须选“DNS 验证”并填写云厂商 API 密钥(如阿里云 Ali_Key / Ali_Secret)。签发成功后打开“强制 HTTPS”。
路径 B:acme.sh 命令行(可脚本化、可批量):
curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com -w /www/wwwroot/example.com --keylength ec-256
export Ali_Key="LTAI5t******" Ali_Secret="******"
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'
签发成功后安装到面板统一目录并绑定 reload 钩子:
~/.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 "nginx -t && nginx -s reload"
要点:--keylength ec-256 生成 ECDSA 证书,体积小、握手快,TLS 1.3 首选;证书路径必须用 fullchain 而不是 cert.pem;reloadcmd 里先 nginx -t 再 reload,避免配置有误把站点打成 502。
三、完整实操(二):第三方证书导入、CSR 与证书链合并
从云厂商或商业 CA 购买的证书需要手工落到面板。先在服务器上生成私钥与 CSR(私钥绝不外传):
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/ST=Guangdong/L=Shenzhen/O=Example Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
把 example.com.csr 的内容提交给 CA。拿到 example.com.crt 与中间证书 intermediate.crt 后,先校验私钥与证书是否配对(RSA 用 modulus,ECDSA 用公钥):
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5 # 两行 md5 必须完全一致
openssl pkey -in example.com.key -pubout | openssl md5
openssl x509 -in example.com.crt -pubkey -noout | openssl md5 # ECDSA 场景用这两行
合并证书链,顺序为 站点证书 → 中间证书。根证书不要放:多传会增加握手体积,部分老客户端还会报错。
cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -untrusted intermediate.crt example.com.crt
# 期望输出:example.com.crt: OK
上传到面板统一目录并收紧权限(私钥 600、属主 root):
install -m 600 -o root -g root example.com.key /www/server/panel/vhost/cert/example.com/privkey.pem
install -m 644 -o root -g root fullchain.pem /www/server/panel/vhost/cert/example.com/fullchain.pem
面板操作:网站 → 设置 → SSL → 其他证书,分别粘贴 PEM(fullchain)与私钥(KEY),保存后开启“强制 HTTPS”。注意 PEM 必须从 -----BEGIN CERTIFICATE----- 开始,不能带 BOM、Windows 换行或多余说明文字。续签方式为到期前重新走一遍上述流程,因此商业证书同样要纳入巡检。
四、配置示例:Nginx / Apache 强制 HTTPS 与 TLS 加固
面板生成的 vhost 在 /www/server/panel/vhost/nginx/example.com.conf,可手工补强。完整可用片段:
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
http2 on; # Nginx 1.25.1+ 写法;旧版写 listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /www/server/panel/vhost/cert/example.com/fullchain.pem;
ssl_certificate_key /www/server/panel/vhost/cert/example.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
add_header X-Content-Type-Options nosniff always;
root /www/wwwroot/example.com;
index index.php index.html;
}
三点说明:① ssl_ciphers 只保留 ECDHE + AEAD 套件,TLS 1.3 套件由 OpenSSL 自动协商,无需在此列出;② Let’s Encrypt 已于 2025 年 8 月停止提供 OCSP 响应,对 LE 证书配置 ssl_stapling on 不会生效,建议删掉这两行;使用商业 CA 证书时保留,并配 ssl_trusted_certificate 指向 chain.pem;③ HSTS 一旦下发,浏览器在 max-age 内不再允许降级 HTTP,上线前先设 max-age=300 灰度。
Apache 对应写法(/www/server/panel/vhost/apache/example.com.conf):
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /www/server/panel/vhost/cert/example.com/fullchain.pem
SSLCertificateKeyFile /www/server/panel/vhost/cert/example.com/privkey.pem
SSLProtocol -all +TLSv1.2 +TLSv1.3
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
改完执行 nginx -t && nginx -s reload。若页面仍报 Mixed Content,在站点 <head> 加 <meta http-equiv="Content-Security-Policy" content="upgrade-insecure-requests"> 兜底,并把数据库里的 http:// 静态资源批量替换为 // 或 https://。
五、自动续签:cron、计划任务与到期巡检
acme.sh 安装时会自动写入 crontab,先确认它还在:
crontab -l | grep acme
# 正常输出:17 0 * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null
若被误删,在 面板 → 计划任务 → 添加任务 新建 Shell 脚本任务,周期选“每天”,内容:
#!/bin/bash
/root/.acme.sh/acme.sh --cron --home /root/.acme.sh >> /www/wwwlogs/acme_cron.log 2>&1
acme.sh 会在到期前 30 天(90 天证书约第 60 天)自动续签,续签成功后触发 --reloadcmd。确认钩子已记录:
~/.acme.sh/acme.sh --list
grep -i Le_ReloadCmd ~/.acme.sh/example.com/example.com.conf
再加一层到期巡检,防止续签静默失败(例如 DNS API 密钥过期):
#!/bin/bash
for c in /www/server/panel/vhost/cert/*/fullchain.pem; do
end=$(openssl x509 -enddate -noout -in "$c" | cut -d= -f2)
days=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
[ "$days" -lt 15 ] && echo "$(date '+%F %T') WARN $c 仅剩 ${days} 天" >> /www/wwwlogs/cert_expiry.log
done
把脚本挂到计划任务每天 09:00 执行,配合面板“SSL 到期提醒”和邮件/企业微信通知。经验阈值:剩余 ≤ 15 天必须人工介入,≤ 7 天按故障处理。注意 398 天的商业证书同样要纳入巡检——2026-03-15 之后新签证书上限降为 200 天,续签频率将翻倍。
六、对比表格:证书类型 × 部署方式怎么选
先按站点性质选证书类型,不要盲目上 EV:
| 类型 | 有效期 | 泛域名 | 浏览器信任 | 成本 | 适用场景 |
|---|---|---|---|---|---|
| Let’s Encrypt(面板一键) | 90 天 | 支持(须 DNS 验证) | 全信任 | 免费 | 个人站、博客、内部系统 |
| 商业 DV | 398 天(2026-03-15 起 200 天) | 支持 | 全信任 | 百元级 | 企业官网、小程序后端 |
| 商业 OV / EV | 同上 | 支持 | 全信任 | 千元以上 | 金融、电商、需展示主体资质 |
| 自签名 | 自定义 | 支持 | 不信任 | 免费 | 仅内网联调,禁止上生产 |
再看部署方式与运维成本:
| 方式 | 操作成本 | 自动续签 | 批量能力 | 主要风险点 |
|---|---|---|---|---|
| 面板一键申请 | 低 | 内置 | 逐站点点击 | 80 端口被拦即失败 |
| acme.sh CLI | 中 | cron + reloadcmd | 脚本批量、泛域名 | 需维护 DNS API 密钥 |
| 第三方证书手动上传 | 高 | 无,需人工巡检 | 弱 | 易漏传中间证书 |
| 商业 CA API / 面板代理商接口 | 中 | 依赖厂商 | 强 | 账号与配额绑定 |
结论:单站点用面板一键最省事;站点数超过 5 个或需要 *.example.com,一律改用 acme.sh + DNS API,并把 --install-cert 的 --reloadcmd 固化下来;只有合规要求(必须 OV/EV)时才走第三方证书,且必须配套到期巡检脚本,否则 200 天有效期落地后必然出现批量过期。
七、常见错误排查:6 个真实报错与修复命令
① 浏览器 NET::ERR_CERT_DATE_INVALID:证书过期或服务器时间错误。先 date -u 核对时间,再 openssl x509 -noout -dates -in /www/server/panel/vhost/cert/example.com/fullchain.pem 看 notAfter,过期则强制续签:~/.acme.sh/acme.sh --renew -d example.com --force。
② NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN:证书 SAN 未覆盖当前访问域名,最常见是漏了 www。用 openssl x509 -noout -text -in fullchain.pem | grep -A1 "Subject Alternative Name" 确认,重签时把所有别名都加 -d。
③ nginx: [emerg] cannot load certificate ".../fullchain.pem": PEM_read_bio_X509_AUX() failed:文件内容不合法。执行 head -1 fullchain.pem 应输出 -----BEGIN CERTIFICATE-----;常见原因是粘贴时带入 BOM、Windows 换行或说明文字,用 sed -i 's/r$//' fullchain.pem 修复后 nginx -t。
④ curl: (60) SSL certificate problem: unable to get local issuer certificate:证书链不完整。用 openssl verify -untrusted intermediate.crt example.com.crt 复现,重新执行 cat example.com.crt intermediate.crt > fullchain.pem 并 reload。
⑤ acme.sh 报 Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404:验证路径被伪静态、防盗链或 CDN 拦截。临时在站点配置加入:
location ^~ /.well-known/acme-challenge/ {
root /www/wwwroot/example.com;
try_files $uri =404;
}
CDN 侧把 /.well-known/ 设为不缓存、直接回源;或改用 DNS 验证绕过 80 端口。
⑥ Error creating new order :: too many failed authorizations recently:触发 Let’s Encrypt 限流,同一账号对同一域名每小时最多 5 次失败校验。等 1 小时后先演练:~/.acme.sh/acme.sh --issue -d example.com -w /www/wwwroot/example.com --dry-run,通过再正式签发。若面板只提示“证书申请失败:域名解析错误”,多为 DNS 未生效或 AAAA 记录指向不通的 IPv6,用 dig +short AAAA example.com 排查。
八、效果验证:三层校验确认证书真正可用
第一层:证书本身。核对 CN、签发者、剩余天数与 SAN 覆盖范围:
openssl x509 -noout -subject -issuer -dates -ext subjectAltName
-in /www/server/panel/vhost/cert/example.com/fullchain.pem
issuer 应为 Let’s Encrypt R11/R12 或对应商业 CA,SAN 必须同时包含主域名与 www。
第二层:线上握手与跳转。
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -dates
curl -sI https://example.com | head -5
curl -sI http://example.com | grep -iE '^HTTP|^location' # 期望 301,location 为 https
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep -E 'Protocol|Cipher'
期望 Protocol 为 TLSv1.3 或 TLSv1.2,Cipher 为 TLS_AES_256_GCM_SHA384 或 ECDHE-*-GCM。
第三层:外部评分与混合内容。
curl -s "https://api.ssllabs.com/api/v3/analyze?host=example.com&publish=on&startNew=on&all=done" | jq -r '.status, .endpoints[0].grade'
curl -s https://example.com | grep -oE "http://[a-zA-Z0-9./_-]+" | sort -u # 应为空
curl -sI https://example.com | grep -i strict-transport-security
SSL Labs 目标 A 及以上;评级掉到 B 通常是仍启用 TLS 1.0/1.1 或弱套件,按第四节配置修正。最后确认 HSTS 头已下发、巡检日志无 WARN、小程序与 App 端接口回归通过,即视为验证闭环。
常见问题
宝塔面板申请的 Let’s Encrypt 证书到期会自动续签吗?
会,但依赖两个前提:acme.sh 的 cron 任务存在(crontab -l | grep acme),以及 install-cert 时写入了 --reloadcmd。面板一键申请的证书由面板自身的计划任务续签,需保证面板服务常驻运行。若你手工用 acme.sh 签发又没绑 reloadcmd,续签成功后 Nginx 仍在用旧证书,表现为“证书明明续了浏览器还报过期”,重新执行一次 --install-cert 补上钩子即可。
证书有效期是 398 天,以后还会变吗?
398 天是 CA/Browser Forum 自 2020-09-01 起执行的公开信任 TLS 证书上限。后续 SC-081 已排定时间表:2026-03-15 起降为 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。这意味着自动续签从“可选”变成“必须”,同时 398 天的商业证书也不能再靠人工一年一换。
泛域名证书必须用 DNS 验证吗?
是。HTTP-01 只能验证具体主机名,无法验证 *.example.com,因此泛域名必须走 DNS-01。在面板里选择 DNS 验证并填写云厂商 API 密钥(阿里云 Ali_Key/Ali_Secret、腾讯云 DP_Id/DP_Key 等),acme.sh 会自动写入 TXT 记录并在验证后清理。
fullchain.pem 和 cert.pem 有什么区别?
cert.pem 只含站点证书,fullchain.pem 是站点证书 + 中间证书。Nginx 的 ssl_certificate 必须指向 fullchain,否则 Android、Java、小程序等不做 AIA 补链的客户端会报 unable to get local issuer certificate。根证书不要拼进去。
开启强制 HTTPS 后网站打不开或样式错乱怎么办?
先确认 443 端口放行且 nginx -t 通过。样式错乱通常是混合内容:页面里仍有 http:// 的图片、CSS 或 JS。用 curl -s https://example.com | grep -oE "http://[a-zA-Z0-9./_-]+" 找出残留链接,把数据库与模板中的地址改为相对协议 // 或 https,并加 CSP upgrade-insecure-requests 兜底。
面板提示“证书申请失败”但没有具体原因,怎么排查?
依次看三处日志:面板日志 /www/server/panel/logs/、acme.sh 日志 /root/.acme.sh/acme.sh.log、站点错误日志 /www/wwwlogs/example.com.error.log。最常见是 80 端口不可达(安全组或 CDN)、验证目录 404、域名解析未生效,以及触发 Let’s Encrypt 限流。定位后用 --dry-run 演练,通过再正式签发。