宝塔 SSL 证书部署怎么做?从证书文件准备到站点生效的 7 个检查点(Nginx 1.26)
宝塔 SSL 证书部署的核心是把包含中间链的 fullchain.pem 与私钥 privkey.pem 放到 /www/server/panel/vhost/cert/站点名/,在站点 conf 中让 ssl_certificate 指向它们,执行 /www/server/nginx/sbin/nginx -t && /www/server/nginx/sbin/nginx -s reload 后生效。 - 宝塔 9.x 默认站点证书目录为 /www/server/panel/vhost/cert/example.com/,privkey.pem 建议权限 600 root:root;据 OpenSSL 文档,可用 openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 比对 MD5 校验证书与私钥是否匹配。 - Nginx 1.26 的 443 server 块至少写 ssl_protocols TLSv1.2 TLSv1.3、ssl_certificate fullchain.pem、ssl_certificate_key privkey.pem;Mozilla SSL Configuration Generator 的 intermediate 配置可作为套件起点。 - 验证不要只看浏览器绿锁:curl -s -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://example.com 期望返回 200 0,openssl s_client -connect example.com:443 -servername example.com -showcerts 可检查证书链与 notAfter。
宝塔 SSL 证书部署后为什么仍提示不安全?先看 6 个根因
宝塔面板显示”已部署”只代表文件写进了配置,不代表浏览器信任。很多用户在宝塔ssl证书部署完成后刷新页面,地址栏仍是”不安全”或红色感叹号,于是怀疑面板有 bug——实际上按排查成本从低到高,90% 的情况落在下面 6 个根因里。每条都给出可直接复现的命令。
- 证书链缺失(最高频):只把域名证书粘进 PEM 框,没带中间 CA。旧版 Android(7.0 以下)、Java 8 客户端、部分 iOS 会直接报
unable to get local issuer certificate。# 返回张数 < 2 即说明链不完整(正常应为站点证书 + 中间证书) openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE" # 本地验证链 openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem据 Let’s Encrypt 官方文档,
fullchain.pem= 站点证书 + R10/R11 中间证书,privkey.pem是私钥;只上传cert.pem必然断链。宝塔面板”其他证书”里,PEM 框应粘贴fullchain.pem全文,KEY 框粘贴privkey.pem。 - 证书与私钥不匹配:换证书时私钥没跟着换。
# RSA 证书:两个 md5 必须完全一致 openssl x509 -in fullchain.pem -noout -modulus | openssl md5 openssl rsa -in privkey.pem -noout -modulus | openssl md5 # ECC 证书改用公钥比对(ECC 没有 modulus) openssl x509 -in fullchain.pem -pubkey -noout | openssl md5 openssl pkey -in privkey.pem -pubout | openssl md5不一致时 Nginx 1.26 会报
SSL_CTX_use_PrivateKey_file("/www/server/panel/vhost/cert/example.com/privkey.pem") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch),443 端口直接起不来,nginx -t也会失败。 - SNI 未命中:同 IP 部署多个站点时,不支持 SNI 的老客户端会拿到
default_server的证书。按 RFC 6066 规定,SNI 在 TLS 握手 ClientHello 阶段携带主机名,Nginx 必须为每个 443 的server块单独写server_name与ssl_certificate;验证方法是带与不带-servername各测一次,看返回的 subject 是否不同。 - 443 未放行或 CDN 回源走 80:边缘节点 HTTPS 正常、源站证书却没生效,通常是回源协议还是 HTTP。
# 本机放行(firewalld),云厂商安全组需另行放行 443/TCP firewall-cmd --add-service=https --permanent && firewall-cmd --reload # 绕开 CDN 直连源站,看 80 是否仍返回 200/301 curl -I http://1.2.3.4 -H "Host: example.com" - 强制 HTTPS 未开启或存在混合内容:面板”网站 → 设置 → SSL → 强制 HTTPS”未打开时,
http://仍可访问。页面加载http://的图片/JS 时,Chrome DevTools Console 会打印Mixed Content: The page at 'https://…' was loaded over HTTPS, but requested an insecure resource 'http://…',锁标随即消失。用curl -sI http://example.com | grep -i location确认是否返回 301 到 https。 - 证书目录路径或权限错误:宝塔 9.x 站点证书默认存放于
/www/server/panel/vhost/cert/example.com/。私钥建议600 root:root,证书644;若权限过严导致 Nginx worker 用户www读不到,error.log 会出现open() "…/privkey.pem" failed (13: Permission denied)。chown root:root /www/server/panel/vhost/cert/example.com/*.pem chmod 600 /www/server/panel/vhost/cert/example.com/privkey.pem chmod 644 /www/server/panel/vhost/cert/example.com/fullchain.pem nginx -t && systemctl reload nginx
| 文件名 | 内容 | 面板填写位置 | 缺失后果 |
|---|---|---|---|
| fullchain.pem | 站点证书 + 中间 CA | 证书(PEM 格式) | 旧客户端报 issuer 错误 |
| privkey.pem | 私钥(不加密) | 私钥(KEY 格式) | 443 无法启动 |
| cert.pem | 仅站点证书 | 不单独使用 | 链断裂 |
| chain.pem | 仅中间 CA | 不单独使用 | 需手动拼接 |
完成宝塔ssl证书部署后,建议再用 SSL Labs 或
openssl s_client -connect … -tls1_2复核一次协议版本与链完整性;Mozilla SSL Configuration Generator 给出的 Nginx 1.26 推荐配置可直接对照ssl_protocols TLSv1.2 TLSv1.3等指令。
宝塔 SSL 证书部署的完整实操步骤:从 CA 下载到强制 HTTPS(6 步)
证书压缩包解压出来一堆文件,到底该传哪几个、按什么顺序拼?这是宝塔 SSL 证书部署里最容易翻车的一步——顺序拼反不会报错,但安卓旧版本和部分微信内置浏览器会直接提示”证书无效”。下面按 6 步走,每一步都给出可复制命令;环境以宝塔 Linux 面板 9.x + Nginx 1.26 + OpenSSL 3.0.x 为例(面板 7.x 路径相同,仅界面按钮文案略有差异)。
| 压缩包内文件 | 实际内容 | 在 Nginx 中的用途 |
|---|---|---|
fullchain.pem |
叶子证书 + 中间 CA,顺序敏感 | 填 ssl_certificate |
privkey.key / privkey.pem |
RSA 2048 或 ECDSA P-256 私钥 | 填 ssl_certificate_key |
ca_bundle.crt / ca.crt |
中间证书(不含根) | 仅用于本地验证与拼接 |
example.com.crt |
仅叶子证书 | 拼接时放第一段 |
步骤 1:下载后 5 分钟内完成本地校验。商业证书的 example.com.crt 与 ca.crt 是分开的两个文件,先确认域名与有效期,别等上传后才发现 SAN 漏了 www:
# OpenSSL 1.1.1+ / 3.x 通用
openssl x509 -noout -subject -issuer -dates -in example.com.crt
# 期望:notAfter=May 30 23:59:59 2026 GMT,subject 的 CN 或 SAN 覆盖所有要用 HTTPS 的域名
openssl x509 -noout -text -in example.com.crt | grep -A1 "Subject Alternative Name"
步骤 2:合并证书链并验证。据 Let’s Encrypt 文档对 Chain of Trust 的说明,服务器必须下发中间证书,否则部分客户端无法补全链:
# 叶子证书在前,中间证书在后,顺序不能反
cat example.com.crt ca.crt > fullchain.pem
openssl verify -CAfile ca.crt fullchain.pem
# 期望输出:fullchain.pem: OK
# 常见报错:error 20 at 0 depth lookup: unable to get local issuer certificate
# 含义:ca.crt 不是该证书的签发者,或拼接顺序颠倒,需回 CA 控制台重下中间证书
步骤 3:写入面板证书目录。面板操作路径是「网站 → 设置 → SSL → 其他证书」,粘贴 fullchain.pem 与私钥全文;命令行等价操作如下,私钥权限 600、属主 root:root 是宝塔的默认约定,放宽到 644 会被部分安全扫描判为高危:
mkdir -p /www/server/panel/vhost/cert/example.com
cp fullchain.pem /www/server/panel/vhost/cert/example.com/
cp privkey.key /www/server/panel/vhost/cert/example.com/privkey.pem # 统一命名,与步骤 4 对应
cd /www/server/panel/vhost/cert/example.com
chown root:root privkey.pem && chmod 600 privkey.pem
chmod 644 fullchain.pem
步骤 4:核对站点 conf。443 的 server 块里必须同时出现两行绝对路径,缺一行 nginx -t 才会报错,而少写中间证书不会报错:
grep -nE "listen 443|ssl_certificate" /www/server/panel/vhost/nginx/example.com.conf
# ssl_certificate /www/server/panel/vhost/cert/example.com/fullchain.pem;
# ssl_certificate_key /www/server/panel/vhost/cert/example.com/privkey.pem;
步骤 5:先测再重载。不要用 restart,同机多站点会被瞬时中断;reload 是平滑加载新配置:
/www/server/nginx/sbin/nginx -t
# 期望:nginx: configuration file /www/server/nginx/conf/nginx.conf test is successful
/www/server/nginx/sbin/nginx -s reload
步骤 6:强制 HTTPS 与 HSTS 节奏。80 端口的 server 块需要有 301,别只依赖面板的”强制 HTTPS”开关:
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri; # $host 保留原域名,避免多域名跳错
}
若有 CDN,把回源协议改为 HTTPS 并上传回源证书,否则源站只认 443 会回源失败。HSTS 按 RFC 6797 属于不可逆策略,先用 add_header Strict-Transport-Security "max-age=300" always; 观察 24 小时,确认全站子域名都支持 HTTPS 后再调到 31536000。至此,一套可复用的宝塔 SSL 证书部署流程才算闭环。
配置与命令示例:Nginx 1.26 + 宝塔 9.2.0 的证书路径、权限与 TLS 参数
证书文件放哪、权限怎么设?
宝塔 9.2.0 通过 Let’s Encrypt 申请成功后,会把证书写到 /www/server/panel/vhost/cert/example.com/,其中 fullchain.pem 是叶子证书加中间链,privkey.pem 是私钥。手工上传的证书也建议落到同一路径:面板的 SSL 页面按这个路径回显状态,路径不一致时会出现”站点已生效但面板显示未部署”的错位。
# 1. 建目录,700 防止非 root 用户遍历
install -d -m 700 -o root -g root /www/server/panel/vhost/cert/example.com
# 2. 归位证书:fullchain 可 644,私钥必须 600 且属主 root
install -m 644 -o root -g root fullchain.pem /www/server/panel/vhost/cert/example.com/fullchain.pem
install -m 600 -o root -g root privkey.pem /www/server/panel/vhost/cert/example.com/privkey.pem
# 3. 确认结果应为 -rw------- 1 root root privkey.pem
ls -l /www/server/panel/vhost/cert/example.com/
为什么 600 不影响运行?Nginx 以 root 启动 master 进程、在启动阶段读取证书文件,worker 降权为 www 用户后不再碰私钥。反过来,私钥被改成 644 是最常见的泄露成因。
443 server 块到底要写哪几行?
server {
listen 443 ssl http2; # 1.26 仍兼容此写法;1.25.1+ 也可写 listen 443 ssl; + http2 on;
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; # TLS 1.3 见 RFC 8446,TLS 1.2 见 RFC 5246
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; # TLS 1.3 由客户端定套件,1.2 交给客户端更利于前向兼容
ssl_session_cache shared:SSL:10m; # 默认 none;1MB 约容纳 4000 个会话
ssl_session_timeout 10m; # 默认 5m
ssl_session_tickets off; # 默认 on;关闭可避免 ticket 密钥不轮换削弱前向安全
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
}
据 Mozilla SSL Configuration Generator(v5.7)的 intermediate 档,套件与协议组合与上面一致,差异是它默认 ssl_session_tickets off 且不写 http2 参数。HSTS 首次上线建议先写 max-age=300 观察 24 小时,确认无混合内容告警再升到 31536000:RFC 6797 规定浏览器在 max-age 内强制 https,中途回退只能等过期。
| 参数 | Nginx 1.26 默认值 | 推荐值 | 取舍理由 |
|---|---|---|---|
| ssl_protocols | TLSv1.2 TLSv1.3(1.23.4 起) | TLSv1.2 TLSv1.3 | 显式声明,避免沿用旧模板带出 TLSv1.0 |
| ssl_session_cache | none | shared:SSL:10m | 复用握手,省一次完整 RSA/ECDHE 开销 |
| ssl_session_timeout | 5m | 10m | 与 cache 容量匹配,过长易被占满 |
| ssl_session_tickets | on | off | ticket key 不轮换会削弱前向安全性 |
| ssl_prefer_server_ciphers | off | off | 服务端强选在移动端反而降低兼容性 |
怎么确认证书和私钥是配对的?
在 OpenSSL 3.0.13 下比对 modulus 的 MD5,两行必须完全一致,否则说明导出时张冠李戴,需重新导出:
cd /www/server/panel/vhost/cert/example.com
openssl x509 -in fullchain.pem -noout -modulus | openssl md5
openssl rsa -in privkey.pem -noout -modulus | openssl md5
# 输出形如 (stdin)= 1a2b3c4d...,两行须相同
如果证书是 ECDSA(Let’s Encrypt 现在默认签发 P-256),openssl rsa 会直接报 Unable to load Private Key,改用公钥比对:openssl pkey -in privkey.pem -pubout | openssl md5 与 openssl x509 -in fullchain.pem -pubkey -noout | openssl md5。不配对时 reload 会失败并打印:nginx: [emerg] SSL_CTX_use_PrivateKey_file("...privkey.pem") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。
改完怎么生效、出错怎么退?
cd /www/server/panel/vhost/nginx
cp example.com.conf example.com.conf.bak-$(date +%F) # 先备份
/www/server/nginx/sbin/nginx -t && /www/server/nginx/sbin/nginx -s reload
# 若 -t 报错,回滚并再次校验
cp example.com.conf.bak-2025-01-01 example.com.conf
/www/server/nginx/sbin/nginx -t && /www/server/nginx/sbin/nginx -s reload
务必在宝塔面板的”网站 → 配置文件”里改,而不是直接编辑磁盘文件:面板保存 SSL 设置时会重写 vhost 配置,手改内容可能在下次点击保存时被覆盖。这也是”宝塔ssl证书部署”后站点仍报证书错误的高频原因之一。
方案选型对比:宝塔自动申请、手动上传、CDN 回源与反向代理 TLS 怎么选
这四个方案并不互斥,它们作用在 HTTPS 链路上的不同环节:证书装在哪台机器、由谁负责续期、由谁校验对端身份。先用一张表看清区别,再逐个说明每个方案可执行的验证命令。
| 方案 | 证书保存位置 | 适用场景 | 续期与维护 | 成本参考(2025 年) | 关键参数 |
|---|---|---|---|---|---|
| 宝塔自动申请 Let’s Encrypt | /www/server/panel/vhost/cert/域名/ |
单站 DV、测试环境 | 90 天,面板计划任务续期 | 0 元/年 | 80 端口 HTTP-01、fullchain.pem |
| 手动上传商业证书 | 同上 | 通配符、OV/EV、支付站 | 到期前 30 天人工替换 | DV 0–300 元/年,OV 800–3000 元/年,EV 2000–8000 元/年 | 证书链完整、私钥 600 |
| CDN 边缘证书 + 回源 | CDN 控制台 + 源站证书目录 | 高并发、隐藏源站 | CDN 自动续期,源站需独立续期 | 按流量计费 | 回源 443、SNI、HSTS |
| 反向代理 upstream TLS | 后端证书 + proxy_ssl_* |
Node/Java 后端 HTTPS | 后端独立续期 | 后端证书成本 | proxy_ssl_verify on |
1. 宝塔自动申请 Let’s Encrypt 为什么在 80 端口被占时总是失败? 因为 ACME 的 HTTP-01 校验要求 CA 能从公网访问 http://域名/.well-known/acme-challenge/;据 Let’s Encrypt 文档,该方式只支持 80 端口,且不允许跳转到 HTTPS 之外的重定向链。证书默认写入面板的 vhost/cert 目录,续期由面板计划任务在到期前 30 天触发。当校验失败时,应按以下顺序检查:
# 宝塔面板 9.x:确认证书与私钥已生成,私钥权限必须是 600
ls -l /www/server/panel/vhost/cert/example.com/
# 预期输出:fullchain.pem privkey.pem
chmod 600 /www/server/panel/vhost/cert/example.com/privkey.pem
# 校验失败先看面板日志与站点 80 访问日志
tail -n 50 /www/server/panel/logs/panel_error.log
tail -n 50 /www/wwwlogs/example.com.log | grep acme-challenge
2. 手动上传商业证书最容易忽略什么? 是证书链。OV/EV 证书常见有效期为 1 年,替换前应先把整个证书目录打包备份,否则一旦传错就只能等重新签发。按照 RFC 5280 的路径校验规则,fullchain.pem 必须是「站点证书 + 中间 CA」,顺序颠倒会直接导致链验证失败。你看到的 curl: (60) unable to get local issuer certificate 就是缺少中间 CA 的典型报错。
# 合并顺序不能反:站点证书在前,中间 CA 在后
cat example.com.crt intermediate.crt > fullchain.pem
# 验证链完整性,输出 example.com: OK 才可上线
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
3. CDN 回源时源站证书要单独管吗? 要管。CDN 控制台的边缘证书续期与源站证书是两套独立流程,边缘证书自动更新不会改动源站证书。回源走 443 时,源站证书的 SAN 必须覆盖回源域名(很多站用 origin.example.com 回源,而证书只签了主域),并且要支持 SNI。据 Mozilla Server Side TLS 指南,回源段同样建议启用 HSTS 并禁用 TLS 1.0/1.1。
# 用 --resolve 模拟 CDN 回源,确认源站证书覆盖回源域名
curl -vI --resolve origin.example.com:443:203.0.113.10
https://origin.example.com/ 2>&1 | grep -E "subject|issuer|expire"
4. 反向代理到 HTTPS 后端,Nginx 默认不校验对端吗? 是的。proxy_ssl_verify 的默认值是 off,proxy_ssl_server_name 默认也是 off(自 Nginx 1.7.0 起支持),这意味着默认配置下 Nginx 既不校验证书,也不发送 SNI;后端使用多域名证书时会返回错误证书。Nginx 1.26 的推荐写法如下:
location /api/ {
proxy_pass https://127.0.0.1:8443;
proxy_ssl_server_name on; # 默认 off,发送 SNI
proxy_ssl_name api.internal; # 默认取 proxy_pass 中的主机名
proxy_ssl_verify on; # 默认 off,生产必须开
proxy_ssl_verify_depth 2; # 默认 1,需覆盖中间 CA 层级
proxy_ssl_trusted_certificate /etc/nginx/trust/ca.pem; # 后端自签 CA 的 trust store
}
后端用自签证书时,把 CA 放入 trust store 即可;关闭 proxy_ssl_verify 上线等于放弃对中间人攻击的防御,报错信息会是 upstream SSL certificate verify error: (20:unable to get local issuer certificate)。
选型判断标准:单站 DV 或测试环境选择面板自动申请,能省去全部运维;通配符、支付、需要展示组织信息的站点选择手动上传商业证书,并设置到期前 30 天提醒;流量大或需要隐藏源站 IP 时,选择 CDN 边缘证书 + 回源,且源站证书单独排期;后端为 Node/Java 且已开 HTTPS 的,选择 upstream TLS 并强制 proxy_ssl_verify on。混合场景(CDN + 源站反向代理)可以叠加,但每一段都要独立验证证书链与到期时间。
常见错误与真实报错:从 nginx -t 到浏览器提示怎么排
在宝塔里点完”部署”只代表文件写入了磁盘,真正生效与否要看 Nginx 的加载结果和握手结果。下面 6 条报错覆盖了 90% 以上的现场问题,每条都给出可直接复制的排查命令。宝塔的证书默认落在 /www/server/panel/vhost/cert/<站点名>/(含 fullchain.pem 与 privkey.pem),站点配置在 /www/server/panel/vhost/nginx/<站点名>.conf,以下命令均以 example.com 为例,环境为 Nginx 1.26 + OpenSSL 3.x。
Q1:nginx -t 报 SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) 怎么办?
这条错误 100% 是证书与私钥不是同一对——常见于从不同渠道分别下载了 crt 和 key,或续签后只替换了其中一个文件。先用公钥指纹比对确认:
# 1) 比对证书与私钥是否同源(RSA 证书用 modulus)
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
# 2) ECDSA 证书没有 modulus,改用公钥比对(Let's Encrypt 新证书默认 ECDSA P-256)
openssl x509 -noout -pubkey -in fullchain.pem | openssl md5
openssl pkey -pubkey -noout -in privkey.pem | openssl md5
# 3) 两个 md5 一致才算匹配;不一致就回证书签发处重新导出 fullchain.pem + privkey.pem,覆盖后重载
nginx -t && nginx -s reload
Q2:curl: (60) SSL certificate problem: unable to get local issuer certificate 是什么原因?
服务端只发了叶子证书、没带中间证书。据 Let’s Encrypt 文档,其证书链必须包含中间证书 R11/R12(或 ECDSA 链的 E5/E6),单独一张 domain.crt 必然导致部分客户端校验失败。拼接顺序是叶子在前、中间在后:
cat domain.crt ca.crt > fullchain.pem # 顺序不能反,根证书不要放进来
nginx -t && nginx -s reload
# 确认服务端返回 ≥2 张证书(1 张说明链路仍不完整)
echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null
| grep -c 'BEGIN CERTIFICATE'
Q3:浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID?
现代浏览器只看 SAN 扩展、不看 CN,所以 CN 写对但 SAN 缺失一样报错。另外泛域名 *.example.com 只覆盖一级子域,a.b.example.com 不在覆盖范围内(依据 RFC 6125 的通配符匹配规则)。
openssl x509 -in fullchain.pem -noout -text | grep -A1 'Subject Alternative Name'
Q4:NET::ERR_CERT_AUTHORITY_INVALID 换浏览器还在?
说明根 CA 不在客户端信任库:自签证书、内部 CA 签发、或链里混入了错误的中间证书。内部 CA 场景必须在每台客户端导入根证书,否则只是换个浏览器复现同样的问题。
Q5:控制台出现 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure element 'http://...'?
HTTPS 页面里混入了 HTTP 资源。宝塔只改 Nginx 配置,改不了模板里写死的地址,需要落到文件与数据库里搜:
grep -RIn --include='*.php' --include='*.html' --include='*.js' 'http://' /www/wwwroot/example.com
| grep -v 'w3.org|xmlns' # 排除 SVG/XML 命名空间这类误报
别忘了数据库正文、CDN 回源地址、以及主题设置里保存的绝对路径,这三处是最常见的漏网之鱼。
Q6:反向代理报 upstream SSL certificate verify error: (20:unable to get local issuer certificate) while SSL handshaking to upstream?
这是 Nginx 作为客户端去校验后端证书时失败——后端同样缺中间证书,或者 proxy_ssl_trusted_certificate 指向了错误的 CA 包:
location /api/ {
proxy_pass https://backend;
proxy_ssl_server_name on; # 发送 SNI,默认 off
proxy_ssl_name backend.internal; # 与后端证书 SAN 对齐
proxy_ssl_verify on; # 默认 off,开启后才校验证书
proxy_ssl_verify_depth 2; # 默认 1,链深不够会报 20/21
proxy_ssl_trusted_certificate /www/server/panel/vhost/cert/backend/fullchain.pem;
}
| 报错关键词 | 根因 | 一条命令定位 | 修复动作 |
|---|---|---|---|
| key values mismatch | 证书/私钥不成对 | openssl x509 -noout -pubkey 比对 |
重新导出 fullchain + privkey |
| unable to get local issuer certificate | 缺中间证书 | openssl s_client -showcerts 数证书张数 |
拼接 fullchain,≥2 张 |
| COMMON_NAME_INVALID | SAN 不含该域名 | grep -A1 'Subject Alternative Name' |
重签含该域名的证书 |
| AUTHORITY_INVALID | 自签或根 CA 未受信 | 浏览器查看证书链 | 装完整链 / 客户端导入根证书 |
| Mixed Content | 页面硬编码 http:// | grep -RIn 'http://' |
改模板、数据库、CDN 回源 |
| upstream … verify error (20) | 反代后端链不全 | 看 Nginx error.log | 补 fullchain 或指定 trusted_certificate |
排障顺序建议固定为:nginx -t(语法与密钥匹配)→ openssl s_client(链路完整性)→ curl -vI https://example.com(本地信任库视角)→ 浏览器控制台(SAN 与混合内容)。前三步在服务器上就能闭环,比反复刷新浏览器快得多。这也是判断一次宝塔 SSL 证书部署是否真正成功的最短路径。
效果验证:5 条命令确认宝塔 SSL 证书部署真的生效
证书部署完、面板显示”已部署”,并不等于链路上真的可信——最常见的翻车场景就是 nginx -t 通过、浏览器却报”证书链不完整”。下面 5 条命令按”从 Nginx 自身到客户端”的顺序排列,逐条执行即可判断这次宝塔 SSL 证书部署是否真正生效。
检查点 1:Nginx 语法与 master 进程稳定性
# 宝塔自带二进制路径固定为 /www/server/nginx/sbin/nginx,1.26 版本同样适用
/www/server/nginx/sbin/nginx -t
# 期望输出:nginx: configuration file /www/server/nginx/conf/nginx.conf test is successful
# 进程检查:master PID 若在几十秒内反复变化,说明有崩溃重启
ps -ef | grep nginx | grep -v grep
只有 syntax is ok 与 test is successful 同时出现,配置才被内核加载;若只 reload 未 reload 成功,旧证书仍在内存里跑。
检查点 2:证书链、SAN 与有效期
# -servername 必须带,否则多站点同 IP 会拿到默认站点的证书
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| openssl x509 -noout -subject -issuer -dates
核对三点:subject 的 CN/SAN 是否包含你的域名;issuer 是否为 Let’s Encrypt R10/R11、E5/E6 等中间证书;notAfter 是否晚于当前日期。据 OpenSSL 文档,-servername 用于发送 SNI 扩展,缺省时握手可能命中错误站点。Let’s Encrypt 签发的证书必须使用 fullchain.pem(含中间证书),只用 cert.pem 是链验证失败的根因。
检查点 3:验证结果码
curl -s -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://example.com
# 期望:200 0;非 0 即链验证失败
检查点 4:HSTS 响应头
curl -sI https://example.com | grep -i strict-transport-security
# 期望:strict-transport-security: max-age=31536000
RFC 6797 定义的 HSTS 需一年(31536000 秒)才有实际防护意义。无输出通常是 add_header 没写进 443 的 server 块,或该 location 内另有 add_header 导致父级指令不再继承。
检查点 5:OCSP Stapling 与 TLS 1.3
openssl s_client -connect example.com:443 -servername example.com -status /dev/null
| grep -A1 'OCSP Response Status' # 期望 successful
openssl s_client -tls1_3 -connect example.com:443 /dev/null | grep -E 'Protocol|Cipher'
Stapling 依赖 nginx.conf 中 ssl_stapling on、ssl_stapling_verify on 与可用 resolver,默认关闭。最后用浏览器 DevTools → Security 看 “Certificate – valid and trusted”,再到 SSL Labs 交叉验证,避免单一客户端缓存误导结论。
| 异常现象 | 最可能原因 | 优先排查 |
|---|---|---|
| ssl_verify_result 非 0 | 缺中间证书 / 系统时间偏差 | 改用 fullchain.pem,核对 date -u |
| HSTS 无输出 | add_header 位置错误或被覆盖 | 检查 443 server 块与 location 继承 |
| OCSP Status 为空 | stapling 未开或 resolver 不可达 | 补 resolver 8.8.8.8 后 reload |
部署后的运维清单:续期、备份、回滚与权限巡检怎么做
Q:宝塔里证书装完、浏览器显示小锁,是不是就完事了?
A:不是。据 Let’s Encrypt 官方文档,其证书有效期固定 90 天,且官方已停止发送到期提醒邮件,这意味着一次成功的宝塔 SSL 证书部署只是起点,真正的事故都发生在“忘了续、改错了、私钥被人读走”这三种场景里。下面五项按发生概率从高到低排列。
Q1:Let’s Encrypt 证书怎么做到“不断链”?
A:别依赖面板的自动续签开关,用计划任务做显式检查。宝塔「计划任务 → Shell 脚本 → 每天 01:30」写入:
# 判断 fullchain.pem 是否将在 30 天内过期(退出码 1 = 需要续期)
CERT=/www/server/panel/vhost/cert/example.com/fullchain.pem
openssl x509 -in "$CERT" -noout -enddate
openssl x509 -in "$CERT" -noout -checkend $((30*86400)) || echo "SSL 剩余不足 30 天,请续期"
手动续期走「网站 → SSL → Let’s Encrypt → 续签」,或直接调用 acme.sh(宝塔内置于 /root/.acme.sh):~/.acme.sh/acme.sh --renew -d example.com --force。续期完成后必须执行 nginx -t && nginx -s reload——reload 向 master 进程发 HUP 平滑重载、不丢连接,而只点面板「重启」会中断现有请求,且部分版本重启顺序会让旧证书残留在 worker 中。
Q2:商业证书替换后想回滚怎么办?
A:替换前先整目录快照,旧证书至少留 7 天:
cd /www/server/panel/vhost/cert
cp -a example.com example.com.bak-$(date +%F) # 备份当前证书夹
# 回滚:覆盖回去再平滑重载
cp -a example.com.bak-2025-05-01/. example.com/ && nginx -t && nginx -s reload
Q3:备份只备站点 conf 够不够?
A:不够,证书夹必须一起打包,否则换机器时私钥对不上:
tar czf /root/bt-ssl-backup-$(date +%F).tgz
/www/server/panel/vhost/nginx/example.com.conf
/www/server/panel/vhost/cert/example.com/
chmod 600 /root/bt-ssl-backup-*.tgz # 含 privkey.pem,绝不能留 644
Q4:怎么巡检私钥权限?
A:这是宝塔 SSL 证书部署中最容易被忽略的一环——面板某些版本或手动上传后,私钥可能变成 644 或属主 www:
find /www/server/panel/vhost/cert -name privkey.pem -exec stat -c '%a %U:%G %n' {} +
# 期望输出:600 root:root /www/server/panel/vhost/cert/example.com/privkey.pem
find /www/server/panel/vhost/cert -name privkey.pem -exec chmod 600 {} +
find /www/server/panel/vhost/cert -name privkey.pem -exec chown root:root {} +
Q5:怎么在用户投诉前发现证书失效?
A:把下面这条加入拨测(curl 7.52+ 支持 %{ssl_verify_result},0 表示证书链校验通过):
curl -s -o /dev/null -w '%{http_code} %{ssl_verify_result} %{time_total}n' https://example.com
# 正常输出示例:200 0 0.132
连续 3 次非 200 或 verify_result 非 0 即告警,能覆盖“证书过期”“中间证书缺失”“SNI 配错”三类典型故障。
| 证书类型 | 有效期 | 续期方式 | 巡检频率 | 回滚窗口 |
|---|---|---|---|---|
| Let’s Encrypt | 90 天 | 计划任务 + 手动续签 | 每天 | 旧文件保留 7 天 |
| 商业 DV/OV | 最长 398 天(CA/B Forum 规定,2026 年起分阶段缩短至 47 天) | 人工替换 | 到期前 30 天日历提醒 | 同上 |
先看宝塔网站设置里的强制 HTTPS 是否开启,再检查 80 server 块是否有 return 301 https://$host$request_uri;。若用了 CDN,还要确认 CDN 的 HTTPS 配置与回源协议,否则源站 443 正常但用户仍走 HTTP。
宝塔面板的“其他证书”粘贴框通常接收 PEM 文本:fullchain.pem 与 privkey.pem。若 CA 只给 PFX,可执行 openssl pkcs12 -in cert.pfx -nodes -out all.pem 后拆分证书与私钥,再分别粘贴。
单站 DV、测试环境优先用宝塔自动申请,90 天有效期且续期自动化;支付、品牌、需要 OV/EV 组织信息或通配符长期稳定时,选手动上传商业证书,到期前 30 天替换。成本上 DV 约 0–300 元/年,OV 约 800–3000 元/年,EV 约 2000–8000 元/年。
这是证书与私钥不匹配。分别执行 openssl x509 -in fullchain.pem -noout -modulus | openssl md5 和 openssl rsa -in privkey.pem -noout -modulus | openssl md5,两行 MD5 不一致就重新从 CA 导出配对文件,再 nginx -t 与 reload。
泛域名证书只覆盖一级子域,例如 *.example.com 覆盖 a.example.com,不覆盖 a.b.example.com。宝塔里每个子站点仍需绑定对应域名并指向同一张证书,SNI 才会返回正确证书。
在站点 conf 的 location 中加 proxy_ssl_server_name on;、proxy_ssl_verify on;、proxy_ssl_trusted_certificate /path/ca.pem;,后端证书要含中间链。若后端是自签,先把自签 CA 加入 trust store,不建议用 proxy_ssl_verify off 长期运行。
常见原因是证书已过期、客户端系统时间错误、中间证书缺失或 CDN 边缘证书未更新。先用 openssl s_client -connect example.com:443 -servername example.com 看 notBefore/notAfter,再检查 CDN 控制台证书到期时间与源站证书是否一致。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。