NGINX、Apache、Tomcat、IIS、宝塔面板 SSL 证书安装配置全流程与报错排查实战
证书买了却装不上:HTTPS 部署失败的五个真实根因
大量站点在购买 SSL 证书之后卡在部署环节,浏览器仍然提示「不安全」。把线上工单的失败案例做归因,95% 落在下面五类:
- 证书链不完整:只部署了站点证书 cert.pem,漏掉中间 CA。桌面浏览器有时靠 AIA 自动补链而「看起来正常」,但 Android 客户端、Java、curl 会直接报错。
- 私钥与证书不匹配:CSR 生成了多次,最后上传的 key 不是签发时用的那一把。
- 未启用 SNI:同一 IP 承载多个域名时,客户端拿到的是默认站点的证书。
- 协议与套件过时:仍开启 TLS 1.0/1.1,或只支持 RSA 密钥交换,被现代客户端拒绝。
- 有效期规则变化:自 2020 年 9 月 1 日起,Apple 与 Chrome 要求 TLS 服务器证书有效期不超过 398 天;Let’s Encrypt 签发有效期固定 90 天。过去「买三年省事」的思路已经彻底失效,必须做自动化续期。
先做三件事定位问题。第一,看服务端实际返回的证书:
openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
输出里 -subject 的 CN/SAN 必须包含你访问的域名,-issuer 应当是中间 CA 而不是根 CA。第二,校验私钥与证书是否配对,两者模数 MD5 必须一致:
openssl x509 -noout -modulus -in cert.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
第三,检查证书链文件里到底有几张证书:
grep -c "BEGIN CERTIFICATE" fullchain.pem
正常应为 2 或 3。若为 1,说明缺中间证书,这就是很多「电脑能开、手机打不开」的根因。
选证书与生成 CSR:DV/OV/EV 与 398 天规则
证书按验证等级分三类:DV(域名验证,几分钟签发)、OV(组织验证,需营业执照,1–3 个工作日)、EV(扩展验证,浏览器地址栏已不再显示绿色公司名)。绝大多数站点用 DV 足够,OV/EV 的价值在于企业身份背书与更高赔付额度。
无论哪种,签发前都要提交 CSR。推荐直接用 OpenSSL 一次性生成私钥与 CSR,并把所有域名写进 SAN:
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/ST=Beijing/L=Beijing/O=Example Tech/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com"
参数说明:-nodes 表示私钥不加密(否则每次重载都要人工输密码);-addext 要求 OpenSSL 1.1.1 及以上,低版本需手写 openssl.cnf。也可以改用 ECDSA 密钥,体积更小、握手更快:
openssl ecparam -genkey -name prime256v1 -out example.com.key
提交前务必自检 CSR:
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
漏掉 www 是最常见的返工原因。另外三点容易忽略:通配符证书 *.example.com 只覆盖一级子域,a.b.example.com 不在其内,也不包含裸域,必须额外写入 SAN;证书有效期上限 398 天,到期前 30 天必须续期;私钥文件权限应为 600、属主为运行 Web 服务的账号,chmod 644 example.com.key 属于严重安全事故。
NGINX 完整配置:80 跳转 + TLS 1.3 + OCSP Stapling
NGINX 是最常见的部署环境。下面是一份可直接落地的配置,含 80 端口强制跳转、TLS 1.2/1.3、OCSP Stapling 与 HSTS:
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
http2 on; # nginx 1.25.1+ 写法;旧版用 listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.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:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
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-Real-IP $remote_addr;
proxy_set_header X-Forwarded-Proto https;
}
}
几个易错点:ssl_certificate 必须指向 fullchain(站点证书 + 中间证书),而不是单独的 cert.pem;ssl_trusted_certificate 才用 chain.pem,二者不能混用。ssl_prefer_server_ciphers 在启用 TLS 1.3 后建议设为 off,让客户端选择更优套件。
改完先做语法检查再平滑重载,切勿直接 restart 造成连接中断:
nginx -t && nginx -s reload
若前面有 CDN 或负载均衡,还需在其控制台同步上传证书,并确认回源协议为 HTTPS,否则会出现「边缘 HTTPS、回源 HTTP」的伪加密链路,安全扫描会直接判定不合规。
Apache、Tomcat、IIS 配置要点与格式转换
Apache 的关键是区分 CertFile 与 ChainFile。Apache 2.4.8 之后可以把 fullchain.pem 直接给 SSLCertificateFile,SSLCertificateChainFile 已废弃:
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
Tomcat 只认 JKS/PKCS12,必须先转换,不能直接填 pem:
openssl pkcs12 -export -in fullchain.pem -inkey example.com.key
-out example.p12 -name tomcat -passout pass:changeit
keytool -importkeystore -srckeystore example.p12 -srcstoretype PKCS12
-destkeystore example.jks -deststoretype JKS -deststorepass changeit
然后修改 server.xml 的 Connector:
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
SSLEnabled="true" scheme="https" secure="true">
<SSLHostConfig protocols="TLSv1.2,TLSv1.3">
<Certificate certificateKeystoreFile="/opt/tomcat/conf/example.jks"
certificateKeystorePassword="changeit" type="RSA" />
</SSLHostConfig>
</Connector>
IIS 使用 .pfx,导入时绑定必须勾选「需要服务器名称指示(SNI)」:
Import-PfxCertificate -FilePath C:sslexample.pfx
-CertStoreLocation Cert:LocalMachineMy
-Password (ConvertTo-SecureString -String "pwd" -AsPlainText -Force)
netsh http show sslcert
三者的共同坑:Apache 的 ServerName、Tomcat 的 defaultSSLHostConfigName、IIS 的绑定主机名必须与证书 SAN 一致,否则即使证书正确也会命中默认站点。
宝塔面板与 acme.sh 自动化续期
宝塔面板路径最省事:网站 → 设置 → SSL → Let’s Encrypt → 文件验证,签发成功后证书落在 /www/server/panel/vhost/cert/example.com/ 下的 fullchain.pem 与 privkey.pem。续期任务在「计划任务」里以 Shell 脚本形式存在,默认每天检查一次。
但面板续期失败率不低,常见原因是 80 端口被占、CDN 回源拦截了 /.well-known/acme-challenge/ 路径,或站点伪静态规则把验证请求 rewrite 到首页。排查方法:
curl -I http://example.com/.well-known/acme-challenge/test
ss -lntp | grep :80
命令行环境推荐 acme.sh,支持 DNS API 验证,彻底绕开 80 端口问题:
curl https://get.acme.sh | sh -s email=admin@example.com
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com
--webroot /www/wwwroot/example.com
~/.acme.sh/acme.sh --install-cert -d example.com
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/fullchain.pem
--reloadcmd "nginx -s reload"
acme.sh 安装时会写入 crontab(0 0 * * *),并在证书剩余 60 天时自动续期——Let’s Encrypt 有效期只有 90 天,这个提前量是刻意留出的容错窗口。务必用 --install-cert 而非手工 cp,否则续期后 Web 服务读到的仍是旧文件。验证定时任务是否生效:
crontab -l | grep acme
~/.acme.sh/acme.sh --list
五种部署环境配置对比表
下表汇总五类环境的差异,可作为选型与迁移时的对照清单:
| 部署环境 | 证书文件要求 | 关键配置项 | 是否需格式转换 | 重载命令 |
|---|---|---|---|---|
| NGINX | fullchain.pem + .key | ssl_certificate / ssl_certificate_key / ssl_protocols | 否 | nginx -t && nginx -s reload |
| Apache | fullchain.pem + .key | SSLCertificateFile / SSLCertificateKeyFile | 否(2.4.8+) | apachectl configtest && apachectl graceful |
| Tomcat | JKS 或 PKCS12 | Connector / SSLHostConfig / Certificate | 是,需 openssl + keytool | systemctl restart tomcat |
| IIS | PFX(含私钥) | 站点绑定 + SNI 勾选 | 是,需打包 PFX | iisreset /noforce |
| 宝塔面板 | fullchain.pem + privkey.pem | 面板 SSL 页面 + 计划任务续签 | 否 | 面板内自动重载 |
从表里能看出两个规律:一是只有 Tomcat 与 IIS 需要二进制容器格式,转换过程最容易出错(别名 alias、密码、链证书顺序);二是只有 NGINX 与 Apache 支持真正意义上的平滑重载,Tomcat 与 IIS 重启会造成秒级中断,生产环境应放在低峰期执行,并配合前置负载均衡摘流。
另外,宝塔面板虽然「一键」,但它本质是 NGINX/Apache 的封装,出问题时仍要回到 /www/server/panel/vhost/nginx/example.com.conf 查看最终生成的配置,不要只在图形界面里打转。
常见报错与排查命令(附真实错误信息)
下面这些报错在工单里出现频率最高,按错误信息可以直接定位:
nginx: [emerg] SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch):私钥与证书不配对,用前面的 modulus md5 命令重新核对。curl: (60) SSL certificate problem: unable to get local issuer certificate:缺中间证书,把 chain.pem 内容拼到 cert.pem 之后生成 fullchain。- 浏览器
NET::ERR_CERT_COMMON_NAME_INVALID:SAN 中不包含当前访问域名,检查是否漏了 www 或子域。 - 浏览器
SSL_ERROR_NO_CYPHER_OVERLAP:协议或套件不匹配,通常是客户端只支持 TLS 1.2 而服务端仅开 1.3,或反之。 AH01909: RSA certificate configured for example.com does NOT include an ID which matches the server name:Apache 的 ServerName 与证书域名不一致,或 SNI 未生效。- Tomcat
java.io.IOException: Keystore was tampered with, or password was incorrect:JKS 密码错误,注意 keytool 与 Connector 中的密码必须完全一致。 - IIS 443 端口被占用:
netstat -ano | findstr :443找到 PID 后核对是否为 Skype、SQL Server Reporting Services 等抢端口程序。
一条命令快速拿到关键信息:
curl -Iv https://example.com 2>&1 | grep -E "subject:|issuer:|expire|SSL connection"
若服务端正常而部分客户端异常,多半是证书链或协议问题;若所有客户端都异常,先查 443 端口监听与防火墙:ss -lntp | grep 443、firewall-cmd --list-ports。云服务器还需检查安全组是否放行 443。
上线前验证清单与到期监控
配置完成后不要只看浏览器地址栏的小锁,按下面清单逐项验证:
# 1. 协议支持情况(1.2 与 1.3 都应成功,1.0/1.1 应失败)
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null
# 2. 证书链完整性
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null | grep -c "BEGIN CERTIFICATE"
# 3. 到期时间
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -enddate
# 4. HSTS 是否下发
curl -sI https://example.com | grep -i strict-transport-security
第 2 步输出应为 2 或 3;第 4 步若为空,说明 HSTS 头没生效,检查 add_header 是否被 location 块覆盖。此外必须人工检查页面「混合内容」:在浏览器控制台过滤 Mixed Content,把残留的 http:// 图片、JS、CSS 全部改为相对协议或 https,否则小锁旁边仍会出现警告。
到期监控建议用脚本加告警,不要依赖记忆:
#!/bin/bash
end=$(echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
days=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
[ $days -lt 30 ] && echo "证书剩余 $days 天" | mail -s "SSL 到期告警" admin@example.com
最后用 SSL Labs 或 MySSL 做一次外部评分,目标 A 级以上;评分偏低通常是协议版本、套件强度或缺少 HSTS 导致,按报告逐条修正即可。
常见问题
SSL 证书最长有效期是多少?
公共 CA 签发的 TLS 服务器证书有效期上限为 398 天(自 2020 年 9 月 1 日起由 Apple 与 Chrome 强制),超过 398 天的证书在主流浏览器中会被判定为不合规。Let’s Encrypt 等免费 CA 固定签发 90 天,因此必须配置自动化续期,建议在剩余 30 天(免费证书 30–60 天)时完成续签。
一张证书能绑定几个域名?通配符能覆盖多级子域吗?
通过 SAN 字段,一张证书可以绑定多个域名,主流 CA 支持 1–100 个不等,具体看套餐。通配符证书 *.example.com 只覆盖一级子域(如 a.example.com),不覆盖 a.b.example.com,也不包含裸域 example.com,需要把裸域单独加入 SAN。
HTTPS 能正常打开,但页面样式错乱、图片不显示怎么办?
这是典型的混合内容(Mixed Content)问题:页面通过 HTTPS 加载,但内部引用了 http:// 的资源,浏览器会拦截或降级处理。打开开发者工具 Console 过滤 Mixed Content,把所有静态资源地址改成 https:// 或 // 开头,同时检查后端代码中硬编码的 http 链接和 CDN 回源协议。
私钥泄露了该怎么处理?
立即在 CA 控制台吊销该证书(触发 CRL/OCSP 更新),然后重新生成一对新密钥并签发新证书替换,不要复用旧私钥。同时排查泄露路径,确认私钥文件权限为 600、未被提交到 Git 仓库、未被 Web 目录直接暴露。吊销后到替换完成之间存在空窗期,可先用 HSTS + 快速替换压缩风险窗口。
宝塔面板自动续签失败,如何排查?
按三步查:一是 curl -I http://example.com/.well-known/acme-challenge/test 是否返回 404 或 301,若被伪静态规则拦截需在站点配置中放行该路径;二是 ss -lntp | grep :80 确认 80 端口未被其他程序占用;三是检查 CDN 是否开启,CDN 会拦截验证请求,此时改用 DNS 验证方式或临时切回直连。也可直接查看面板的续签日志定位具体错误码。
免费证书和付费证书的差别在哪里?
技术上加密强度一致,差别在验证等级与服务:免费证书(如 Let’s Encrypt)为 DV,只验证域名控制权,有效期 90 天,无赔付;付费 OV/EV 证书需验证企业主体,有效期最长 398 天,附带更高保额与人工技术支持。面向公众的内容站、API 用 DV 完全够用;涉及支付、金融、政企合规场景再考虑 OV/EV。