宝塔 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 分钟内定位。
- 配置没真正写进 vhost。宝塔 8.x/9.x 的站点配置在 /www/server/panel/vhost/nginx/你的域名.conf,SSL 段被 #SSL-START 与 #SSL-END 包裹。手工改过该文件、或整站从旧服务器迁移时,这个区块可能已被删掉,面板却依旧显示「已部署」。查运行时配置(nginx -T)比看面板可靠。
- 证书链缺失。只贴站点证书、没带中间证书时,桌面浏览器会自动补齐,看起来正常;但 Android 7 及以下、微信内置浏览器、Java 8 的 HttpsURLConnection 会直接报错。据 RFC 5246 §7.4.2,certificate_list 中每张证书必须直接签发前一张;Let’s Encrypt 文档也明确要求部署 fullchain.pem 而非 cert.pem。
- 证书与私钥不匹配。多因从不同订单复制了 KEY,或 PEM 被编辑器插入 BOM、中文注释、多余空行。Nginx reload 时会报 SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) 并拒绝加载。
- 混合内容(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 分钟。触发 NET::ERR_CERT_DATE_INVALID 或 OCSP 校验失败。timedatectl status 里 System clock synchronized 应为 yes;否则执行 chronyc makestep(chrony)或 ntpdate -u ntp.aliyun.com。
- 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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。