宝塔 SSL 证书安装全流程:上传、部署、强制 HTTPS 与排错(2025 实操版)
宝塔 SSL 证书安装的核心是:在 网站→设置→SSL 中上传 fullchain.pem 与 privkey.pem,保存后执行 nginx -t && nginx -s reload,并开启强制 HTTPS;Let's Encrypt 证书有效期 90 天。 证书链必须用 fullchain.pem;只放 domain.crt 常见报错是 curl: (60) unable to get local issuer certificate。 Nginx 1.24 建议只开 TLSv1.2/TLSv1.3,配置 ssl_session_cache shared:SSL:10m,HSTS 先 max-age=300 再升到 31536000。 验证命令:openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt 应返回 Verify return code: 0 (ok)。 商业 DV 单域常见 0-300 元/年,通配符 300-1500 元/年,OV 800-3000 元/年;价格随服务商浮动,宝塔 SSL 证书安装流程相同。
宝塔 SSL 证书安装后为什么仍提示不安全?5 个根本原因与判断命令
证书装完浏览器仍标红”不安全”,问题往往不在证书本身,而在证书链、SAN 字段、443 可达性、部署位置或回源协议这五个环节。先用一张表按现象定位,再逐条给判断命令——下面所有命令均在 Nginx 1.24 + 宝塔 9.x(CentOS 7 / Ubuntu 22.04)实测通过。
| 报错现象 | 根本原因 | 一条命令定位 |
|---|---|---|
curl: (60) unable to get local issuer certificate |
只传了 domain.crt,缺中间证书 | openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem |
NET::ERR_CERT_COMMON_NAME_INVALID |
证书 SAN 不含 www 或实际访问域名 | openssl x509 -in cert.pem -noout -text | grep -A1 'Subject Alternative Name' |
ERR_CONNECTION_REFUSED / ERR_SSL_PROTOCOL_ERROR |
443 未监听、安全组或防火墙未放行 | ss -lntp | grep ':443' |
| 换域名访问正常、主站异常 | 把网站证书装进了面板 SSL | openssl s_client -connect 域名:443 -servername 域名 |
ERR_TOO_MANY_REDIRECTS / 混合内容 |
CDN 回源走 HTTP(Flexible 模式) | curl -sSI http://域名 | head -3 |
1. 证书链不完整——最常见,占一半以上
Nginx 的 ssl_certificate 必须指向 fullchain.pem(站点证书 + 中间证书拼接),只上传 domain.crt 时浏览器和 curl 都拿不到签发者。据 Let’s Encrypt 官方文档,fullchain.pem 就是”证书 + 中间证书”的完整链文件。注意 openssl x509 -in fullchain.pem -noout -subject 只读叶子证书主题,不能替代链检查,必须用 verify:
# 完整链 → OK;单证书 → error 20
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
# fullchain.pem: OK
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt domain.crt
# CN = example.com
# error 20 at 0 depth lookup: unable to get local issuer certificate
# 宝塔生成的站点配置应长这样(路径固定)
grep -n '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;
# ssl_protocols TLSv1.2 TLSv1.3; # 宝塔 9.x 默认值
2. 域名不匹配:SAN 里没有 www 怎么办?
自 CA/Browser Forum 于 2017 年弃用 CN 字段后,浏览器只认 SAN 扩展。若 SAN 只有裸域,宝塔 SSL 证书安装后访问 www 仍会告警:
openssl x509 -in cert.pem -noout -text | grep -A1 'Subject Alternative Name'
# X509v3 Subject Alternative Name:
# DNS:example.com ← 只有裸域,www 必然报错
# 重新签发(Let's Encrypt 免费证书一条命令补全两个域名)
certbot certonly --webroot -w /www/wwwroot/example.com
-d example.com -d www.example.com
3. 443 没监听或没放行,怎么快速确认?
ss -lntp | grep ':443'
# LISTEN 0 511 0.0.0.0:443 0.0.0.0:* users:(("nginx",pid=1234,fd=8))
# 无输出 → Nginx 未监听 443,检查站点是否启用 SSL 或 nginx -t 是否报错
firewall-cmd --add-service=https --permanent && firewall-cmd --reload # CentOS/RHEL/AlmaLinux
ufw allow 443/tcp # Debian/Ubuntu
三层都要开:云厂商安全组 TCP 443、系统防火墙、宝塔面板「安全」页放行 443。若 ss 有监听但仍报 ERR_SSL_PROTOCOL_ERROR,多半是该 server 块只写了 listen 443; 却漏了 ssl 参数或证书路径写错,看 /www/server/nginx/logs/error.log 会有 cannot load certificate。
4. 面板 SSL 和网站 SSL 是一回事吗?
不是。面板 SSL 只保护 8888 或你自定义的面板端口,装到「面板设置 → SSL」里对站点 443 完全无效;网站证书必须在网站 → 设置 → SSL → 其他证书粘贴或上传。用 s_client 可验证 443 上真正下发的证书:
cat /www/server/panel/data/port.pl # 面板端口,例如 8888
openssl s_client -connect example.com:443 -servername example.com /dev/null
| openssl x509 -noout -subject -issuer -dates
5. CDN 回源还是 HTTP,为什么会重定向循环?
Cloudflare 的 Flexible 模式下,CF 用 HTTP 回源、源站又 301 跳 HTTPS,浏览器就在两者之间死循环,典型报错 ERR_TOO_MANY_REDIRECTS。应改为 Full (strict),源站 443 配有效证书(含中间证书),并让 Nginx 的 80 跳转只在非回源场景生效:
curl -sSI http://example.com | head -3
# HTTP/1.1 301 Moved Permanently
# Location: https://example.com/ ← Flexible 模式下即死循环
nginx -t && nginx -s reload # 改完配置先测语法再平滑重载
tail -n 50 /www/server/nginx/logs/error.log
改完别急着刷新:Chrome 会缓存 HSTS,去 chrome://net-internals/#hsts 的 Delete domain security policies 里删掉该域名,否则旧策略仍强制 HTTPS 并沿用旧证书状态。
宝塔 SSL 证书安装完整实操步骤:6 步从上传到强制 HTTPS
第 1 步:先核对环境,避免“装完不生效”。登录宝塔 Linux 面板 8.0.x / 9.0.x 后,先在终端确认三件事:OpenSSL 版本(决定能否直接处理 ECC/P-256 证书)、Nginx 版本(1.22 与 1.24 的 ssl_protocols 默认值不同),以及 vhost 目录位置。宝塔 9.0 默认自带 OpenSSL 3.0.x,据 OpenSSL 官方文档,3.0 起不再默认加载旧版 TLS 1.0/1.1 相关算法,因此老证书若用 SHA-1 签名会直接握手失败。
# 适用:宝塔 Linux 面板 8.0.x / 9.0.x,CentOS 7+ / Ubuntu 20.04+ / Debian 11+
openssl version # 期望 OpenSSL 3.0.x
nginx -v # 期望 nginx/1.22.x 或 nginx/1.24.x
ls -l /www/server/panel/vhost/nginx/ # 站点 vhost 存放目录,排错时必看
第 2 步:上传证书,认准两个文件。进入 网站 → 设置 → SSL → 其他证书,粘贴 fullchain.pem(必须以 -----BEGIN CERTIFICATE----- 开头,且包含服务器证书 + 中间链)与 privkey.pem(以 -----BEGIN PRIVATE KEY----- 或 -----BEGIN RSA PRIVATE KEY----- 开头)。不要直接粘 .pfx,宝塔不解析 PKCS#12;只有 pfx 时先拆分:
# 私钥权限收紧,宝塔面板与 Nginx 均以 root 运行
chmod 600 /www/wwwroot/example.com/privkey.pem
chown root:root /www/wwwroot/example.com/privkey.pem
# 仅当手上只有 .pfx 时执行(-nodes = 私钥不加密,便于 Nginx 免密读取)
openssl pkcs12 -in cert.pfx -nodes -out all.pem
# all.pem 内含 私钥+叶子证书+中间链,需按 BEGIN 块顺序拆成 privkey.pem 与 fullchain.pem
grep -c "BEGIN CERTIFICATE" all.pem # 结果应 ≥2,为 1 说明缺中间链
| 文件形态 | 宝塔能否直接粘贴 | 处理方式 |
|---|---|---|
| fullchain.pem + privkey.pem | 可以 | 直接贴入“其他证书” |
| cert.pfx / .p12 | 不可以 | openssl pkcs12 拆分 |
| 仅叶子 crt + ca-bundle | 需拼接 | cat cert.crt ca-bundle.crt > fullchain.pem |
| 仅叶子 crt(无中间链) | 不可 | 浏览器报“证书链不完整”,须补链 |
第 3 步:保存并“部署”到站点。多域名或通配符证书可在 证书夹 中选同一张证书复用,省去重复上传。务必确认站点 server_name 同时包含 example.com www.example.com,并与证书 SAN 列表逐项一致——少了 www 就是最常见的“主域正常、www 报错”。注意:宝塔 SSL 证书安装后必须点 部署,否则证书只存在证书夹里,不会写入 vhost 配置。
第 4 步:开启强制 HTTPS。开启后宝塔会向 vhost 写入 301,可直接检查:
grep -nE "return 301|rewrite .* permanent" /www/server/panel/vhost/nginx/example.com.conf
# 期望出现:return 301 https://$host$request_uri;
# 或: rewrite ^(.*)$ https://$host$1 permanent;
若站点前置了 CDN,先把 CDN 回源协议切成 Full (strict) 再开强制跳转,否则回源仍是 HTTP,形成 301 循环(浏览器报 ERR_TOO_MANY_REDIRECTS)。
第 5 步:校验配置并重载。据 Nginx 官方文档,nginx -t 只做语法与证书可读性检查,不生效,必须再 reload:
nginx -t # 期望:syntax is ok / test is successful
nginx -s reload # 平滑重载,不断连接
# Apache 环境(宝塔 Apache 2.4)
httpd -t && systemctl reload httpd
# 失败时按顺序看两个日志
tail -n 50 /www/server/nginx/logs/error.log
tail -n 50 /www/wwwlogs/example.com.error.log # 常见:SSL_CTX_use_PrivateKey key values mismatch
第 6 步:设置续期,别等过期。据 Let’s Encrypt 官方文档,其证书有效期固定 90 天,宝塔计划任务会每日检查并自动续期,可在 计划任务 中确认该任务处于启用状态。手动商业证书建议提前 30 天续费,替换时同时更新 fullchain.pem 与 privkey.pem,再执行一次 nginx -t && nginx -s reload;切勿只替换叶子 crt 而保留旧中间链,否则部分安卓与旧版 Java 客户端会因链不匹配报 unable to get local issuer certificate。
宝塔 SSL 证书安装后的配置示例:Nginx 1.24、Apache 2.4 与 TLS 参数
问:宝塔面板里点了”强制 HTTPS”之后,还要不要手写 Nginx/Apache 配置?
要,但要分清边界。宝塔的”强制 HTTPS”只做两件事:在 443 的 server 块里加 ssl_certificate / ssl_certificate_key,以及加一条 80 端口到 443 的 301 跳转。TLS 协议版本、密码套件、HSTS、OCSP Stapling 这些都不在它的管辖范围内,所以宝塔 SSL 证书安装完成后,仍需要按下面片段补齐安全参数。注意:宝塔写的是 /www/server/panel/vhost/nginx/example.com.conf(Apache 在 /www/server/panel/vhost/apache/),你手写的片段应放在同一文件内,不要另建一个监听 443 的 conf——Nginx 按加载顺序取最后一个匹配的 server 块,重复定义会出现”改了不生效”的假象。
问:Nginx 1.24 的最小可用安全片段长什么样?
# 文件:/www/server/panel/vhost/nginx/example.com.conf
server {
listen 443 ssl http2; # Nginx 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;
# Mozilla intermediate 档:只开 1.2/1.3(TLSv1.3 由 RFC 8446 定义,需 OpenSSL 1.1.1+)
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';
ssl_prefer_server_ciphers off; # TLSv1.3 下套件顺序由客户端决定,开 on 无收益
ssl_session_cache shared:SSL:10m; # 约 4 万会话,默认 none
ssl_session_timeout 10m;
add_header Strict-Transport-Security "max-age=31536000" always; # 首轮先写 300,见下文
}
宝塔 8.x 自带的 OpenSSL 通常已是 3.0.x,nginx -V 2>&1 | grep -o 'OpenSSL [0-9.]*' 可直接确认;若低于 1.1.1,TLSv1.3 根本不会生效,配置不报错但降级到 1.2。
问:OCSP Stapling 到底要不要开?
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /www/server/panel/vhost/cert/example.com/fullchain.pem; # 必须含根+中间
resolver 223.5.5.5 119.29.29.29 valid=300s; # 不配 resolver,stapling 静默失效
resolver_timeout 5s;
据 Let’s Encrypt 官方公告,其已宣布逐步停用 OCSP 响应服务、转向 CRL(短期证书 + CRL 分发),因此 Let’s Encrypt 证书开启 stapling 后可能长期处于 “OCSP response not present” 状态——这不影响握手,只是没有收益。开启前先看 CA 公告;商业证书(DigiCert、Sectigo)仍值得开。验证命令:
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null | grep -E 'OCSP Response Status|Protocol|Cipher'
# 期望:OCSP Response Status: successful (0x0);若为 "no response sent" 说明 stapling 未生效
问:Apache 2.4.6+ 怎么写?
<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 -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
SSLHonorCipherOrder off
# Header 指令需 mod_headers;宝塔默认已启用,否则报 "Invalid command 'Header'"
Header always set Strict-Transport-Security "max-age=31536000"
# 如需 stapling:SSLUseStapling on + 全局 SSLStaplingCache "shmcb:logs/ssl_stapling(32768)"
</VirtualHost>
| 能力 | Nginx 1.24 指令 | Apache 2.4 指令 | 默认值 / 说明 |
|---|---|---|---|
| 协议版本 | ssl_protocols |
SSLProtocol |
Nginx 默认 TLSv1 TLSv1.1 TLSv1.2,必须显式收紧 |
| 密码套件 | ssl_ciphers |
SSLCipherSuite |
Nginx 默认 HIGH:!aNULL:!MD5 |
| 服务端优先 | ssl_prefer_server_ciphers |
SSLHonorCipherOrder |
Nginx 默认 off;Apache 默认 off |
| HSTS | add_header |
Header always set |
无默认,需 mod_headers |
问:改完怎么确认没被覆盖、没写错?
nginx -t # 语法检查,报错会指出具体行号
nginx -T 2>/dev/null | grep -nE 'ssl_certificate|ssl_protocols|Strict-Transport' # 看合并后的最终配置
apachectl configtest && apachectl -S # -S 列出所有 VirtualHost 及加载顺序
systemctl reload nginx # 或 apachectl graceful
典型报错对照:nginx: [emerg] PEM_read_bio_X509_AUX() failed 多为证书链文件被编辑器改坏;SSL_CTX_use_PrivateKey_file() failed ... key values mismatch 说明证书与私钥不是一对;nginx: [warn] the "listen ... http2" directive is deprecated 出现在 1.25.1+,改为 listen 443 ssl; + http2 on;。协议是否真的禁用了旧版本,用 openssl s_client -connect example.com:443 -tls1 验证,期望返回 alert protocol version 或 no protocols available。
问:HSTS 能不能一次拉满?
不建议。HSTS 是浏览器侧的强制策略,一旦下发 max-age=31536000,回滚窗口长达一年。稳妥路径:先 add_header Strict-Transport-Security "max-age=300" always; 观察 1–2 天,确认全站资源(含 CDN、图床、API 子域)都能走 HTTPS,再升到 31536000。加 includeSubDomains 会让所有子域强制 HTTPS,任一子域没有证书即整站不可达;preload 需向浏览器厂商提交列表,移除周期以月计。这也是为什么宝塔 SSL 证书安装只是起点,HSTS 的分阶段灰度才是长期运维动作。
宝塔 SSL 证书安装选哪种证书?Let's Encrypt、DV、OV 与通配符对比表
结论先给:个人站和测试环境用 Let’s Encrypt DV 就够,多子域优先通配符,只有当你需要合同主体、赔付条款或合规审计时才上 OV/EV。价格与形态差异如下(2025–2026 年国内云厂商与 CA 代理常见报价,实际以合同为准):
| 方案 | 价格区间 | 有效期 | 验证方式 | 适合场景 | 宝塔 SSL 证书安装方式 |
|---|---|---|---|---|---|
| Let’s Encrypt DV | 0 元 | 90 天 | HTTP-01 / DNS-01 | 个人站、测试 | 面板一键申请,自动续期 |
| 商业 DV 单域 | 0–300 元/年 | 1 年 | DNS / 文件 | 小型企业站 | 上传 fullchain + key |
| 商业 DV 通配符 | 300–1500 元/年 | 1 年 | DNS TXT | 多子域 | 上传到证书夹并部署 |
| OV 单域 | 800–3000 元/年 | 1 年 | 企业资料 + DNS | 政企、商城 | 上传完整链,保留验证记录 |
| EV | 2000–8000 元/年 | 1 年 | 严格企业验证 | 金融、品牌 | 同上,浏览器已不显示绿条 |
DV 和 Let’s Encrypt 的加密强度有区别吗?没有。两者都是 2048 位 RSA 或 ECDSA P-256,TLS 握手与数据加密完全一致,差异只在有效期、保障额度、技术支持与吊销响应速度。证书类型不改变加密算法,这一点在 OpenSSL 文档与 CA/Browser Forum Baseline Requirements 中都是明确约束。
通配符证书为什么部署完还报 NET::ERR_CERT_COMMON_NAME_INVALID?因为 *.example.com 只匹配一级子域,既不覆盖裸域 example.com,也不覆盖 a.b.example.com。宝塔 SSL 证书安装前务必先核对 SAN 列表,别等部署完再猜:
# 宝塔 Let's Encrypt 证书默认落在 /www/server/panel/vhost/cert/<域名>/
# 商业证书上传后一般也在此目录,fullchain.pem 为证书链、privkey.pem 为私钥
openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem
-noout -text | grep -A1 'Subject Alternative Name'
# 期望输出(裸域与通配符必须同时出现,缺一即不匹配)
# X509v3 Subject Alternative Name:
# DNS:*.example.com, DNS:example.com
# 同时确认有效期与签发者,排查是否上传了旧证书
openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem
-noout -dates -subject -issuer
签发时就把裸域和 *.example.com 一起勾上,比事后返工便宜得多。
面板一键申请 Let’s Encrypt 一直失败怎么办?Let’s Encrypt 走 RFC 8555 定义的 ACME 协议,证书固定 90 天。HTTP-01 校验要求 80 端口从公网可达,DNS-01 则通过 TXT 记录校验、并且是唯一能签通配符的方式。据 Let’s Encrypt 官方文档,失败最常见的原因是 80 端口被安全组或防火墙拦截、DNS 尚未生效、以及域名挂在 CDN 后面导致校验请求被代理转发。排错顺序是:
# 1. 确认 80 端口从外部可达(在另一台机器上执行)
curl -I http://example.com/.well-known/acme-challenge/test
# 2. 确认解析指向本机,而非 CDN 回源地址
dig +short example.com A
# 3. 校验期间临时关闭 CDN 代理(橙云改灰云),或改用 DNS-01 模式
# 切勿长期关闭 80 端口,否则续期同样会失败
OV/EV 值得买吗?OV/EV 只增加企业身份审核,不改变 TLS 加密强度;浏览器早已取消 EV 绿色地址栏,UI 上几乎没有差异。金融、政企按合规要求选,普通站点没必要为绿条买单——预算放到监控告警和异地备份更实际。
- 个人站/测试:Let’s Encrypt,面板一键申请并开启自动续期。
- 多子域:商业通配符,或用 LE 的 DNS-01 模式免费签通配符。
- 有合同、赔付或等保要求:OV,并保留企业验证记录备查。
- 不要购买所谓”终身证书”:CA/Browser Forum 对公开信任证书的有效期设有上限,宝塔 SSL 证书安装完成后仍必须按期续期,否则到期即全站告警。
宝塔 SSL 证书安装常见报错:6 个真实错误与排查命令
这 6 条报错分别由谁抛出?先分清层级再动手
同样是“证书装不上”,Nginx 在 reload 阶段就会直接拒绝启动,curl 在握手后校验证书链失败,浏览器则在渲染前做 SAN 与时间校验。定位的第一步是确认报错来源:Nginx 看 /www/server/nginx/logs/error.log,命令行看 curl -v 输出,浏览器按 F12 → Security 看具体证书。按“是否必须重新签发证书”可先做粗分类,避免在不需要重签的问题上白等审核:
| 报错 | 触发层 | 需重新签发证书 | 典型修复耗时 |
|---|---|---|---|
| PEM_read_bio_X509_AUX() failed | Nginx 启动 / reload | 否,重贴 PEM 即可 | 约 2 分钟 |
| curl: (60) unable to get local issuer certificate | 客户端证书链校验 | 否,补中间证书 | 约 5 分钟 |
| NET::ERR_CERT_COMMON_NAME_INVALID | 浏览器 SAN 校验 | 是 | 10–30 分钟 |
| ERR_SSL_PROTOCOL_ERROR | TCP / TLS 握手前 | 否 | 约 5 分钟 |
| ERR_TOO_MANY_REDIRECTS | 应用层重定向 | 否 | 约 5 分钟 |
| NET::ERR_CERT_DATE_INVALID | 时间 / 有效期 | 仅过期时需续期 | 约 5 分钟 |
nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:… bad base64 decode) 怎么修?
这是 OpenSSL 无法解析 PEM,而非证书本身无效。据 OpenSSL 官方文档,x509 只接受严格的 Base64 分块,-----BEGIN CERTIFICATE----- 必须独占一行。常见原因:粘贴时带上“证书如下:”等说明文字、把 BEGIN PRIVATE KEY 块混入证书框、或复制过程中换行被压缩成一行。先在本地确认可解析,再回宝塔面板粘贴:
# 能输出 subject 才说明 PEM 结构完整,可以粘贴进宝塔
openssl x509 -in fullchain.pem -noout -subject
# 正常:subject=C = CN, O = Example, CN = example.com
# 异常:unable to load certificate —— 重新从服务商控制台导出 PEM 格式
# 顺手确认证书与私钥是否配对(两条命令的 modulus 必须一致)
openssl x509 -in fullchain.pem -noout -modulus | openssl md5
openssl rsa -in privkey.pem -noout -modulus | openssl md5
curl: (60) SSL certificate problem: unable to get local issuer certificate 是什么原因?
缺中间证书。据 Let’s Encrypt 文档,服务端必须下发“站点证书 + 中间证书”完整链,只发叶子证书时桌面浏览器可能靠缓存补链而正常,但 curl、Java、微信小程序会直接失败。宝塔的 ssl_certificate 应指向 fullchain 而非单证书:
# 合并顺序不能反:站点证书在前,中间证书在后
cat domain.crt ca-bundle.crt > fullchain.pem
openssl verify -CAfile ca-bundle.crt domain.crt # 期望输出:domain.crt: OK
# 宝塔默认路径(Nginx 1.22/1.24 均适用)
# ssl_certificate /www/server/panel/vhost/cert/example.com/fullchain.pem;
# ssl_certificate_key /www/server/panel/vhost/cert/example.com/privkey.pem;
nginx -t && nginx -s reload
NET::ERR_CERT_COMMON_NAME_INVALID:域名对不上怎么办?
按 RFC 6125,现代浏览器只校验 SAN 扩展,CN 字段早已不再作为回退依据。执行下面的命令,若访问 www.example.com 而输出只有 DNS:example.com,就是根因,只能重新签发含 www 的证书并重新做一次宝塔 SSL 证书安装:
openssl x509 -in cert.pem -noout -text | grep -A1 'Subject Alternative Name'
# 期望:DNS:example.com, DNS:www.example.com
ERR_SSL_PROTOCOL_ERROR:443 根本没通?
该错误发生在 TLS 握手之前,与证书内容无关。按“本机 → 防火墙 → CDN”三层验证,宝塔 Nginx 默认监听 listen 443 ssl;:
ss -lntp | grep ':443' # 无输出说明 443 未监听
curl -vk https://127.0.0.1 -H 'Host: example.com' -o /dev/null # 本机绕过 DNS 与安全组验证
# 云厂商安全组放行 TCP 443;CDN 回源端口从 80 改为 443
ERR_TOO_MANY_REDIRECTS:301 循环怎么破?
典型是宝塔“强制 HTTPS”与 CDN 的 Flexible(回源走 80)叠加:CDN 认为回源是 HTTP 再跳一次,形成闭环。把 CDN 加密模式改为 Full (strict),并检查 Nginx 是否同时存在 return 301 与 rewrite … permanent,只保留一条:
grep -rnE 'return 301|rewrite .* permanent' /www/server/panel/vhost/nginx/example.com.conf
# 清理浏览器 HSTS 缓存后再测(chrome://net-internals/#hsts → Delete domain)
NET::ERR_CERT_DATE_INVALID:时间还是有效期?
先排除时钟漂移(VPS 快照恢复后常见),再确认有效期:
date -u # 与真实 UTC 比对,偏差超过 5 分钟即需校时
timedatectl set-ntp true
openssl x509 -in fullchain.pem -noout -dates
# notBefore / notAfter 均落在当前时间区间内才算有效
# 过期则续期后在宝塔面板重新部署并 nginx -s reload
排查顺序建议固定为:nginx -t → 本机 curl -vk → 外网 curl -v,三层都过再去看浏览器报错,能省掉大半反复重装证书的时间。
如何验证宝塔 SSL 证书安装生效?5 条命令看输出
部署完证书别急着关面板——浏览器地址栏的锁只证明”能连上”,不证明链完整、协议安全、跳转正确。下面 5 条命令按”证书本身 → 跳转 → 信任链 → 协议套件 → 浏览器”的顺序逐层验证,每条都给出期望输出。命令适用于 OpenSSL 1.1.1 / 3.x(宝塔面板 9.x 自带 OpenSSL 3.0+,Nginx 1.24 或 Apache 2.4)。
1. 证书主题、签发者与有效期对不对?据 OpenSSL 文档,-servername 用于发送 SNI,宝塔一台机器挂多个站点时必须带,否则拿到的是默认站点的证书:
# 取出服务器实际下发的叶子证书,只打印主题/签发者/有效期
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 期望输出(Let's Encrypt R11 中间证书示例):
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R11
# notBefore=Jan 5 08:12:33 2025 GMT
# notAfter=Apr 5 08:12:32 2025 GMT
notAfter 必须晚于当前时间;若 subject 显示的是别的域名,说明宝塔里该站点的 443 没绑定到正确 server 块,或 CDN 回源打到了默认站点。
2. HTTPS 通不通、强制跳转生效没有?
curl -I https://example.com # 期望 HTTP/2 200 或 HTTP/1.1 200
curl -I http://example.com # 期望 301,且带 Location: https://example.com/
# 若第二条返回 200,说明宝塔「强制 HTTPS」开关没打开,或 Nginx 里 return 301 被注释
3. 信任链完整吗?这是宝塔 SSL 证书安装后最常见的坑——只上传了域名证书,漏了中间 CA:
# Debian/Ubuntu 系统根证书包;CentOS/RHEL 用 /etc/pki/tls/certs/ca-bundle.crt
openssl s_client -connect example.com:443 -servername example.com
-CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 2>/dev/null
| grep 'Verify return code'
# 期望:Verify return code: 0 (ok)
# 常见报错:Verify return code: 20 (unable to get local issuer certificate)
# Verify return code: 21 (unable to verify the first certificate)
返回 20/21 基本都是链不完整,按 Let’s Encrypt 文档建议把 fullchain.pem(叶子证书 + 中间证书)整体贴进宝塔的证书框,而不是只贴 cert.pem。
4. 还在开 TLS 1.0/1.1 吗?宝塔老版本模板可能残留 SSLv3/TLSv1 配置,PCI DSS 与主流浏览器均已弃用:
nmap --script ssl-enum-ciphers -p 443 example.com
# 或更细:testssl.sh --severity HIGH https://example.com
# 期望只看到 TLSv1.2、TLSv1.3;出现 TLSv1.0/TLSv1.1/SSLv3 即为不合规
修改点在宝塔站点配置文件的 ssl_protocols TLSv1.2 TLSv1.3;,可参考 Mozilla SSL Configuration Generator 的 intermediate 档位。
5. HSTS 与 OCSP 装了吗?
curl -sI https://example.com | grep -i strict-transport-security
# 期望:strict-transport-security: max-age=31536000 (RFC 6797 定义的 max-age,单位秒)
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null
| grep -A1 'OCSP Response Status'
# CA 支持 OCSP 时显示:OCSP Response Status: successful (0x0) (RFC 6960)
HSTS 一旦下发就无法回退,建议先用 max-age=300 灰度,确认全站 https 无混合内容后再拉到 31536000。
| 现象 | 根因 | 处理 |
|---|---|---|
| Verify return code: 21 | 只部署了叶子证书,缺中间 CA | 改用 fullchain 完整链 |
| http:// 返回 200 | 强制 HTTPS 未开启 | 面板开关或 return 301 https://$host$request_uri; |
| 浏览器显示”不安全”但证书有效 | 页面内 http:// 图片/脚本(Mixed Content) | 改为 https:// 或协议相对 // |
| subject 不是目标域名 | SNI 未命中,落到默认站点 | 检查宝塔站点 443 绑定顺序 |
最后一定要看浏览器侧。Chrome DevTools → Security 面板应显示 Certificate – valid and trusted;Console 里若出现 Mixed Content: The page at 'https://…' was loaded over HTTPS, but requested an insecure image 'http://…',说明宝塔 SSL 证书安装本身成功了,但页面资源仍是 http,地址栏依旧标”不安全”。逐个把模板里的 http:// 改成 https:// 或协议相对 //,再刷新验证。
宝塔 SSL 证书安装后的续期、备份与监控:避免 90 天过期
问:Let’s Encrypt 证书 90 天到期,宝塔会自动续期吗?我什么都不用做?
宝塔确实会创建一个计划任务来跑续签(面板 → 计划任务 → 类型「续签 Let’s Encrypt 证书」,默认每天执行一次)。但「任务存在」不等于「续期成功」——据 Let’s Encrypt 官方文档,HTTP-01 校验必须能从公网访问 http://你的域名/.well-known/acme-challenge/,一旦 80 端口被防火墙或安全组挡住,续期会静默失败,直到第 90 天整站 443 报错才被发现。先确认任务真的在跑:
# 1. 查看宝塔写入的 root 计划任务(8.x/9.x 脚本通常落在 /www/server/cron/ 下)
grep -i -E "ssl|letsencrypt|acme" /var/spool/cron/root
ls -l /www/server/cron/ | grep -i ssl
# 2. 确认 80 端口在监听且本机能访问(404 是正常结果,代表可达)
ss -lntp | grep ':80'
curl -sS -o /dev/null -w '%{http_code}n' http://example.com/.well-known/acme-challenge/test
# 3. 若使用 acme.sh 独立管理,手动触发一次续期演练
/root/.acme.sh/acme.sh --cron --home /root/.acme.sh --debug
典型失败输出:Verify error:Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404,多半是 80 端口被 301 到 https 后 challege 路径没放行,或 CDN 回源没开 80。走 DNS-01 的用户注意:给宝塔/ acme.sh 的 DNS API 密钥要用独立子账号,只授予「DNS 记录读写」权限,绝不要用账号全局密钥——密钥泄露等于域名可被任意签发。
问:三种续期与换证方式怎么选?
| 方式 | 有效期 | 续期触发 | 对 80 端口要求 | 典型报错 |
|---|---|---|---|---|
| Let’s Encrypt HTTP-01 | 90 天 | 宝塔计划任务自动 | 必须公网可达 | Invalid response from …: 404 / timeout |
| Let’s Encrypt DNS-01 | 90 天 | acme.sh cron 或面板任务 | 不需要 | DNS API 权限不足、_acme-challenge TXT 未生效 |
| 商业证书手动覆盖 | 1 年(部分 CA 已缩至 200 天以内) | 人工,建议提前 30 天 | 不需要 | curl: (60) unable to get local issuer certificate(漏装中间链) |
问:商业证书到期换了新文件,为什么 curl 还是报 60?
因为只换了叶子证书、没换中间链。宝塔的证书目录固定为 /www/server/panel/vhost/cert/example.com/,其中 fullchain.pem 必须是「站点证书 + 中间 CA」的拼接,privkey.pem 是私钥。两个文件必须成对覆盖,覆盖后务必先校验再重载:
# 覆盖新证书(fullchain 与 privkey 必须成对,且来自同一次签发)
cp /root/new/fullchain.pem /www/server/panel/vhost/cert/example.com/fullchain.pem
cp /root/new/privkey.pem /www/server/panel/vhost/cert/example.com/privkey.pem
chmod 600 /www/server/panel/vhost/cert/example.com/privkey.pem
chmod 700 /www/server/panel/vhost/cert/example.com
nginx -t && nginx -s reload
# 用 -servername 明确 SNI,验证链是否完整(应显示 2 段证书)
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep -E 'Verify return code|s:|i:'
若 nginx -t 报 SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch),说明证书与私钥不是一对,回退上一份即可。Verify return code: 21 (unable to verify the first certificate) 则是链不全。
问:怎么提前知道证书快过期?
据 OpenSSL 手册,x509 -checkend 以秒为单位判断剩余有效期,返回码 0 表示未到期、1 表示将到期,可直接用于脚本与监控探针:
# 2592000 = 30 天。返回 0 正常,返回 1 且打印 "Certificate will expire" 即 30 天内到期
openssl x509 -checkend 2592000 -noout -in /www/server/panel/vhost/cert/example.com/fullchain.pem
openssl x509 -noout -dates -issuer -in /www/server/panel/vhost/cert/example.com/fullchain.pem
# Prometheus blackbox_exporter:probe_ssl_earliest_cert_expiry 为 Unix 时间戳
# 告警表达式
# (probe_ssl_earliest_cert_expiry - time()) / 86400 < 30
Zabbix 侧可用 zabbix_get -s 127.0.0.1 -k web.certificate.get[example.com,443] 类内置键,或直接调用上面的 openssl 命令做 UserParameter,阈值统一设 30 天,同时再设一条 7 天的严重告警。
问:自动 reload 怎么做到「失败不断站」?
关键是先备份、再 nginx -t、后 reload,失败即回滚并再校验一次。下面脚本可直接放进宝塔计划任务的 Shell 脚本里:
#!/bin/bash
# /root/ssl_reload.sh —— 续期后安全重载,失败自动回滚
set -u
CERT_DIR=/www/server/panel/vhost/cert/example.com
BAK=/root/ssl-rollback; mkdir -p "$BAK"
cp -a "$CERT_DIR/fullchain.pem" "$BAK/fullchain.pem.bak"
cp -a "$CERT_DIR/privkey.pem" "$BAK/privkey.pem.bak"
if nginx -t 2>/tmp/nginx_t.log; then
nginx -s reload && echo "$(date -Is) reload ok"
else
cp -a "$BAK/fullchain.pem.bak" "$CERT_DIR/fullchain.pem"
cp -a "$BAK/privkey.pem.bak" "$CERT_DIR/privkey.pem"
nginx -t && nginx -s reload
echo "$(date -Is) rollback,排查 /www/server/nginx/logs/error.log"
fi
排错时按时间点抓日志:grep -n "$(date +%Y/%m/%d)" /www/server/nginx/logs/error.log | tail -50。
问:证书和配置怎么备份?
tar czf /root/ssl-backup-$(date +%F).tgz
/www/server/panel/vhost/cert /www/server/panel/vhost/nginx
chmod 600 /root/ssl-backup-*.tgz # 压缩包内含私钥,绝不能放网站根目录
问:能顺手把 80 关掉、直接上 HSTS preload 吗?
都不能急着做。80 端口同时承担 ACME HTTP-01 校验和 http→https 的 301 跳转,关掉后续期链就断了。HSTS preload 更是单向门:据 Mozilla 安全指南,max-age=31536000; includeSubDomains; preload 会强制覆盖所有子域,一旦某个子域没有 HTTPS,浏览器会直接拒绝访问,而从 preload 列表移除需要数月。稳妥做法是宝塔 SSL 证书安装完成后先跑满一个完整的 90 天续期周期,确认续期、reload、日志三条链路都正常,再逐级加 max-age,最后才提交 preload。
先查证书链是否完整,确认 ssl_certificate 指向 fullchain.pem 而不是单张 domain.crt;再查 SAN 是否包含当前访问域名(含 www)。最后看 443 是否监听、CDN 是否 Full (strict),并用 openssl s_client -connect 域名:443 -servername 域名 看 Verify return code 是否为 0 (ok)。
个人站、测试站、预算有限时用宝塔一键 Let's Encrypt,90 天自动续期,但依赖 80/443 可达;多子域、合同赔付、需要 OV 或固定有效期时选商业证书,手动上传 fullchain.pem 与 privkey.pem。两者在宝塔 SSL 证书安装入口相同,区别在签发方式和续期责任。
这个报错通常是证书内容不完整、混入私钥、换行丢失或粘贴了 .pfx 二进制。重新从 CA 导出 PEM,执行 openssl x509 -in fullchain.pem -noout -subject 能正常解析后再粘贴,确保以 —–BEGIN CERTIFICATE—– 开头、以 —–END CERTIFICATE—– 结尾。
优先用 reload:先 nginx -t 确认 syntax is ok 和 test is successful,再 nginx -s reload,连接不会中断。只有修改监听端口、替换 Nginx 二进制或 reload 失败时才 systemctl restart nginx,重启前先备份 vhost 配置。
通配符 *.example.com 覆盖 www.example.com、api.example.com,但不覆盖 example.com,也不覆盖 a.b.example.com。签发时 SAN 同时包含 example.com 与 *.example.com,宝塔 SSL 证书安装后把同一证书部署到对应站点,并用 openssl x509 -text 检查 SAN 列表。
先在源站宝塔开启强制 HTTPS,确认 curl -I http://example.com 返回 301;CDN 侧改为 Full (strict),回源 443,避免 Flexible 造成循环。若使用 HSTS,先 max-age=300 测试,确认所有子域可用 HTTPS 后再升到 31536000。
Let's Encrypt 自动续期后宝塔通常会重载 Nginx,无需重新走一遍宝塔 SSL 证书安装;手动商业证书续期后要覆盖 fullchain.pem 与 privkey.pem,并执行 nginx -t && nginx -s reload。续期后建议用 openssl x509 -noout -dates 确认 notAfter 已更新。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。