跳到主要内容
ssl证书按装

宝塔面板 SSL 证书服务实战:一键申请、第三方证书部署、自动续签与报错排查

宝塔面板 SSL 证书服务实战:一键申请、第三方证书部署、自动续签与报错排查 — 宝塔面板 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 演练,通过再正式签发。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。