跳到主要内容
安装配置教程

宝塔 SSL 证书配置全流程:Nginx 参数、证书链修复与真实报错排查

宝塔ssl证书配置 — 宝塔 SSL 证书配置全流程:Nginx 参数、证书链修复与真实报错排查
核心结论

宝塔 SSL 证书配置的核心是三件事:把 fullchain.pem(站点证书 + 中间证书)和 privkey.pem 放到 /www/server/panel/vhost/cert/域名/ 目录,在站点 Nginx 配置的 #SSL-START 区块内正确引用这两个文件,然后执行 nginx -t 校验并通过 nginx -s reload 重载。 Let's Encrypt 证书有效期 90 天,宝塔计划任务中的「续签Let's Encrypt证书」默认每天执行一次,实际续签发生在到期前 30 天;通配符证书必须使用 DNS 验证,需先在面板 API 接口中配置阿里云 / DNSPod / Cloudflare 的 Token。 证书链不完整是「电脑能打开、手机和微信打不开」的首要原因,用 openssl s_client -connect 域名:443 -servername 域名 -showcerts 可确认是否返回了 2 张以上证书。 Nginx 1.25.1 起不再支持 listen 443 ssl http2 的写法,需改为 listen 443 ssl; 加独立的 http2 on;,否则 reload 会报 unknown directive 或警告。 验证是否真正生效,最低成本组合是:curl -I https://域名 看 HTTP/2 200、openssl x509 -noout -dates -in fullchain.pem 看有效期、openssl rsa -noout -modulus 与证书 modulus 比对确认私钥匹配。

为什么宝塔里点了「部署」还是显示不安全?先定位 6 个根本原因

面板顶部显示绿色「已部署」,浏览器地址栏却仍是「不安全」——这是宝塔 SSL 证书配置里最常见的”假成功”。面板状态只说明文件已上传,不代表 Nginx 真的加载了 ssl_certificate 指令。按下面 6 项依次排查,绝大多数能在 5 分钟内定位。

  1. 配置没真正写进 vhost。宝塔 8.x/9.x 的站点配置在 /www/server/panel/vhost/nginx/你的域名.conf,SSL 段被 #SSL-START 与 #SSL-END 包裹。手工改过该文件、或整站从旧服务器迁移时,这个区块可能已被删掉,面板却依旧显示「已部署」。查运行时配置(nginx -T)比看面板可靠。
  2. 证书链缺失。只贴站点证书、没带中间证书时,桌面浏览器会自动补齐,看起来正常;但 Android 7 及以下、微信内置浏览器、Java 8 的 HttpsURLConnection 会直接报错。据 RFC 5246 §7.4.2,certificate_list 中每张证书必须直接签发前一张;Let’s Encrypt 文档也明确要求部署 fullchain.pem 而非 cert.pem。
  3. 证书与私钥不匹配。多因从不同订单复制了 KEY,或 PEM 被编辑器插入 BOM、中文注释、多余空行。Nginx reload 时会报 SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) 并拒绝加载。
  4. 混合内容(Mixed Content)。页面走 HTTPS,但引用了 http:// 的图片、JS 或字体,DevTools 控制台输出 Mixed Content: The page at ‘https://…’ was loaded over HTTPS, but requested an insecure resource ‘http://…’. This request has been blocked.,地址栏依旧标不安全。
  5. 服务器时间漂移超过 5 分钟。触发 NET::ERR_CERT_DATE_INVALID 或 OCSP 校验失败。timedatectl status 里 System clock synchronized 应为 yes;否则执行 chronyc makestep(chrony)或 ntpdate -u ntp.aliyun.com。
  6. CDN 边缘证书没同步。域名解析在 Cloudflare、又拍云、阿里云 CDN 上时,用户看到的是边缘节点证书。源站换新证书后还需在 CDN 控制台上传或开启「回源跟随」,否则边缘仍是 90 天前那张。Cloudflare 的 SSL/TLS 模式须设为 Full (strict),否则源站的过期或自签证书会被静默接受。

第 2 项值得单独展开,因为它在不同客户端上的表现差异极大:

客户端 / 运行时 缺中间证书时的表现 原因
桌面 Chrome / Edge / Firefox 正常显示锁标 通过 AIA Fetching 自动补链(RFC 5280 AIA 扩展)
Android 7 及以下、微信内置浏览器 unable to get local issuer certificate 不实现 AIA,只信服务端下发的链
Java 8 HttpsURLConnection PKIX path building failed 同上,走 JDK 自带 truststore
curl / 旧版 OpenSSL SSL certificate problem: unable to get local issuer certificate 只读本地 CA bundle,不回源补链

宝塔 9.x 的默认证书目录是 /www/server/panel/vhost/cert/<域名>/,模板中 ssl_certificate 默认指向 fullchain.pem、ssl_certificate_key 指向 privkey.pem,ssl_protocols 默认为 TLSv1.2 TLSv1.3。用下面这组命令一次性核对上面 6 项中的 1、2、3、5:

# 1) 确认 vhost 里 SSL 区块还在(返回 1 才正常)
grep -c "SSL-START" /www/server/panel/vhost/nginx/example.com.conf

# 2) 看 Nginx 运行时实际加载的证书路径,而非面板显示
nginx -T 2>/dev/null | grep -E "server_name example.com|ssl_certificate "

# 3) 校验证书与私钥是否配对:两行 md5 必须完全一致
openssl x509 -noout -modulus -in /www/server/panel/vhost/cert/example.com/fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in /www/server/panel/vhost/cert/example.com/privkey.pem  | openssl md5

# 4) 数服务端实际下发了几张证书:>=2 才算完整链
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep -c "BEGIN CERTIFICATE"

# 5) 时间同步状态,输出中应有 "System clock synchronized: yes"
timedatectl status | grep -i synchronized

第 4 步返回 1,说明只下发了站点证书,正是缺链;返回 0 则意味着 443 端口根本没走 TLS,回到第 1 步检查 vhost。第 3 步两行 md5 不一致时,任何 nginx -s reload 都会失败,须重新从同一订单导出 fullchain.pem 与 privkey.pem,并用 file fullchain.pem 确认文件不含 BOM。

宝塔 SSL 证书配置的完整实操步骤(申请到生效共 7 步)

下面按从零到生效的顺序拆成 7 步,每一步都给可直接复制的命令与判断标准。据 Let’s Encrypt 官方文档,证书有效期 90 天、续签建议在到期前 30 天执行,这也是后文第 7 步要盯住计划任务的原因。

第 1 步:环境自检。面板版本需 ≥ 8.0.5(推荐 9.x),因为旧版「其他证书」页签不支持粘贴完整证书链。SSH 执行:

# 确认 Nginx 编译参数含 SSL 与 HTTP/2 模块
nginx -V 2>&1 | tr ' ' 'n' | grep -E 'ssl|v2'
# 期望输出包含:
# --with-http_ssl_module
# --with-http_v2_module
openssl version   # 需 ≥ 1.1.1 才支持 TLS 1.3;1.0.2 最高只能到 TLS 1.2

缺少 --with-http_ssl_module 时,面板点开 SSL 会直接报「当前 Nginx 未安装 SSL 模块」,此时应卸载重装 Nginx(编译安装而非极速安装)。

第 2 步:解析与放行。A 记录指向服务器公网 IP,默认 TTL 600 秒,核对命令:

dig +short your-domain.com @223.5.5.5   # 应返回你的公网 IP
# firewalld 环境放行 443
firewall-cmd --add-service=https --permanent && firewall-cmd --reload

宝塔「安全」页与云厂商安全组需同时放行 443/TCP——只开一处是国内最高频的「证书已部署但打不开」原因。国内节点还须完成 ICP 备案,未备案时 80/443 会被运营商侧拦截,与证书无关。

第 3 步:申请 Let’s Encrypt 证书。网站 → 站点 → 设置 → SSL → Let’s Encrypt → 勾选域名 → 验证方式选「文件验证」→ 申请。验证文件落在 /www/wwwroot/你的域名/.well-known/acme-challenge/。若站点已开伪静态或强制 301 到 HTTPS(而 HTTPS 尚不可用),验证请求会被改写或跳走,直接返回 404,这是首次配置宝塔 SSL 证书最常见的失败点。临时关掉 301 再申请即可。

第 4 步:通配符证书必须换 DNS 验证。勾选 *.example.com 时面板会提示「通配符证书需要使用DNS验证方式」。先到 面板设置 → API 接口 添加 DNS 服务商凭据(阿里云 AccessKey、腾讯云 SecretId/SecretKey、Cloudflare Global API Key),再回 SSL 页选 DNS 验证。

验证方式 适用证书 失败典型原因
文件验证 单域名、多域名 伪静态/301 导致 404
DNS 验证 含通配符、泛域名 API 凭据权限不足

第 5 步:商业证书部署。走「其他证书」页签。PEM 框内必须有两段 -----BEGIN CERTIFICATE-----:站点证书在前、中间证书在后,缺中间证书会导致安卓端与部分 API 客户端报「证书链不完整」。KEY 框粘贴 -----BEGIN PRIVATE KEY----- 或 -----BEGIN RSA PRIVATE KEY----- 的完整内容,末尾换行不要丢。

第 6 步:强制 HTTPS。点「强制HTTPS」按钮,面板会写入 301 跳转。站点前面有 CDN 或负载均衡时,只能在一处开启,两边同开会出现 ERR_TOO_MANY_REDIRECTS。

第 7 步:续签与备份。计划任务中确认存在「续签Let’s Encrypt证书」,周期为每天;查看实际条目:

crontab -l | grep -i ssl
# 建议每周备份证书目录,单站点仅 6-8 KB
tar -czf /www/backup/cert-$(date +%F).tar.gz /www/server/panel/vhost/cert/

至此,宝塔 SSL 证书配置从环境到续签的闭环完成;后续若出现握手失败,再按证书链与 Nginx 参数方向排查。

关键配置与命令示例:Nginx 参数、路径、版本号怎么写

证书文件、站点配置分别放在哪?改完怎么让它生效?

宝塔 7.x / 8.x / 9.x 会为每个站点建独立证书目录,且面板与 Nginx 只认 fullchain.pem(服务器证书 + 中间证书)。若把只有叶子证书的 cert.pem 填进 ssl_certificate,桌面浏览器往往”看起来正常”(会自行补链),但部分 Android、Java 客户端和 curl 老版本会直接报 unable to get local issuer certificate——这就是典型的证书链缺失,也是后续”证书链修复”一节的入口。

# 1) 证书目录(宝塔默认路径,example.com 换成你的域名)
ls -l /www/server/panel/vhost/cert/example.com/
#   fullchain.pem → ssl_certificate / ssl_trusted_certificate 都用它
#   privkey.pem   → ssl_certificate_key
chmod 600 /www/server/panel/vhost/cert/example.com/privkey.pem   # 私钥必须 600
chown root:root /www/server/panel/vhost/cert/example.com/privkey.pem

# 2) 站点配置(宝塔生成)
vim /www/server/panel/vhost/nginx/example.com.conf

# 3) 语法检查通过再平滑重载,别直接 restart
nginx -t && nginx -s reload
# 宝塔环境等价写法:/etc/init.d/nginx reload

注意一个高频坑:在面板”SSL”页面点保存会整体重写该 .conf,手改的 ssl_ciphers、HSTS 头会被冲掉。稳妥做法是把自定义参数填进面板 SSL 页的”配置文件”输入框,改完就不要再点保存。

Nginx 版本不同,listen 与 http2 写法差在哪?

据 Nginx 官方 ngx_http_ssl_module 文档,1.25.1 起新增独立的 http2 指令,listen ... http2 参数被标记为废弃,但到 1.27.x 仍兼容,只是每次 nginx -t 都会打印 the "listen ... http2" directive is deprecated, use the "http2" directive instead。

Nginx 版本 监听行写法 HTTP/2 开关 行为
≤ 1.24.x listen 443 ssl http2; 合并在 listen 里 正常,无警告
1.25.1 – 1.27.x listen 443 ssl; http2 on;(server 块) 旧写法可用但报 deprecated 警告
≥ 1.25.1 推荐 同上两行拆分 http2 on; 无警告,未来版本唯一写法
# Nginx ≤ 1.24 写法
server {
    listen 443 ssl http2;
    server_name 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;   # 默认值在 1.23.4 起已是 TLSv1.2 TLSv1.3
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
    ssl_prefer_server_ciphers off;         # 默认 off,交给客户端选 ChaCha20 更利于移动端
}

# Nginx ≥ 1.25.1 写法:拆成两行
server {
    listen 443 ssl;
    http2 on;
    # ……其余 ssl_* 指令完全相同
}

会话复用、OCSP 装订、HSTS 要补哪些参数?

ssl_session_cache shared:SSL:10m;   # 默认 none;10m 约缓存 4 万个会话
ssl_session_timeout 10m;            # 默认 5m
ssl_session_tickets off;            # 默认 on,关闭以避免 ticket key 不轮换削弱前向保密
ssl_stapling on;                    # 默认 off
ssl_stapling_verify on;             # 默认 off
ssl_trusted_certificate /www/server/panel/vhost/cert/example.com/fullchain.pem;
resolver 223.5.5.5 119.29.29.29 valid=300s;   # 无默认值,缺了 stapling 会静默失效
resolver_timeout 5s;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;

resolver 是最容易被漏掉的一行:Nginx 需要它去解析 OCSP 响应地址,未配置时不会报错,只是 stapling 永远不生效。按 RFC 6797(HSTS),首次上线建议先写 max-age=300 观察 24 小时,确认所有子域都能走 HTTPS 再改 31536000;preload 一旦进浏览器内置列表,回滚要等数月,务必最后再加。

怎么用命令确认证书链完整、私钥与证书配套?

CERT=/www/server/panel/vhost/cert/example.com/fullchain.pem
KEY=/www/server/panel/vhost/cert/example.com/privkey.pem

# 看主体、签发者(应出现中间 CA,如 R11 / E6)、有效期
openssl x509 -noout -subject -issuer -dates -in "$CERT"

# RSA 证书:两条 md5 必须完全一致
openssl x509 -noout -modulus -in "$CERT" | openssl md5
openssl rsa  -noout -modulus -in "$KEY"  | openssl md5

# ECDSA 证书(Let's Encrypt 现已默认签发 P-256):modulus 会报
# "Modulus not supported for this key type",改用公钥指纹比对
openssl x509 -noout -pubkey -in "$CERT" | openssl md5
openssl pkey -pubout  -in "$KEY"  | openssl md5

# 线上验证 OCSP 装订是否真的生效
openssl s_client -connect example.com:443 -status /dev/null | grep -i "OCSP Response Status"
# 期望输出:OCSP Response Status: successful (0x0)

完整链的判定标准很简单:openssl x509 -noout -issuer 的输出不应该是自签根,而 fullchain.pem 里应至少有两段 -----BEGIN CERTIFICATE-----。据 Let’s Encrypt 文档,其默认链已切换到 ISRG Root X1 交叉签名之外的短链,旧 Android 7.0 以下设备可能不信任,这类兼容性问题需要单独判断,而不是盲目回退到已过期的 DST Root CA X3。

免费 Let's Encrypt、商业 DV/OV 与面板一键部署怎么选?(选型对比表)

选型时最容易踩的坑,是把“免费 / 付费”当成唯一维度。真正决定运维成本的是验证类型(DV / OV)和续签自动化程度。下表为 2025 年常见方案对比,价格为公开渠道参考区间,随促销波动:

方案 参考价格 有效期 验证类型 适用场景 宝塔部署方式
Let’s Encrypt 单域名 ¥0 90 天 DV 个人站、测试环境 面板一键申请 + 自动续签
Let’s Encrypt 通配符 ¥0 90 天 DV 多子域、SaaS 后台 DNS API 验证
ZeroSSL / Buypass ¥0 90 / 180 天 DV 需要 180 天周期的场景 手动上传或 ACME 脚本
商业 DV 单域名 ¥50–200 / 年 365 天 DV 不想折腾续签的企业站 其他证书 → 粘贴 PEM
商业 DV 通配符 ¥300–800 / 年 365 天 DV 子域多、续签窗口紧 其他证书 → 粘贴 PEM
商业 OV 单域名 ¥800–2500 / 年 365 天 OV(需营业执照核验) 政企、支付回调、招投标 其他证书 → 粘贴 PEM

选择逻辑很简单:站点数量 ≤ 3 且能接受 90 天续签节奏,直接用 Let’s Encrypt;子域超过 5 个优先通配符,一次申请覆盖全部子域,省掉逐个申请与续签的运维成本。注意通配符只能走 DNS 验证——据 Let’s Encrypt 文档,*.example.com 不支持 HTTP-01 挑战,这也是宝塔ssl证书配置里通配符必须填 DNS API 密钥的原因。

合规场景(金融、医疗、政企门户、支付回调、招投标)通常要求 OV 及以上。据 CA/Browser Forum Baseline Requirements,OV 必须人工核验企业主体信息,证书 Subject 里会带 O = 字段,而 DV 只有 CN。一条命令即可验证手里是哪种:

# 适用于 OpenSSL 1.1.1 / 3.x,宝塔 8.x 默认证书目录如下
openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem 
  -noout -subject -issuer -dates
# DV 输出:subject=CN = example.com
# OV 输出:subject=C = CN, O = 某某科技有限公司, CN = example.com
# notAfter 即到期时间,可用于核对面板显示的剩余天数

EV 证书因 Chrome 77(2019 年 9 月)与 Firefox 70 先后移除绿色地址栏 UI,已基本退出主流采购清单,不建议为此多付 3–5 倍预算。混合策略更实用:主站用商业 DV 或 OV 保 365 天稳定,测试环境、内部系统、临时活动页用 Let’s Encrypt,把续签失败的爆炸半径限制在非核心域名上。

成本不止证书价格。Let’s Encrypt 的隐性成本是监控告警——没有告警的 90 天续签等于定时炸弹。用 blackbox_exporter(v0.25.x)采集 probe_ssl_earliest_cert_expiry 并设 15 天告警:

# prometheus.yml 抓取片段
- job_name: 'blackbox_ssl'
  metrics_path: /probe
  params:
    module: [http_2xx]
  static_configs:
    - targets: ['https://www.example.com']
  relabel_configs:
    - source_labels: [__address__]
      target_label: __param_target
    - target_label: __address__
      replacement: 127.0.0.1:9115   # blackbox_exporter 默认监听 9115

# 告警规则:证书剩余不足 15 天(单位秒)
- alert: SSLCertExpiring
  expr: probe_ssl_earliest_cert_expiry - time() < 86400 * 15
  for: 1h

需要通配符又不想受面板续签调度限制时,可用 acme.sh 签发后写入宝塔证书目录,两条路径共用同一份 Nginx 配置:

# acme.sh v3.0.x,--keylength 默认 ec-256,续签 cron 默认 60 天触发
export CF_Token="你的 Cloudflare API Token"
acme.sh --issue --dns dns_cf -d example.com -d '*.example.com' --keylength ec-256
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"

商业证书的隐性成本则是每年重新提交资料与重新部署,两条路线都要算进去。还需留意政策变化:CA/Browser Forum SC-081 提案已于 2025 年通过,证书最长有效期将从 398 天分阶段缩短至 47 天(2029 年 3 月生效),“买一年省事”的红利正在消失,长期看自动化续签是唯一可持续路线。

常见错误与排查:这些真实报错分别怎么处理

问:宝塔里保存证书后 Nginx 起不来,报 nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line),怎么办?

这条报错只说明一件事:OpenSSL 在 ssl_certificate 指向的文件里找不到 PEM 起始行。宝塔的证书默认落在 /www/server/panel/vhost/cert/<域名>/fullchain.pem 与 privkey.pem,常见污染源是粘贴时混入的证书申请页说明文字、Windows 的 CRLF 换行以及 UTF-8 BOM。按下面顺序验证并修复:

# 1. 看首行是不是标准 PEM 头(必须完全一致,前面不能有空格/BOM)
head -1 /www/server/panel/vhost/cert/example.com/fullchain.pem
# 期望:-----BEGIN CERTIFICATE-----

# 2. 看是否被 Windows 换行或 BOM 污染(输出含 CRLF / BOM 即为异常)
file /www/server/panel/vhost/cert/example.com/fullchain.pem

# 3. 去 BOM(只删第一行开头的 EF BB BF 三个字节)
sed -i '1s/^xEFxBBxBF//' /www/server/panel/vhost/cert/example.com/fullchain.pem

# 4. 转 Unix 换行(CentOS: yum install -y dos2unix;Debian/Ubuntu: apt install -y dos2unix)
dos2unix /www/server/panel/vhost/cert/example.com/fullchain.pem

# 5. 校验语法并重载
nginx -t && nginx -s reload

问:报 SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) 是什么原因?

证书与私钥不是同一对密钥。RSA 证书用 modulus 比对,ECC 证书(Let’s Encrypt 已全面转向 ECDSA,见 Let’s Encrypt 官方公告)必须用公钥比对,-modulus 对 ECC 会直接报错:

# RSA 证书:两条命令输出的 MD5 必须完全相同
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in privkey.pem  | openssl md5

# ECC 证书(ECDSA P-256/P-384)改用公钥比对
openssl x509 -noout -pubkey -in fullchain.pem | openssl md5
openssl pkey -pubout       -in privkey.pem   | openssl md5

不一致就去 CA 后台或签发邮件重新下载配套的 fullchain 与 private key,不要从旧备份里”拼”一套。

问:nginx: [emerg] unknown directive "ssl_stapling" 怎么修?

ssl_stapling 与 ssl_stapling_verify 自 Nginx 1.3.7 引入(据 Nginx 官方指令文档),且必须在编译时启用 --with-http_ssl_module。宝塔”极速安装”的部分裁剪包缺少该模块。先确认:

nginx -V 2>&1 | tr ' ' 'n' | grep -E 'http_ssl_module|nginx version'

无 --with-http_ssl_module 输出,就到宝塔「软件商店 → Nginx → 编译安装」重装,别再用极速包;临时可用的话先把 ssl_stapling on; 两行注释掉,但 OCSP 装订会失效。

问:Let’s Encrypt 申请报 Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404?

验证器走的是 HTTP-01(RFC 8555 定义),文件被伪静态规则或 301 跳转吃掉了。处理:在「网站 → 伪静态」文件最顶部加放行段,并临时关闭「强制 HTTPS」——否则证书无效时验证器跟随 301 到 HTTPS 会直接失败。

# 宝塔伪静态文件:/www/server/panel/vhost/rewrite/example.com.conf
location ^~ /.well-known/acme-challenge/ {
    allow all;
    default_type "text/plain";
    root /www/wwwroot/example.com;   # 必须与实际站点根目录一致
}
# 其余 rewrite 规则写在这段之后

问:报 urn:ietf:params:acme:error:unauthorized 或面板提示”域名解析不正确”?

两种可能:A 记录尚未生效;或域名开了 Cloudflare 橙云代理,验证请求打到边缘节点而非源站。把代理切为 DNS only(灰云),等 60 秒后用 dig +short example.com 确认已指向源站 IP 再申请,签发成功后再开回代理。

问:浏览器/客户端报 curl: (60) SSL certificate problem: unable to get local issuer certificate,微信也提示证书无效?

典型证书链不完整——只下发了叶证书。RFC 8446 §4.4.2 要求 certificate_list 按”叶证书 → 中间证书”顺序排列,根证书不发送。数一下实际下发的张数:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | grep -c 'BEGIN CERTIFICATE'      # ≥2 才正常,1 说明缺中间证书

# 修复:把中间证书追加到站点证书之后(顺序不能反)
cat domain.crt intermediate.crt > fullchain.pem
报错关键字 根因 一条命令定位
PEM_read_bio_X509_AUX 非 PEM / BOM / CRLF head -1 fullchain.pem
X509_check_private_key:key values mismatch 证书与私钥不配对 openssl x509 -noout -modulus -in fullchain.pem | openssl md5
unknown directive “ssl_stapling” Nginx 缺 http_ssl_module 或 <1.3.7 nginx -V 2>&1 | grep -o http_ssl_module
acme-challenge 404 伪静态/301 拦截验证路径 curl -I http://example.com/.well-known/acme-challenge/test
acme:error:unauthorized 解析未生效或 CDN 代理 dig +short example.com
unable to get local issuer certificate 中间证书未下发 openssl s_client -showcerts … | grep -c BEGIN

配好后建议用 SSL Labs 或 myssl.com 复测链完整性,并按 Mozilla Server Side TLS 指南核对协议与套件(如仅保留 TLSv1.2/1.3、启用 ssl_session_cache shared:SSL:10m),这比在宝塔面板里逐项点选更可控。

如何确认配置真的生效?5 种验证方法逐层确认

改完配置执行 nginx -t && nginx -s reload 返回成功,只说明语法没错,不说明客户端拿到的就是你想要的证书和协议。下面 5 步从”连接层 → 证书层 → 链层 → 协议层 → 浏览器层”逐层确认,每一步都有可复制的命令和明确的通过标准。

1. 协议与状态码:返回的是 HTTP/2 还是 HTTP/1.1?

# -I 发 HEAD 请求;--http2 强制协商 h2,便于区分"服务器不支持"和"curl 未启用"
curl -I https://example.com
# 更精确:直接打印协商到的协议版本与状态码
curl -sS -o /dev/null -w '%{http_version} %{http_code}n' https://example.com
# 期望输出:2 200

若输出 HTTP/1.1 200,说明 HTTP/2 没开。Nginx ≥ 1.25.1 起,listen 443 ssl http2; 这种旧写法已被弃用,会打印 the "listen ... http2" directive is deprecated, use the "http2" directive instead,正确写法是 listen 443 ssl; 加独立的 http2 on;(默认 off,作用域为 http/server)。宝塔面板在软件商店切换 Nginx 1.24 与 1.25+ 时,生成的 vhost 模板写法不同,这是”面板显示已开 HTTP/2 但实际仍是 1.1″最常见的原因。

2. 证书详情:CN/SAN 和到期日对不对?

# -servername 必须显式指定,否则 SNI 多站点会取到默认站点的证书
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 
  | openssl x509 -noout -subject -issuer -dates
# 关注:subject 的 CN、issuer 是否为 Let's Encrypt R11 / DigiCert 等真实 CA
# notAfter 是否等于面板显示的到期日(差一天以上说明部署的不是新证书)

注意 CN 已不再被主流浏览器采纳,据 CA/Browser Forum 基线要求,域名必须出现在 SAN 中;只有 CN 没有 SAN 的证书在 Chrome 会直接报 ERR_CERT_COMMON_NAME_INVALID。

3. 证书链完整性:Verify return code 必须是 0

openssl s_client -connect example.com:443 -servername example.com 
  -CAfile /etc/ssl/certs/ca-certificates.crt &1 | grep 'Verify return code'
返回值 含义 典型原因
0 (ok) 链完整且可信 通过
20 unable to get local issuer certificate 只部署了域名证书,漏拼中间 CA
21 unable to verify the first certificate fullchain 顺序颠倒或中间证书缺失
19 self-signed certificate in chain 把根证书也拼进了 fullchain.pem
10 certificate has expired 自动续签任务失败未发现

据 Let’s Encrypt 文档,fullchain.pem = 域名证书 + 中间证书,chain.pem 仅为中间证书;宝塔”其他证书”粘贴框里若只贴了 cert.pem 内容,就会稳定复现 20/21。修复后务必用 openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout 核对链中证书数量与顺序。

4. 协议版本控制与 OCSP stapling

# 应握手失败(说明 TLS 1.0/1.1 已禁用,符合 RFC 8996 的弃用要求)
openssl s_client -connect example.com:443 -tls1_1 </dev/null
# 应握手成功
openssl s_client -connect example.com:443 -tls1_3 </dev/null
# OCSP 装订:期望 OCSP Response Status: successful
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 
  | grep -A1 'OCSP Response Status'

若 stapling 返回 no response sent,检查 vhost 内是否有 ssl_stapling on; ssl_stapling_verify on; ssl_trusted_certificate fullchain.pem;,并且 resolver 223.5.5.5 8.8.8.8 valid=300s; 可用——没有 resolver 时 Nginx 无法抓取 OCSP 响应。

5. 浏览器与在线工具交叉验证(含 HSTS 与跳转)

# HSTS 头:期望看到 max-age(Mozilla 建议 31536000 秒,即 1 年)
curl -sI https://example.com | grep -i strict-transport-security
# HTTP→HTTPS 跳转:期望 301 且 Location 保留原路径与查询串
curl -I http://example.com/path?a=1

据 RFC 6797,HSTS 生效后浏览器会对该域强制 HTTPS,配置错误很难回滚,建议先用短 max-age 灰度。Chrome DevTools → Security 面板应显示 Connection — secure,且 Console 无 mixed content 警告;再用 MySSL.com 或 Qualys SSL Labs 跑评级,重点看 Certificate Chain、Protocol Support、HSTS 三项,正常应达 A 级。若跳转后路径丢失(Location: https://example.com/),说明宝塔站点配置里写死了 rewrite ^/(.*)$ https://$host/ permanent;,应改为 return 301 https://$host$request_uri;,这样才能保住 $request_uri 中的路径与参数。

完成以上 5 步,才算真正完成了宝塔 SSL 证书配置的验收;任何一步不通过,都建议回到证书链与 vhost 模板这两处排查。

自动续签与到期监控:别让证书在凌晨悄悄过期

宝塔的「续签Let’s Encrypt证书」计划任务,是每天都在续签吗?

不是。据 Let’s Encrypt 官方文档,ACME 证书有效期固定为 90 天,官方建议在剩余 30 天时发起续签(RFC 5280 第 4.1.2.5 节也要求客户端在 notAfter 之前完成证书替换,否则依赖方会直接判定为过期)。宝塔在安装时创建的计划任务虽然每天触发一次,但脚本内部会先用 OpenSSL 读取证书的 notAfter,只有剩余天数 ≤ 30 才真正发起 ACME 请求,其余时间直接退出。所以日志里大量「跳过」是正常现象,也不会消耗 Let’s Encrypt 的速率限制配额(每注册域名每周 50 张重复证书)。

怎么确认续签到底跑没跑过?

面板路径是「计划任务 → 续签Let’s Encrypt证书 → 日志」;SSH 下可直接比对文件时间与证书到期日:

# 1) 看续签任务日志的最后 20 行(宝塔 7.x/8.x/9.x 日志目录一致)
grep -iE "letsencrypt|renew|cert" /www/server/panel/logs/crontab.log | tail -n 20

# 2) 直接读证书的 notAfter,若日期没被刷新说明续签从未成功
openssl x509 -noout -subject -enddate 
  -in /www/server/panel/vhost/cert/example.com/fullchain.pem
# 典型输出:
# subject=CN = example.com
# notAfter=Nov 18 03:14:07 2025 GMT

续签失败最常见的三个原因:

  • DNS API Token 过期或被回收:泛域名走 DNS-01 验证时,日志会报 Error: DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.com,重新在面板绑定 Token 即可。
  • 验证目录被安全软件拦截:云锁、宝塔 WAF、CDN 的「CC 防护」会拦掉 /.well-known/acme-challenge/,日志报 Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404。
  • 80 端口被关闭或强制跳转到不存在的 HTTPS:HTTP-01 验证必须能拿到 200,301 到坏掉的 HTTPS 同样失败。

建议每季度在面板手动点一次「执行」做演练,而不是等 30 天窗口里才发现问题。

到期监控该怎么做?

方式 检测粒度 预警提前量 适用场景 局限
宝塔面板 SSL 到期消息推送 天 约 15 天 单机、站点少 依赖面板消息通道,主机失联时无告警
Prometheus + blackbox_exporter 分钟级 自定义(建议 15 天) 多站点、已有监控体系 需额外部署维护
外部 uptime 服务 1–5 分钟 由服务商决定 无自建监控 看不到证书链细节
# blackbox_exporter 采集 https_2xx 模块后,用 probe_ssl_earliest_cert_expiry(Unix 时间戳)算剩余天数
# prometheus 告警规则:剩余不足 15 天即触发,留足人工介入时间
- alert: SSLCertExpiringSoon
  expr: (probe_ssl_earliest_cert_expiry - time()) / 86400 < 15
  for: 1h
  labels:
    severity: warning
  annotations:
    summary: "{{ $labels.instance }} 证书剩余 {{ $value | printf "%.1f" }} 天"

商业证书更危险。365 天有效期意味着一年只有一次机会,错过就是线上事故;建议在签发当天就在工单系统里建一条「到期前 30 天」的提醒,不要依赖任何自动续签。

备份与回滚:把证书目录和站点配置一起纳入每日备份,误删后 5 分钟可恢复,省掉重新走一遍域名验证:

# 备份(可放进宝塔「计划任务 → 备份网站」的 shell 脚本里)
tar -czf /www/backup/cert-$(date +%F).tar.gz 
  /www/server/panel/vhost/cert/ 
  /www/server/panel/vhost/nginx/

# 回滚:解包后重载 Nginx 即可生效
tar -xzf /www/backup/cert-2025-08-20.tar.gz -C / && nginx -t && nginx -s reload

如果 fullchain.pem 的 notAfter 在 30 天窗口内始终没变化,先别反复点续签——按 Token、验证目录、80 端口这三条逐个排除,比盲目重试更省时间,也能避免触发 Let’s Encrypt 的失败次数限制(每账号每小时 5 次)。

面板自身 HTTPS 与整体安全加固:容易被忽略的另一半

很多人把站点证书配到“浏览器绿锁”就收工,却忘了面板自己还挂在 http://服务器IP:8888。宝塔面板默认通过 HTTP 提供管理入口,登录密码、会话 Cookie、操作指令都在明文链路上传输;据宝塔官方历年安全公告,未授权访问、任意文件读取等漏洞的利用前提,几乎都是 8888 端口直接暴露在公网。先把这“另一半”补上,再谈 Nginx 参数才有意义。

开启面板 HTTPS 的路径是 面板设置 → 面板 SSL,开启后访问 https://服务器IP:8888。首次开启时面板使用自签证书,Chrome/Edge 会明确报 NET::ERR_CERT_AUTHORITY_INVALID,curl 则返回 curl: (60) SSL certificate problem: self-signed certificate。这不是配置失败,而是证书链没有公共 CA 背书。正确做法是在同一页面把自签证书替换为已签发的 Let’s Encrypt 或商业证书;据 Let’s Encrypt 文档,其证书有效期 90 天,务必确认面板证书也在续期脚本的覆盖范围内,否则 90 天后你会被锁在面板外。替换后可用下面的命令验证链是否完整:

# 验证面板证书链与到期时间(替换为你的面板端口)
openssl s_client -connect 127.0.0.1:8888 -servername your.domain.com </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates
# 期望输出包含 issuer 为中间 CA,且 Verify return code: 0 (ok)

面板侧建议一次做完“三件套”,默认值与加固值对比如下:

项目 默认状态 加固建议 主要风险
面板端口 8888 改为 5 位非标端口,仅放行固定来源 全网扫描器首选目标
授权 IP 不限制 只允许公司出口 IP / 跳板机 IP 密码泄露即失守
SSH 登录 允许密码 PasswordAuthentication no,改用密钥 弱口令爆破
# 1) 私钥权限收紧:属主 root、权限 600,Nginx master 以 root 启动仍可读取
find /www/server/panel/vhost/cert -name 'privkey.pem' 
  -exec chown root:root {} ; -exec chmod 600 {} ;
ls -l /www/server/panel/vhost/cert/*/privkey.pem   # 应显示 -rw------- root root

# 2) 确认私钥没有落在 Web 根目录,避免被直接下载
find /www/wwwroot -name '*.pem' -o -name '*.key' 2>/dev/null

# 3) SSH 关闭密码登录(改完先测新会话再退出)
sed -i 's/^#?PasswordAuthentication.*/PasswordAuthentication no/' /etc/ssh/sshd_config
sed -i 's/^#?PermitRootLogin.*/PermitRootLogin prohibit-password/' /etc/ssh/sshd_config
sshd -t && systemctl reload sshd

协议与套件按 Mozilla Server Side TLS 的 intermediate 档收紧:禁用 TLS 1.0/1.1、RC4、3DES 与 CBC 套件。注意 TLS 1.3 的套件由 OpenSSL 自动管理,不要写进 ssl_ciphers;写错会触发 nginx: [emerg] SSL_CTX_set_cipher_list("...") failed (SSL: error:0A0000B9:SSL routines::no cipher match)。同时保留 ssl_prefer_server_ciphers off,让客户端择优,配合 TLS 1.3 性能更好;ssl_session_tickets off 可避免会话票据长期泄露导致前向安全性被削弱(RFC 8446 亦建议谨慎启用)。

# 站点 Nginx 配置(宝塔 7.x/8.x 均适用,写入站点 conf 的 server 块)
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
ssl_prefer_server_ciphers off;          # 默认 off,交给客户端择优
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;                 # 默认 on,建议关闭
add_header X-Content-Type-Options nosniff always;
add_header X-Frame-Options SAMEORIGIN always;
add_header Referrer-Policy strict-origin-when-cross-origin always;
# 改完执行:nginx -t && nginx -s reload

最后提醒一个常见误区:全站 HTTPS 不等于全站安全。若私钥权限是 644、面板 8888 仍对全网开放、SSH 还允许密码登录,攻击者根本不需要碰你的证书链。把面板入口、私钥权限、协议套件三层同时收紧,才是宝塔 SSL 证书配置真正完整的闭环。

九成是证书链不完整。手机端不会像桌面 Chrome 那样自动补中间证书,缺少中间证书时 Android 与微信内置浏览器会直接判定证书无效。用 openssl s_client -connect 域名:443 -servername 域名 -showcerts 检查返回证书数量,只有 1 张就把中间证书拼到站点证书后面重新上传。

面板会创建一个名为「续签Let's Encrypt证书」的计划任务,默认每天执行,在证书剩余约 30 天时自动续期并重载 Nginx。你需要额外确认的是:DNS API Token 未过期(通配符证书)、站点 80 端口可访问、验证目录未被 WAF 拦截。建议每季度手动点一次「执行」做演练。

主要是有效期、验证等级和售后。Let's Encrypt 是 DV 证书、90 天有效、无人工客服;商业 DV 通常 365 天,省掉续签频率;OV 需要核验企业营业执照,证书详情里带组织名,常见于政企与招投标场景。加密强度上两者没有区别,都是 2048 位 RSA 或 ECDSA P-256。

这是重定向循环,通常是源站和 CDN 同时开了强制 HTTPS,或 CDN 回源协议设为 HTTP 而源站又强制跳 HTTPS。处理方式:只在 CDN 侧开启强制跳转、把回源协议改为 HTTPS 跟随,或者在源站 Nginx 中判断 X-Forwarded-Proto 后再决定是否 301。

前者说明证书与私钥不是一对,用 openssl x509 -noout -modulus -in 证书.pem | openssl md5 和 openssl rsa -noout -modulus -in 私钥.key | openssl md5 比对两条 MD5 是否一致。后者说明文件格式不对,检查首行是否为 —–BEGIN CERTIFICATE—–,并去掉 BOM 头与 Windows 换行符(dos2unix)。

不是。网站 SSL 保护的是你站点域名(如 www.example.com:443),配置在 /www/server/panel/vhost/nginx/ 下;面板 SSL 保护的是宝塔管理后台(服务器IP:8888),在「面板设置 → 面板 SSL」中单独开启,两者证书互不通用。

先看是不是混合内容:Chrome DevTools → Console 过滤 Mixed Content,把页面里 http:// 引用的图片、JS、字体全部改成 https:// 或协议相对地址。其次确认 HSTS 是否生效(curl -sI https://域名 | grep -i strict-transport-security),最后用 MySSL.com 跑一次评级,看是否存在证书链或协议版本问题。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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