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

宝塔 SSL 证书部署怎么做?从证书文件准备到站点生效的 7 个检查点(Nginx 1.26)

宝塔ssl证书部署 — 宝塔 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 个根因里。每条都给出可直接复现的命令。

  1. 证书链缺失(最高频):只把域名证书粘进 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。

  2. 证书与私钥不匹配:换证书时私钥没跟着换。
    # 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 也会失败。

  3. SNI 未命中:同 IP 部署多个站点时,不支持 SNI 的老客户端会拿到 default_server 的证书。按 RFC 6066 规定,SNI 在 TLS 握手 ClientHello 阶段携带主机名,Nginx 必须为每个 443 的 server 块单独写 server_name 与 ssl_certificate;验证方法是带与不带 -servername 各测一次,看返回的 subject 是否不同。
  4. 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"
  5. 强制 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。
  6. 证书目录路径或权限错误:宝塔 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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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