TrustAsia(亚洲诚信)SSL 证书宝塔面板部署实战:fullchain、强制 HTTPS 与排错指南
1. 问题背景与根因:为什么 TrustAsia 证书在宝塔上“浏览器正常、接口报错”
TrustAsia(亚洲诚信)证书通过 DigiCert 授权根签发,信任链与国际品牌一致;中文控制台、本地审核和人民币计价对国内企业采购友好。但在宝塔面板部署时,最常见的问题不是证书没签下来,而是只把叶子证书粘贴进去,没有带中间证书。浏览器可能因为缓存或自动补链显示小锁,而 curl、Java、微信小程序严格校验证书链,直接报错。
第二个根因是强制 HTTPS 与 CDN 回源协议冲突:宝塔开启“强制 HTTPS”后源站对 HTTP 请求返回 301,如果 CDN 仍以 HTTP 回源,就会形成 ERR_TOO_MANY_REDIRECTS 循环。第三个根因是私钥与证书不匹配,常见于重复生成 CSR 后拿错 .key。第四个根因是续期后 Nginx 仍指向旧文件,配置没有 reload。
有效期也要先明确:公开信任 TLS 证书最长有效期为 398 天,TrustAsia 付费证书通常按 1 年签发但不超过 398 天;Let’s Encrypt 证书有效期为 90 天。前者需要手动更新,后者可在宝塔勾选自动续签。部署前先执行 openssl version 和 nginx -v,确认环境支持 TLS 1.2/1.3。下面从文件准备开始,所有命令可直接执行。
2. 准备证书文件:fullchain、私钥与 398 天有效期
从 TrustAsia 控制台下载的压缩包通常包含域名证书(.crt 或 .pem)、中间证书和私钥(.key)。宝塔“其他证书”右框要粘贴的是 fullchain,即叶子证书在前、中间证书在后,不要放根证书。合并命令:
cat example.com.crt intermediate.crt > fullchain.pem
openssl x509 -in fullchain.pem -noout -subject -issuer -dates
openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
第一条命令按顺序合并;第二条确认 Subject 是 example.com、Issuer 是中间 CA;第三条列出链中证书数量,正常应为 2 张(叶子+中间)。私钥检查:
openssl rsa -in private.key -check -noout
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in private.key | openssl md5
两个 md5 必须一致。若购买时需自行生成 CSR,可用:
openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/C=CN/ST=Shanghai/L=Shanghai/O=Example/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
注意 398 天上限:TrustAsia 证书到期前 30 天应更新;Let’s Encrypt 90 天证书由宝塔自动续签。私钥权限设为 600,不要提交到 Git。文件编码必须是 PEM,开头为 -----BEGIN CERTIFICATE----- 和 -----BEGIN PRIVATE KEY-----。
3. 完整实操:在宝塔面板部署 TrustAsia 证书
方式一(Let’s Encrypt 自动):登录宝塔 → 网站 → 站点设置 → SSL → Let’s Encrypt → 勾选域名 → 选择文件验证或 DNS 验证 → 申请 → 开启“自动续签”。Let’s Encrypt 有效期 90 天,适合测试和普通站点。
方式二(TrustAsia 付费证书手动):站点设置 → SSL → 其他证书 → 左框粘贴 private.key 全文,右框粘贴 fullchain.pem 全文 → 保存 → 开启“强制 HTTPS”。保存后宝塔通常写入 /www/server/panel/vhost/cert/example.com/fullchain.pem 和 private.key。执行:
ls -l /www/server/panel/vhost/cert/example.com/
/www/server/nginx/sbin/nginx -t
systemctl reload nginx
如果 nginx -t 报 SSL_CTX_use_PrivateKey_file(...) failed ... key values mismatch,说明左右框内容贴反或私钥不匹配,回到第 2 节核对 modulus。开了 CDN 的站点,必须在 CDN 控制台把回源协议改为 HTTPS 或“跟随协议”,否则宝塔强制 HTTPS 会与 CDN HTTP 回源形成循环。手动付费证书不会自动续期,到期前需重新下载并粘贴。部署完成后不要只信面板提示,继续做第 7 节命令行验证。
4. 配置示例:Nginx、强制 HTTPS 与 CDN 回源
宝塔会在站点配置中生成 SSL 段,但排错时可用以下最小示例对照。80 端口只做跳转,443 端口加载 fullchain 和私钥,启用 TLS 1.2/1.3:
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_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 on;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 10m;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
location / { proxy_pass http://127.0.0.1:8080; }
}
关键点:ssl_certificate 必须指向 fullchain,不是叶子证书;ssl_certificate_key 指向私钥;HSTS 首次上线建议先用较短 max-age 测试。若使用 CDN,源站看到的是 CDN 回源请求,CDN 回源协议必须为 HTTPS,否则 301 循环。宝塔“强制 HTTPS”本质也是 301,不要在 CDN 和源站同时做互相冲突的跳转。修改后执行 nginx -t && systemctl reload nginx,再用 nginx -T | grep ssl_certificate 确认实际加载路径。
5. 对比表格:Let’s Encrypt 与 TrustAsia 付费证书部署方式
| 对比项 | Let’s Encrypt(宝塔自动) | TrustAsia 付费(宝塔手动) | TrustAsia 付费(CDN/负载均衡) |
|---|---|---|---|
| 有效期 | 90 天 | 最长 398 天,通常 1 年 | 同左,按证书到期日 |
| 续期方式 | 宝塔勾选自动续签 | 到期前手动下载并粘贴 | 控制台上传新证书 |
| 验证方式 | 文件验证/DNS 验证 | 域名验证/DNS/文件,OV 需组织审核 | 同左 |
| 证书链 | 自动生成 fullchain | 必须粘贴 fullchain,含中间证书 | 上传 fullchain 与私钥 |
| 审核与票据 | 无人工审核 | 中文控制台、本地审核、人民币计价 | 同左 |
| 适用场景 | 测试、个人站、可自动续期业务 | 企业官网、小程序、API 域名 | 多节点、CDN 加速业务 |
选择建议:能自动续期的 Let’s Encrypt 优先用于测试和内部服务;对外企业站点、微信小程序和 Java 接口建议用 TrustAsia 付费证书,减少 90 天续期窗口带来的链不完整风险。无论哪种,部署后都要用 openssl s_client 验证 Verify return code 为 0。表格中的 398 天是公开信任 TLS 证书上限,不是所有产品都签满;以控制台显示到期日为准。
6. 常见错误排查:真实报错与修复命令
报错 1:curl: (60) SSL certificate problem: unable to get local issuer certificate。原因:服务器只发送叶子证书,缺少中间证书。修复:重新合并 fullchain,确保叶子在前、中间在后,不要放根证书;执行 openssl s_client -connect example.com:443 -servername example.com -showcerts 查看服务器发送了几张证书。
报错 2:PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target。Java 客户端严格校验链,修复同上;旧 JDK 还需更新 cacerts。可用 keytool -list -cacerts 检查。
报错 3:nginx: [emerg] SSL_CTX_use_PrivateKey_file('/path/private.key') 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,两个值必须一致。
报错 4:浏览器 ERR_TOO_MANY_REDIRECTS。原因:CDN 以 HTTP 回源,源站强制 301 到 HTTPS。修复:CDN 回源协议改 HTTPS 或跟随协议。
报错 5:微信小程序 request:fail ssl hand shake error。检查 fullchain、TLS 版本、域名是否备案、证书是否过期;用 openssl s_client -tls1_2 测试。续期后不生效执行 nginx -T | grep ssl_certificate 和 systemctl reload nginx。
7. 效果验证:openssl、curl、浏览器与宝塔监控
部署后不要只看面板“证书有效期”。先验证链和到期时间:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
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'
curl -I https://example.com
curl -v https://example.com 2>&1 | grep -E 'SSL certificate|subject|issuer|expire'
期望看到 Verify return code: 0 (ok),Subject 为你的域名,Issuer 为中间 CA,notAfter 与控制台一致。浏览器用无痕模式访问,确认小锁、证书链完整;打开开发者工具 Console,检查是否有 Mixed Content。宝塔“监控”页可看 HTTPS 流量占比。若 curl 报错但浏览器正常,几乎都是链不完整。最后执行 nginx -t 和 systemctl reload nginx,并确认 80 端口 301 到 443。
还可检查协议版本与 HSTS:openssl s_client -connect example.com:443 -servername example.com -tls1_2 应成功,-tls1_3 视 Nginx 编译支持;curl -sI https://example.com | grep -i strict 应返回 HSTS 头。若页面加载了 http:// 资源,浏览器小锁仍在但 Console 会报 Mixed Content,需要把静态资源、API、图片全部改为 https:// 或协议相对地址。
8. 续期与更新:90 天与 398 天证书的自动化注意事项
Let’s Encrypt 证书 90 天,宝塔计划任务会自动续签;付费 TrustAsia 证书最长 398 天,通常 1 年,需要手动更新。更新流程:控制台下载新 fullchain 和私钥 → 宝塔 SSL 其他证书重新粘贴 → 保存 → nginx -t && systemctl reload nginx。如果使用 CDN,还要在 CDN 控制台上传新证书,否则边缘节点仍是旧证书。检查配置指向:
grep -R ssl_certificate /www/server/panel/vhost/nginx/
nginx -T | grep -E 'ssl_certificate|ssl_certificate_key'
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -dates
建议到期前 30 天更新,避免 398 天窗口内遗忘。若用 certbot 而非宝塔,可写 deploy hook:certbot renew --deploy-hook 'systemctl reload nginx'。注意不要同时保留旧文件路径,宝塔站点配置可能引用带时间戳的目录;reload 不是 restart,但修改证书路径后必须 reload。更新后再次执行第 7 节验证,确认 notAfter 已变化。
常见问题
优先检查右框是否粘贴了 fullchain:叶子证书在前、中间证书在后,不要放根证书。用 openssl s_client -connect 域名:443 -servername 域名 -showcerts 查看服务器发送的证书数量,正常为 2 张;再用 curl -v 查看链错误。
不会。TrustAsia 付费证书有效期最长 398 天,通常 1 年,到期前需在控制台重新签发并粘贴 fullchain 与私钥;宝塔自动续签只适用于 Let’s Encrypt 90 天证书。更新后执行 nginx -t && systemctl reload nginx。
分别对证书和私钥取 modulus 的 md5:openssl x509 -noout -modulus -in fullchain.pem | openssl md5;openssl rsa -noout -modulus -in private.key | openssl md5。两个值一致才匹配,否则会报 key values mismatch。
把 CDN 回源协议改为 HTTPS 或跟随协议,避免 CDN 以 HTTP 回源而源站 301 到 HTTPS;同时检查 CDN 的 SSL 配置和源站证书是否有效。
先 nginx -T | grep ssl_certificate 确认加载的是新文件,再 systemctl reload nginx;CDN 场景需在控制台上传新证书并刷新;最后用 openssl s_client -dates 查看 notAfter。