跳到主要内容
宝塔面板

JoySSL SSL 证书宝塔面板安装部署教程:fullchain、强制 HTTPS 与排错

问题背景与根因:证书装上了为什么仍报错

JoySSL 是国产 CA,提供免费 DV 与价格亲民的付费证书,中文审核流程和本地化支持对国内用户较友好。把 JoySSL 证书部署到宝塔面板通常只有两条路:面板内申请 Let’s Encrypt 并自动续期,或把付费证书的 fullchain.pem 与 private.key 手动粘贴到站点 SSL。前者有效期 90 天,必须依赖自动续签;后者按 CA 实际签发执行,但公共信任 TLS 证书单张最长有效期不得超过 398 天,续期仍要替换文件并重载服务。

实际故障大多不在“有没有证书”,而在链路:只上传叶子证书导致中间证书缺失,curl、Java、小程序报证书链错误;证书与私钥不是同一对,Nginx 启动时报 key values mismatch;开了 CDN 后源站强制 HTTPS、回源却仍是 HTTP,形成 301 循环;续期后配置指向旧文件或进程未 reload,浏览器仍显示旧证书。宝塔 SSL 页显示有效期只代表面板识别到文件,不代表全链路可信。上线前先做三项硬校验:fullchain 中证书数量、证书与私钥模数、443 端口实际返回链。命令见后续章节。本文按准备文件、面板部署、配置示例、对比选择、真实报错排查、效果验证的顺序给出可执行流程。

准备证书文件与上线前校验

从 JoySSL 控制台下载 Nginx 格式证书,通常得到 fullchain.pem 与 private.key。fullchain 的顺序必须是站点证书在前、中间证书在后;不要只拿站点证书。把文件放到宝塔站点证书目录,示例域名 example.com:

mkdir -p /www/server/panel/vhost/cert/example.com
cp fullchain.pem /www/server/panel/vhost/cert/example.com/fullchain.pem
cp private.key /www/server/panel/vhost/cert/example.com/private.key
chmod 600 /www/server/panel/vhost/cert/example.com/private.key
chown root:root /www/server/panel/vhost/cert/example.com/private.key
grep -c 'BEGIN CERTIFICATE' /www/server/panel/vhost/cert/example.com/fullchain.pem

最后一条输出应大于等于 2,表示至少包含站点证书和一张中间证书。继续核对证书主题、签发者、有效期,以及证书与私钥是否匹配:

openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -subject -issuer -dates
openssl x509 -in /www/server/panel/vhost/cert/example.com/fullchain.pem -noout -modulus | openssl md5
openssl rsa -in /www/server/panel/vhost/cert/example.com/private.key -noout -modulus | openssl md5

两条 md5 必须完全一致。若私钥带密码,使用 openssl rsa -in private.key -passin pass:你的密码 -noout -modulus | openssl md5。再列出链中证书:openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout。若只看到一张证书,回到 CA 控制台重新下载完整链。证书文件权限保持 600,Nginx 主进程可读即可;不要为了省事改成 777。完成校验后再进面板粘贴,能避免大半部署故障。

宝塔面板手动部署完整步骤

登录宝塔面板,进入“网站” → 目标站点“设置” → “SSL” → “其他证书”。左侧粘贴 private.key 全文,右侧粘贴 fullchain.pem 全文,保存。不要左证书右私钥;宝塔该界面的约定是左私钥、右证书。保存后打开“强制 HTTPS”。若站点前面有 CDN,进入 CDN 控制台把回源协议改为 HTTPS,并在 CDN 侧上传同一套证书;否则源站 80 跳 443、CDN 回源 80,会形成重定向循环。操作前备份站点配置:

cp /www/server/panel/vhost/nginx/example.com.conf /root/example.com.conf.bak.$(date +%F)
nginx -t
systemctl reload nginx

Apache 环境把 nginx -t 换成 httpd -t,重载换成 systemctl reload httpd。若使用宝塔内 Let’s Encrypt:站点 SSL → Let’s Encrypt → 勾选域名 → 文件验证或 DNS 验证 → 申请 → 开启自动续签。Let’s Encrypt 证书有效期 90 天,建议保留自动续签并在到期前 30 天观察日志。手动 JoySSL 证书则在到期前替换 fullchain.pem 与 private.key,再执行 nginx -t 与 reload;只覆盖文件不 reload,旧进程仍可能持有旧证书。最后用 curl 验证:

curl -I https://example.com
curl -vI https://example.com 2>&1 | grep -E 'SSL certificate|subject|issuer|expire'

浏览器无痕模式访问应显示小锁。宝塔“监控”页可观察 HTTPS 流量占比,但它不是证书链验证工具,仍需命令行确认。若面板保存报错,先检查粘贴内容是否包含多余空格、换行或把 PEM 头尾截断。

配置示例:Nginx 与 Apache 的关键参数

宝塔会生成站点配置,关键是指向 fullchain 与私钥,并只保留一层 HTTP 到 HTTPS 跳转。Nginx 示例:

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl http2;
    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/private.key;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    add_header Strict-Transport-Security 'max-age=31536000' always;
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

HSTS 首次上线不要加 includeSubDomains 和 preload,确认所有子域都支持 HTTPS 后再加。Apache 示例:

<VirtualHost *:80>
    ServerName example.com
    Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
    SSLEngine on
    SSLCertificateFile /www/server/panel/vhost/cert/example.com/fullchain.pem
    SSLCertificateKeyFile /www/server/panel/vhost/cert/example.com/private.key
    SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
    Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>

Apache 2.4.8 及以上使用 fullchain 作为 SSLCertificateFile 时通常不再单写 SSLCertificateChainFile;旧版本可把中间证书单独写入 ChainFile。配置完成后执行 nginx -t 或 httpd -t,通过再 reload。CDN 场景下源站回源协议必须是 HTTPS,且 CDN 侧证书与源站证书都要有效;如果 CDN 已做强制跳转,源站不要再叠加多层跳转。代理到后端时保留 X-Forwarded-Proto,应用生成绝对 URL 时才不会退回 http。

对比表格:Let’s Encrypt 自动签发与 JoySSL 手动部署

两种方式都能在宝塔落地,差别在续期责任和排错链路。下表按有效期、验证方式、证书链、适用场景对比。注意公共信任 TLS 证书最长有效期 398 天,Let’s Encrypt 为 90 天;任何“永久证书”说法都不符合现行规则。

项目 宝塔 Let’s Encrypt JoySSL 手动部署 注意点
签发入口 站点 SSL → Let’s Encrypt CA 控制台下载后粘贴 手动方式要自己管续期
有效期 90 天 以 CA 实际签发为准,不超过 398 天 到期前 30 天检查
续期 面板自动续签 替换 fullchain 与 key 后 reload 只换文件不 reload 会继续用旧证书
验证方式 文件验证或 DNS 验证 按 CA 中文审核流程 CDN 域名注意验证路径
证书链 面板自动写入 必须使用 fullchain 叶子证书会导致 curl/Java 报错
适用场景 常规站点、批量域名 需要国产 CA、中文支持或特定合规 两者都需强制 HTTPS 与回源 HTTPS

选择建议:能接受 90 天自动续期、追求运维省心,用 Let’s Encrypt;需要 JoySSL 的中文审核与本地化支持,用手动部署,但要把到期提醒、文件替换、reload、CDN 证书更新写成清单。无论哪种,宝塔 SSL 页显示有效期只是第一步,最终以 openssl s_client 和 curl 的返回链为准。证书购买页和安装教程汇总可作为选型参考,但上线参数以本文命令校验结果为准。

常见错误排查:真实报错与修复命令

1)curl 报 curl: (60) SSL certificate problem: unable to get local issuer certificate。根因是服务端只返回叶子证书,缺中间证书。修复:确认 fullchain.pem 中至少有站点证书和中间证书,grep -c ‘BEGIN CERTIFICATE’ fullchain.pem 应大于等于 2;用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 查看实际返回链。Java 常见报错 PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target,同样先补 fullchain,再排查客户端信任库是否过旧。

2)Nginx 启动报 SSL_CTX_use_PrivateKey failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。这是证书与私钥不匹配。执行 openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in private.key | openssl md5,两个 md5 必须一致;不一致就重新下载或重新签发,不要手工拼接。

3)浏览器报 ERR_TOO_MANY_REDIRECTS。常见于 CDN 回源 HTTP,而源站又开启强制 HTTPS。把 CDN 回源协议改为 HTTPS,源站只保留一层 80 到 443 跳转;检查 Nginx 是否同时存在多个 return 301。4)续期后仍显示旧证书。执行 nginx -t && systemctl reload nginx,Apache 用 httpd -t && systemctl reload httpd;确认 ssl_certificate 指向新 fullchain,CDN 侧也更新证书并刷新缓存。

5)页面报 Mixed Content: The page at ‘https://…’ was loaded over HTTPS, but requested an insecure resource ‘http://…’。把前端资源改为 HTTPS 或相对路径,检查数据库中的站点地址、CDN 回源和反代 X-Forwarded-Proto。6)小程序或 Java 接口握手失败,先用 curl 与 openssl s_client 复现,再抓服务端返回链;不要只在浏览器看小锁。

效果验证:从面板、命令行到全链路

先在宝塔站点 SSL 页确认证书有效期与域名匹配;再用无痕窗口访问,确认小锁和证书颁发者。命令行验证分三层:连接与证书信息、链完整性、HTTP 跳转。执行:

curl -I https://example.com
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'

最后一条应大于等于 2;verify_return_error 无报错说明链可验证。再测 80 端口是否只跳一次:curl -I http://example.com,应看到 301 指向 https。CDN 场景用 curl -I https://example.com 检查响应头是否有 CDN 节点标识,并在 CDN 日志确认回源协议为 HTTPS。Java 或小程序调用方用真实接口跑一次,避免浏览器缓存掩盖链问题。

宝塔“监控”页可看 HTTPS 流量占比,但它不能替代 openssl。若启用 HSTS,确认 max-age 不要一开始设太长;若使用多域名证书,逐个域名执行 s_client。续期后重复上述命令,并记录证书序列号:openssl x509 -in fullchain.pem -noout -serial,确保线上返回的序列号与新文件一致。最终验收标准是:浏览器、curl、Java/小程序、CDN 回源四条链路都通过。

常见问题

以下问题按宝塔面板实操中最容易混淆的点整理,答案可直接对照执行。涉及有效期时请记住:Let’s Encrypt 为 90 天,公共信任 TLS 证书单张最长 398 天。

左侧粘贴 private.key 私钥全文,右侧粘贴 fullchain.pem 完整证书链全文。不要只粘贴站点叶子证书,也不要把证书和私钥左右颠倒。保存后开启强制 HTTPS,并执行 nginx -t 与 reload 让配置生效。

Let’s Encrypt 证书有效期为 90 天,宝塔面板可开启自动续签,通常无需手动。公共信任 TLS 证书单张最长有效期为 398 天,不存在永久证书。建议在到期前 30 天检查续签日志和实际返回证书。

这是证书链不完整,服务端只返回了叶子证书。改用 fullchain.pem,确认其中至少包含站点证书和中间证书,grep -c ‘BEGIN CERTIFICATE’ 应大于等于 2。修改后 reload Nginx 或 Apache,再用 openssl s_client 验证实际返回链。

先确认配置中的 ssl_certificate 和 ssl_certificate_key 指向新文件,再执行 nginx -t 和 systemctl reload nginx;Apache 用 httpd -t 和 reload httpd。若前面有 CDN,还要在 CDN 侧更新证书并刷新缓存,最后用 openssl 查看线上序列号。

常见原因是 CDN 回源协议仍是 HTTP,而源站又强制 HTTPS。把 CDN 回源协议改为 HTTPS,源站只保留一层 80 到 443 跳转,避免 CDN 与源站重复 301。修改后清理 CDN 缓存并检查响应头。

以上五条覆盖证书文件、有效期、证书链、续期生效和 CDN 循环。若仍失败,按“证书数量、模数一致、线上返回链、回源协议”四项顺序排查,不要先改加密套件。

内容审核

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