SSL 证书安装部署与 HTTPS 配置实战:Nginx、Apache、Tomcat、IIS、宝塔全环境
一、问题背景与根因:HTTPS 部署失败的六个来源
把一张 SSL 证书装到服务器上,表面看只是“上传两个文件、重载服务”,但线上 HTTPS 故障绝大多数都落在同一批根因上。先定位根因再动手,比反复重装证书有效得多。
- 文件格式混淆:.crt/.cer/.pem 大多是 PEM 文本(以 —–BEGIN CERTIFICATE—– 开头),.pfx/.p12 是含私钥的 PKCS#12 二进制,.jks 是 Java 密钥库。把 PFX 直接填进 Nginx 的 ssl_certificate,必然启动失败。
- 证书链不完整:只部署服务器证书、不带中间证书。Chrome 会靠 AIA 自动补链,看起来正常;Java、Android 旧版本、curl、小程序 SDK 不会补链,直接报 PKIX path building failed。
- 私钥与证书不匹配:CSR 与私钥不是同一对,或者续期时只替换了证书没换 key。
- 有效期规则已变:CA/B 论坛规定 2020-09-01 起公有 TLS 证书单张最长 398 天,Let’s Encrypt 固定 90 天;SC-081 决议进一步压缩到 200 天(2026-03-15)、100 天(2027-03-15)、47 天(2029-03-15),“装完一年不管”彻底不可行。
- 协议与算法过时:SHA-1 签名证书 2017 年起被主流浏览器拒绝;TLS 1.0/1.1 已被 RFC 8996 废弃,Chrome 98+、Firefox 默认不再协商,只开 TLSv1 会直接握手失败。
- 混合内容:页面里仍有 http:// 的图片、JS 或接口,浏览器地址栏依旧标记“不安全”。
动手前先用一条命令看清现有证书的真实状态:
openssl x509 -noout -subject -issuer -dates -in /etc/nginx/ssl/fullchain.pem
如果 issuer 与 subject 相同,说明是自签名证书;如果 notAfter 已过期或不足 30 天,先续期再谈部署。记住一个原则:证书链、私钥、域名三者必须同时正确,任何一项出错都会让 HTTPS 在某一类客户端上失败。
二、部署前的通用准备:私钥、CSR 与完整证书链
不管最终部署到 Nginx、Apache、Tomcat 还是 IIS,材料只有四样:私钥、服务器证书、中间证书(链),以及按需导出的 PFX/JKS。以下命令在 OpenSSL 1.1.1/3.x 上可直接执行。
1)生成私钥,RSA 2048 起步,推荐 ECDSA P-256 以降低握手开销:
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key
# 或使用 ECDSA
openssl ecparam -genkey -name prime256v1 -out example.com.key
2)生成 CSR,必须带 SAN,现代浏览器已不再校验 CN:
openssl req -new -sha256 -key example.com.key -out example.com.csr -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
3)校验私钥与证书是否配对,两行输出的 MD5 必须完全一致:
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
4)拼接完整链,顺序必须是“服务器证书 → 中间证书”,反了会握手失败:
cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -CAfile root.crt -untrusted intermediate.crt example.com.crt
# 期望输出:example.com.crt: OK
5)导出通用格式(IIS、Tomcat 使用):
openssl pkcs12 -export -in fullchain.pem -inkey example.com.key -name example.com -out example.com.pfx -passout pass:YourPass
几个容易忽略的细节:私钥权限设为 600,属主为服务运行账号;CSR 与私钥一旦丢失无法补发,只能重新签发;证书文件统一放 /etc/nginx/ssl 或 /etc/httpd/ssl 并纳入备份;自动续期脚本必须同时更新 fullchain.pem 与 key,否则 reload 后加载的还是旧证书。
三、Nginx 部署:完整配置与平滑重载
Nginx 只认 PEM 文本格式,ssl_certificate 必须指向含中间证书的 fullchain.pem,ssl_certificate_key 指向私钥,缺一不可。
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;
resolver 223.5.5.5 119.29.29.29 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
}
}
保存后执行 nginx -t && systemctl reload nginx。注意 nginx -t 只校验语法和文件是否可读,不校验证书与域名是否匹配,所以必须再做一次 s_client 验证。若提示 unknown directive “http2”,说明 Nginx 版本低于 1.25.1,改回 listen 443 ssl http2。ssl_trusted_certificate 必须是完整链(根证书+中间证书),否则日志会报 [warn] “ssl_stapling” ignored, issuer certificate not found。使用 reload 而非 restart,可保证连接不断、平滑加载新证书。
四、Apache 部署:mod_ssl 配置与常见坑
先确认模块已加载:CentOS 系 yum install -y mod_ssl,Debian 系 a2enmod ssl。然后编辑虚拟主机:
<VirtualHost *:443>
ServerName example.com
DocumentRoot /var/www/html
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/chain.crt
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
SSLHonorCipherOrder off
SSLSessionTickets off
Header always set Strict-Transport-Security 'max-age=31536000; includeSubDomains'
Header always set X-Content-Type-Options 'nosniff'
<Directory /var/www/html>
Require all granted
</Directory>
</VirtualHost>
校验并生效:apachectl configtest && systemctl reload httpd(Debian 系为 apache2)。三个高频坑:
- Apache 2.4.8 起 SSLCertificateChainFile 已废弃,可以直接把中间证书追加到 SSLCertificateFile 指向的文件里,保留旧指令会打印 AH02559 警告。
- SSLCertificateFile 只放服务器证书时,Android 与 Java 客户端会报链不完整,务必拼接或使用 ChainFile。
- ServerName 必须与证书 SAN 中的某个域名一致,否则启动时出现 AH01909 警告,SNI 多站点场景下会命中错误证书。
如需强制跳转,在 80 端口的 VirtualHost 中加 Redirect permanent / https://example.com/,不要用 mod_rewrite 写死域名,避免多域名站点跳错。
五、Tomcat、IIS 与面板环境部署要点
Tomcat:8.5 及以上推荐直接用 PKCS12,JKS 已不推荐且私钥密码必须与库密码一致,否则报 Cannot recover key。
openssl pkcs12 -export -in fullchain.pem -inkey example.com.key -name tomcat -out example.com.p12 -passout pass:changeit
# conf/server.xml 中增加
<Connector port='443' protocol='org.apache.coyote.http11.Http11NioProtocol' SSLEnabled='true' scheme='https' secure='true' keystoreFile='/opt/tomcat/conf/example.com.p12' keystoreType='PKCS12' keystorePass='changeit' clientAuth='false' sslEnabledProtocols='TLSv1.2,TLSv1.3' />
若必须用 JKS,先 keytool -importkeystore -srckeystore example.com.p12 -srcstoretype PKCS12 -destkeystore example.com.jks -deststoretype JKS 转换。Tomcat 修改 server.xml 后必须重启,reload 不会重读 keystore。
IIS:双击 .pfx 导入到“本地计算机 → 个人 → 证书”,中间证书单独导入“中间证书颁发机构”;站点绑定 443 时勾选“需要服务器名称指示(SNI)”。IIS 默认仍启用 TLS 1.0/1.1,需在注册表 HKLMSYSTEMCurrentControlSetControlSecurityProvidersSCHANNELProtocols 下为 TLS 1.0、TLS 1.1 建子键并将 Enabled、DisabledByDefault 设为 0,重启后生效。
宝塔面板:网站 → 设置 → SSL → 其他证书,把 fullchain.pem 内容粘进“证书(PEM 格式)”,key 粘进“私钥”,再打开“强制 HTTPS”。证书实际存放于 /www/server/panel/vhost/cert/站点名/,续期后需确认该目录文件已更新。
phpstudy v8:网站 → 管理 → SSL,粘贴 PEM 与私钥后保存即自动重载。WDCP:站点列表 → SSL 证书上传,注意同时上传证书链文件。面板类工具的共性是“粘贴格式敏感”,首尾的 —–BEGIN/END—– 行不能删,多余空行要清理。
六、主流环境与协议配置对比
不同环境的差异集中在证书格式、链文件参数和生效方式上,对照下表可以少走弯路。
| 环境 | 证书格式 | 关键配置项 | 配置文件 | 生效命令 |
|---|---|---|---|---|
| Nginx | PEM(fullchain + key) | ssl_certificate / ssl_certificate_key | /etc/nginx/conf.d/*.conf | nginx -t && systemctl reload nginx |
| Apache | PEM(证书 + chain) | SSLCertificateFile / SSLCertificateChainFile | /etc/httpd/conf.d/ssl.conf | apachectl configtest && systemctl reload httpd |
| Tomcat | PKCS12 / JKS | keystoreFile / keystorePass | conf/server.xml | systemctl restart tomcat |
| IIS | PFX | 站点绑定 443 + SNI | 图形界面 / appcmd | iisreset /noforce |
| 宝塔 | PEM 文本粘贴 | 证书 + 私钥 + 强制 HTTPS | 面板数据库 | 面板自动重载 |
协议与套件层面,2025 年之后的推荐基线如下:
| 协议版本 | 建议 | 说明 |
|---|---|---|
| TLS 1.0 / 1.1 | 禁用 | RFC 8996 已废弃,主流浏览器不再协商,且不满足 PCI DSS |
| TLS 1.2 | 必须开启 | 兼容基线,仅保留 ECDHE + AES-GCM / CHACHA20 套件 |
| TLS 1.3 | 推荐开启 | 握手 1-RTT、仅 AEAD 套件,性能与安全性最佳 |
证书类型的选择同样影响部署复杂度:DV 只校验域名控制权,签发快、易自动续期;OV 需校验企业主体,适合金融与政企合规;EV 自 2019 年起主流浏览器已不再展示绿色地址栏,溢价主要买的是品牌与保险。三者加密强度一致,差别在身份校验深度。所有公有证书单张有效期上限为 398 天,Let’s Encrypt 为 90 天,必须配套自动续期。
七、常见错误排查:真实报错与处理
下面这些报错几乎覆盖了 HTTPS 部署 90% 的故障场景,可直接对照定位。
| 报错信息 | 根因 | 处理方式 |
|---|---|---|
| nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:X509_check_private_key:key values mismatch) | 私钥与证书不配对 | 用 modulus 命令比对 MD5,重新下载匹配的 key |
| curl: (60) SSL certificate problem: unable to get local issuer certificate | 未发送中间证书 | ssl_certificate 改指向 fullchain.pem |
| 浏览器 NET::ERR_CERT_AUTHORITY_INVALID | 自签名证书或链不完整 | 换受信 CA 证书,补齐中间证书 |
| SSL_ERROR_BAD_CERT_DOMAIN | 证书 SAN 不含当前域名 | 重新签发含该域名的 SAN 证书 |
| Java: javax.net.ssl.SSLHandshakeException: PKIX path building failed | 服务端链不全或 JDK cacerts 缺根 | 补全证书链,必要时 keytool -import 导入根证书 |
| Apache: AH01909: RSA certificate configured for example.com:443 does NOT include an ID which matches the server name | ServerName 与证书不匹配 | 修正 ServerName 或改用 SNI 绑定 |
| nginx: [warn] “ssl_stapling” ignored, issuer certificate not found | 未配置 ssl_trusted_certificate | 指向完整链文件(根+中间) |
| curl: (35) error:0A000126:SSL routines::unexpected eof while reading | OpenSSL 3.0 与旧版 Nginx 的 TLS 1.3 关闭行为不兼容 | 升级 Nginx 至 1.21.4+,或临时关闭 TLSv1.3 |
| ERR_TOO_MANY_REDIRECTS 重定向次数过多 | 反向代理未传原始协议,应用重复跳转 | 添加 proxy_set_header X-Forwarded-Proto $scheme |
排查顺序建议固定下来:先 openssl s_client -connect example.com:443 -servername example.com 看服务端实际返回的证书链,再 curl -vI https://example.com 看客户端信任结果,最后检查应用层混合内容。绝大多数“证书装好了但不生效”,都是 reload 未执行或配置了错误的 server 块。
八、效果验证与证书续期自动化
部署完成后必须做四层验证:证书信息、链完整性、协议版本、OCSP 状态。
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates
curl -sI https://example.com | head -n 5
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null # 应握手失败
openssl s_client -connect example.com:443 -servername example.com -status </dev/null | grep -i 'OCSP Response Status'
再写一个到期监控脚本,挂到 cron 每日检查:
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 ))
echo "example.com 证书剩余 ${days} 天"
剩余天数小于 15 天时触发告警。自动续期方面:Certbot 用 certbot renew --dry-run 预演,确认 systemctl list-timers | grep certbot 中定时器已激活;acme.sh 用 acme.sh --cron --home ~/.acme.sh,并在 reloadcmd 中写 systemctl reload nginx;宝塔在计划任务里开启“SSL 自动续签”。
续期成功后一定要复验,因为 90 天有效期的 Let’s Encrypt 证书一旦续期失败,往往在到期当天才被发现。最后用 SSL Labs 跑一次评级,目标为 A 或 A+:出现 B 通常是仍支持 TLS 1.0/1.1 或存在 RC4、3DES 套件;出现 T 则是证书链不完整。生产环境建议同时开启 HSTS,但首次启用前确认所有子域都已支持 HTTPS,否则 includeSubDomains 会造成子站无法访问。
常见问题
按 CA/B 论坛规定,2020 年 9 月起公有 TLS 证书单张最长 398 天,Let’s Encrypt 固定 90 天。SC-081 决议将分阶段缩短为 200 天(2026-03-15)、100 天(2027-03-15)、47 天(2029-03-15)。因此必须用 ACME 自动续期替代人工年检。
.crt/.cer/.pem 通常是 PEM 文本,以 —–BEGIN CERTIFICATE—– 开头,供 Nginx、Apache 使用;.pfx/.p12 是含私钥的 PKCS#12 二进制,供 IIS、Tomcat 使用;.jks 是 Java 密钥库,需用 keytool 转换。用 file 命令或查看首行即可判断,格式填错是最常见的部署失败原因。
典型原因是服务端只发了服务器证书、没发中间证书。Chrome 支持 AIA 自动补链所以显示正常,而 Java 的 PKIX 校验、Android 旧版本、curl、小程序 SDK 不会补链,直接抛 PKIX path building failed 或 unable to get local issuer certificate。把 ssl_certificate 指向 fullchain.pem 即可解决。
多为 Nginx 反向代理到后端应用,应用判断不到原始协议又跳回 HTTPS,形成死循环。在 location 中加入 proxy_set_header X-Forwarded-Proto $scheme,并让后端信任该头(WordPress 配置 $_SERVER[‘HTTPS’],Spring 设 server.forward-headers-strategy=native)。同时确认 CDN 回源协议与证书链正确。
DV 只校验域名控制权,签发快、易自动续期,满足加密与搜索需求,绝大多数站点够用;OV 额外校验企业主体,适合金融、政企合规场景;EV 自 2019 年起主流浏览器不再显示绿色地址栏,溢价主要买品牌与保险。三者加密强度相同,差别在身份校验深度。
不需要重启进程。Nginx 执行 nginx -t && systemctl reload nginx,Apache 执行 apachectl configtest && systemctl reload httpd,reload 会平滑加载新证书且不断开连接。Tomcat 必须重启才能重读 keystore。宝塔等面板续期后要确认证书文件已更新并触发重载,否则仍在用旧证书。