SSL 证书安装部署配置全攻略:Nginx、Apache、Tomcat、IIS、宝塔实操与排错
一、问题背景与根因:证书装上了,为什么浏览器仍提示不安全
很多运维把 SSL 证书部署理解成“上传两个文件、点一下重启”,结果地址栏的锁标依然带红叉。先纠正三个过时认知:其一,CA/Browser Forum 规定公开信任证书最长有效期 398 天,Let’s Encrypt 免费证书固定 90 天;按已通过的 SC-081 提案,上限还将逐步缩短到 200 天(2026-03)、100 天(2027-03)、47 天(2029-03),自动化续期已是必选项。其二,TLS 1.0/1.1 已被主流浏览器彻底废弃,服务端只应开启 TLS 1.2/1.3。其三,证书链、SNI、混合内容才是高频故障点,证书本身出错反而少见。
常见根因清单:
- 证书链不完整:只传了站点证书,没带中间证书。桌面 Chrome 会通过 AIA 自动补链,看起来正常;但 Android、微信内置浏览器、Java/Python 客户端直接报
unable to get local issuer certificate。 - 私钥与证书不匹配:多次申请后混用了旧 key。
- 域名不匹配:单域名证书用于 www 子域,或 SAN 字段没覆盖实际访问域名。
- 协议套件过旧:只开 TLS 1.0,Chrome 直接
ERR_SSL_PROTOCOL_ERROR。 - 混合内容:页面 HTTPS,但图片、JS 走
http://,浏览器降级为“不安全”。 - 443 未放行:云安全组、firewalld、iptables 三层都要查。
- 时间不同步:服务器时间早于证书 notBefore,校验失败。
- CDN 回源未同步:边缘证书更新了,源站仍是旧证书,回源握手失败。
三条命令先做体检:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -subject -issuer -dates
openssl rsa -noout -modulus -in /etc/nginx/ssl/privkey.pem | openssl md5
openssl x509 -noout -modulus -in /etc/nginx/ssl/fullchain.pem | openssl md5
最后两条输出的 md5 必须完全一致,否则就是私钥与证书不配对,后面所有配置都白做。
二、证书申请与格式转换:CSR、PEM、PFX、JKS 一次搞懂
不同服务端吃的格式不一样,先统一认知:PEM 是 Base64 文本,Nginx/Apache 用;PFX(PKCS#12)是二进制容器,IIS/Tomcat 用;JKS 是 Java 专有密钥库。生成 CSR 与私钥(OpenSSL 1.1.1+ 支持 -addext 直接写入 SAN):
openssl req -new -newkey rsa:2048 -nodes
-keyout 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'
拿到 CA 签发的证书后,把站点证书与中间证书按“站点证书在前、中间证书在后”拼接成 fullchain:
cat example.com.crt chain.crt > fullchain.pem
openssl verify -CAfile chain.crt fullchain.pem
格式互转命令:
# PEM 转 PFX(供 IIS / Tomcat 使用)
openssl pkcs12 -export -out example.com.pfx
-inkey example.com.key -in fullchain.pem -certfile chain.crt
-passout pass:ChangeMe123
# PFX 转回 PEM
openssl pkcs12 -in example.com.pfx -nodes -out all.pem
# PFX 转 JKS(Tomcat 老版本)
keytool -importkeystore -srckeystore example.com.pfx -srcstoretype PKCS12
-srcstorepass ChangeMe123 -destkeystore example.com.jks
-deststoretype JKS -deststorepass ChangeMe123
| 格式 | 后缀 | 典型使用方 | 是否含私钥 |
|---|---|---|---|
| PEM | .pem/.crt/.key | Nginx、Apache、宝塔 | 分开存放 |
| PKCS#12 | .pfx/.p12 | IIS、Tomcat、Windows | 含(受密码保护) |
| JKS | .jks | Tomcat 8 及更早 | 含 |
| DER | .der/.cer | Java 客户端信任库 | 不含 |
ECC 证书不能再用 -modulus 比对,改用公钥比对:openssl x509 -noout -pubkey -in fullchain.pem 与 openssl pkey -pubout -in example.com.key 输出应一致。私钥文件权限统一设 chmod 600、属主 root,避免被 Web 目录遍历下载。
三、Nginx 部署实操:从上传证书到 443 监听
第一步,落盘与权限:
mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
# 上传 fullchain.pem 与 privkey.pem
chmod 600 privkey.pem && chown root:root privkey.pem fullchain.pem
第二步,写配置。注意语法分水岭:Nginx 1.25.1 起推荐 listen 443 ssl; 加独立的 http2 on;,旧写法 listen 443 ssl http2; 会告警 deprecated。
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
http2 on;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256: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;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
root /var/www/html;
index index.html index.php;
}
第三步,灰度校验并生效:
nginx -t
systemctl reload nginx # 用 reload 不用 restart,避免连接中断
firewall-cmd --add-service=https --permanent && firewall-cmd --reload
ss -lntp | grep ':443'
关于 OCSP Stapling:Let’s Encrypt 已于 2025 年停止 OCSP 响应服务并转向 CRL,对 LE 证书开启 ssl_stapling on; 只会让 Nginx 反复解析失败并在 error.log 刷 ssl_stapling_responder failed,建议直接关闭。付费 DV/OV 证书仍可开启,但必须配置 resolver 223.5.5.5 8.8.8.8 valid=300s;,否则 stapling 不生效。
四、Apache、Tomcat、IIS 配置示例与要点
Apache(httpd 2.4):2.4.8 之后不再需要单独的 SSLCertificateChainFile,直接把 fullchain 写进 SSLCertificateFile 即可。
<VirtualHost *:443>
ServerName example.com
DocumentRoot /var/www/html
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/privkey.pem
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
SSLHonorCipherOrder on
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
httpd -t && systemctl reload httpd
Tomcat 9/10:新版可直接读 PEM,无需转 JKS,推荐这种方式:
<Connector port='443' protocol='org.apache.coyote.http11.Http11NioProtocol'
maxThreads='200' SSLEnabled='true' scheme='https' secure='true'
certificateFile='/opt/tomcat/conf/fullchain.pem'
certificateKeyFile='/opt/tomcat/conf/privkey.pem'
certificateChainFile='/opt/tomcat/conf/chain.pem'
sslProtocol='TLS' />
老版本用 PKCS12:keystoreFile='/opt/tomcat/conf/example.com.pfx' keystoreType='PKCS12' keystorePass='ChangeMe123'。注意 Tomcat 监听 443 需要 root 权限或 setcap 'cap_net_bind_service=+ep' /usr/lib/jvm/.../bin/java,否则启动报 Permission denied。
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
IIS:图形化四步——① 开始菜单运行 mmc,添加“证书”管理单元,选“计算机账户”,导入 PFX 到“个人”存储区,务必勾选“允许导出”并确认证书链完整;② IIS 管理器选中站点 → 绑定 → 添加 https、端口 443、选择证书;③ 多站点共用 443 时必须勾选“服务器名称指示(SNI)”;④ iisreset /noforce 或直接重启站点。IIS 无法读取 PEM,只认 PFX,这是最常见的踩坑点。
五、面板环境部署:宝塔、PhpStudy、WDCP 的差异与坑
宝塔面板:站点 → 设置 → SSL → 粘贴证书(-----BEGIN CERTIFICATE----- 开头的 fullchain 放证书栏,-----BEGIN PRIVATE KEY----- 放密钥栏),或一键申请 Let’s Encrypt(90 天有效,面板默认开启自动续签)。两个高频坑:一是面板自身的 SSL(面板设置 → 面板 SSL)与站点 SSL 是两套,改错地方无效;二是续签成功后个别版本不会自动 reload,需要在计划任务里加 nginx -s reload。另外宝塔的“强制 HTTPS”会在 80 端口 server 块注入 301,若源站同时接了 CDN 且 CDN 也开了强制跳转,就会出现 ERR_TOO_MANY_REDIRECTS。
PhpStudy:网站 → 管理 → SSL → 开启,粘贴 PEM 与 KEY。Windows 版修改配置后必须重启 Apache/Nginx 服务(托盘 → 重启),仅点“保存”不生效;Linux 版配置落在 /usr/local/nginx/conf/vhost/域名.conf,可手工核对。
WDCP v3:站点列表 → SSL → 手工填写证书与密钥(不支持 PFX),保存后需点“重载 Web 服务”。WDCP 老版本自带的 OpenSSL 可能是 1.0.2,不支持 TLS 1.3 与 -addext,申请 CSR 时要换用系统自带的 /usr/bin/openssl。
面板类环境申请 Let’s Encrypt 失败的统一排查顺序:域名是否已解析到本机 → 80 端口是否被占用或被安全组拦截 → 是否有 CDN/防火墙拦截 /.well-known/acme-challenge/ 路径 → 域名是否已完成备案(国内服务器)。逐条排除后成功率极高。
六、五类环境部署对比表与选型建议
| 环境 | 证书格式要求 | 配置位置 | 生效命令 | 最常见坑 |
|---|---|---|---|---|
| Nginx | PEM(fullchain + key) | /etc/nginx/conf.d/*.conf | nginx -t && systemctl reload nginx | 漏拼中间证书 |
| Apache | PEM | httpd-ssl.conf / vhosts | httpd -t && systemctl reload httpd | 2.4.8+ 仍写 ChainFile 导致重复 |
| Tomcat | PKCS12 或 PEM | conf/server.xml | systemctl restart tomcat | 非 root 无法绑定 443 |
| IIS | PFX(含链) | IIS 管理器 → 绑定 | iisreset /noforce | 多站点未勾 SNI |
| 宝塔/PhpStudy/WDCP | PEM | 面板 SSL 页面 | 面板点保存或 reload | 与面板自身 SSL 混淆 |
选型建议:单机小站优先 Nginx,配置最直观、TLS 1.3 支持最好;Java 生态必须用 Tomcat,新版本尽量用 PEM 免去 keytool 转换;Windows 内网系统选 IIS,注意 PFX 必须含完整链;不具备命令行能力的团队用宝塔,但要养成每月检查一次证书到期时间的习惯。所有环境都应把“证书到期监控”纳入告警,398 天看着长,实际留给你的排查窗口很短。
七、常见错误排查:真实报错与逐条解法
| 报错信息 | 根因 | 处理 |
|---|---|---|
nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:X509_check_private_key:key values mismatch) |
证书与私钥不配对 | 用 modulus md5 比对,重新配对文件 |
nginx: [emerg] PEM_read_bio_X509_AUX(...) failed (SSL: error:0909006C:PEM routines:get_name:no start line) |
把 PFX/DER 二进制当 PEM 用 | 先 openssl pkcs12 -in x.pfx -nodes -out all.pem 转换 |
curl: (60) SSL certificate problem: unable to get local issuer certificate |
服务端未下发中间证书 | 配置 fullchain,而非单独站点证书 |
NET::ERR_CERT_AUTHORITY_INVALID |
自签证书或链断裂 | 换公开信任证书,检查 chain 顺序 |
NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN |
证书 SAN 不含当前域名 | 重新签发含该域名的 SAN 或通配符证书 |
ERR_SSL_PROTOCOL_ERROR |
协议不匹配,如服务端只开 TLS 1.0 | 开启 TLS 1.2/1.3,检查是否被 WAF 拦截 443 |
AH01909: server certificate does NOT include an ID which matches the server name |
Apache ServerName 与证书不符 | 对齐 ServerName 与 SAN,或改用默认 vhost |
ERR_TOO_MANY_REDIRECTS |
CDN 与源站同时 301 | 只保留一侧跳转,CDN 回源协议设为 HTTPS |
控制台 Mixed Content: The page at ... was loaded over HTTPS, but requested an insecure resource |
页面引用 http 资源 | 改为相对协议或 https,加 upgrade-insecure-requests CSP |
排查顺序建议固定为:先 openssl s_client 看服务端实际下发的证书链 → 再 curl -vI 看握手与响应头 → 最后看浏览器开发者工具 Security 面板的具体错误码。不要一上来就改配置,先确认是哪一层的问题。
八、效果验证:五条命令确认部署成功
# 1. 校验证书主体、有效期、SAN
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 2. 确认 HTTP 到 HTTPS 的 301
curl -sSI http://example.com | head -5
# 3. 确认证书链可验证、返回 200
curl -sS -o /dev/null -w 'code=%{http_code} verify=%{ssl_verify_result}n' https://example.com
# 4. 确认旧协议已关闭(应握手失败)
openssl s_client -connect example.com:443 -tls1_1 </dev/null
# 5. 确认 HSTS 头已下发
curl -sSI https://example.com | grep -i strict-transport-security
第 3 条输出的 ssl_verify_result 必须为 0,非 0 即证书链或信任问题。第 4 条应返回 handshake failure 或 no protocols available,若成功握手说明旧协议没关干净。再补一个自动化巡检脚本,挂到 crontab 每天跑:
#!/bin/bash
DOMAIN=$1
END=$(echo | openssl s_client -connect ${DOMAIN}:443 -servername ${DOMAIN} 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
DAYS=$(( ( $(date -d "${END}" +%s) - $(date +%s) ) / 86400 ))
[ ${DAYS} -lt 15 ] && echo "WARN: ${DOMAIN} 证书仅剩 ${DAYS} 天" | mail -s 'SSL 到期告警' ops@example.com
最后做一次第三方体检:curl -s 'https://api.ssllabs.com/api/v3/analyze?host=example.com&publish=off&all=done',目标拿到 A 或 A+;若评级为 B 通常是支持了 TLS 1.0/1.1,为 C 往往是用了 RC4/3DES 或 SHA-1 签名。移动端还要单独用安卓微信打开一次,验证中间证书是否完整下发——这是桌面浏览器最容易“骗过”你的地方。
常见问题
按 CA/Browser Forum 规定,公开信任证书最长 398 天;Let’s Encrypt 免费证书固定 90 天且建议自动续期。按已通过的缩短计划,2026 年 3 月起降为 200 天,2027 年 3 月起 100 天,2029 年 3 月起 47 天,务必配置到期监控。
不需要重启整机。Nginx 用 nginx -t 校验后 systemctl reload nginx;Apache 用 systemctl reload httpd;Tomcat 与 IIS 一般需要重启服务或站点。reload 是平滑加载,不会中断现有连接,优先使用。
可以。使用多域名 SAN 证书,在一张证书里写入多个 DNS 名称;同一主域下的无限子域可用通配符证书(*.example.com),但通配符不覆盖 example.com 本身,通常需要同时写入主域。
典型原因是服务端只下发了站点证书、缺少中间证书。桌面 Chrome 会通过证书里的 AIA 地址自动补链,而安卓、微信内置浏览器和 Java 客户端不会,于是报 unable to get local issuer certificate。把证书换成 fullchain 即可解决。
Let’s Encrypt 用 certbot renew 配合 deploy-hook 自动重载:在续期配置中加入 deploy-hook = systemctl reload nginx,然后每天定时执行 certbot renew –quiet。宝塔等面板自带续签任务,但要确认续签后确实触发了 Web 服务重载。
常见于 CDN 与源站同时配置了 301 跳转,或源站把 HTTPS 请求又跳回 HTTP。排查方法:只保留一侧跳转规则,CDN 回源协议设置为 HTTPS,并确认 Nginx 的 X-Forwarded-Proto 判断逻辑正确,不要无条件 301。