SSL 证书部署实操全指南:Nginx / Apache / IIS / Tomcat / 宝塔 / CDN 六大环境配置、对比与排错
问题背景与根因:证书“装上了”,为什么浏览器还报警
绝大多数“SSL 安装失败”都不是证书本身有问题,而是三类根因:文件格式错配、证书链不完整、协议层配置缺失。
- 格式错配:Nginx / Apache 只认 PEM 文本格式(以
-----BEGIN CERTIFICATE-----开头),IIS / Tomcat 走 PKCS#12 容器(.pfx/.p12)。把二进制 DER 格式的.cer直接丢给 Nginx,加载时会直接报 PEM 解析失败。 - 链不完整:只部署了叶子证书,没带中间证书。桌面 Chrome 有 AIA 自动补链能力,看起来“正常”,但 Android、微信内置浏览器、Java 客户端、老版本 curl 会直接报
unable to get local issuer certificate。Nginx 的ssl_certificate必须指向“叶子 + 中间”的 fullchain,且不要包含根证书。 - 协议与端口层:写了
listen 443 ssl却没配ssl_certificate;安全组或防火墙没放行 443;CDN 只配了边缘证书没配回源协议。
几个必须掌握的时效事实:自 2020-09-01 起,CA/B 论坛规定公开信任的 TLS 服务器证书最长有效期 398 天;Let’s Encrypt 免费证书固定 90 天,必须做自动续期。TLS 1.0 / TLS 1.1 已被 RFC 8996 正式废弃,主流浏览器与 CDN 全部停止支持,配置中只应保留 TLS 1.2 与 TLS 1.3。SHA-1 签名证书已被全线拒绝,现在必须是 SHA-256。
还有一个高频坑是 SNI:一个 IP 挂多个站点时,客户端必须携带 SNI 扩展才能拿到正确证书。不支持 SNI 的老客户端(Android 4.x、Windows XP 上的 IE、部分 Java 6/7 客户端)会拿到默认站点的证书,报 hostname mismatch。这类问题只能靠升级客户端或给老客户端单独分配 IP 解决。
第一步:整理证书文件并完成格式转换
商业 CA 下发的压缩包通常包含四个文件:example.com.crt(叶子证书)、ca_bundle.crt 或 chain.crt(中间证书)、example.com.key(私钥)、example.com.pfx(已打包的 PKCS#12)。部署前先做三件事。
1. 合并 fullchain 并确认链结构
cat example.com.crt ca_bundle.crt > fullchain.pem
# 第一段必须是叶子证书,后面才是中间证书
grep -c "BEGIN CERTIFICATE" fullchain.pem # 正常为 2,若为 1 说明缺中间证书
2. 校验私钥与证书是否匹配
# RSA 证书
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# ECDSA 证书用公钥比对
openssl x509 -in fullchain.pem -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5
两条命令输出的 MD5 必须完全一致,否则就是“证书与私钥不匹配”,Nginx 会报 key values mismatch,IIS 导入时会提示密码错误。
3. 生成各环境需要的格式
# PEM 转 PFX(给 IIS / Tomcat 用),-certfile 用于补入中间证书
openssl pkcs12 -export -out server.pfx -inkey example.com.key -in fullchain.pem -certfile ca_bundle.crt -name "example.com" -passout pass:YourStrongPass
# PFX 反解成 PEM
openssl pkcs12 -in server.pfx -nodes -passin pass:YourStrongPass -out all.pem
# PKCS12 转 JKS(仅 Tomcat 7 及更老版本需要)
keytool -importkeystore -srckeystore server.pfx -srcstoretype PKCS12 -srcstorepass YourStrongPass -destkeystore tomcat.jks -deststoretype JKS -deststorepass YourStrongPass
另外两个细节:私钥权限必须收紧到 chmod 600,属主为 root 或 Web 服务用户;Windows 上生成的证书文件常带 CRLF 换行,拷到 Linux 后用 file example.com.key 检查,若显示 CRLF 就执行 sed -i 's/r$//' example.com.key fullchain.pem,否则 Nginx 可能报 bad base64 decode。
第二步:Nginx 与 Apache 的完整实操步骤
Nginx
- 确认编译了 SSL 模块:
nginx -V 2>&1 | grep -o with-http_ssl_module,无输出说明需要重装或加载模块。 - 放置文件:
mkdir -p /etc/nginx/ssl && cp fullchain.pem example.com.key /etc/nginx/ssl/ && chmod 600 /etc/nginx/ssl/example.com.key。 - 写入 server 块(模板见下一节)。
- 语法检查:
nginx -t,必须看到syntax is ok与test is successful。 - 平滑重载:
systemctl reload nginx,不要用 restart,否则会断开现有连接。
版本差异要注意:Nginx 1.25.1 之前 HTTP/2 写在 listen 行上 listen 443 ssl http2;,1.25.1 起改为独立的 http2 on; 指令,混用会告警。开启 OCSP Stapling 时 ssl_trusted_certificate 需要指向包含中间证书的链文件,并配置 resolver,否则 stapling 状态会一直是 “not enabled”。
Apache
- 启用模块:Debian/Ubuntu 执行
a2enmod ssl headers rewrite;RHEL/CentOS 确认/etc/httpd/conf.modules.d/00-ssl.conf中已加载mod_ssl.so。 - Apache 2.4.8 及以上只需两个指令:
SSLCertificateFile指向“叶子 + 中间”合并后的文件,SSLCertificateKeyFile指向私钥;SSLCertificateChainFile从 2.4.8 起已废弃,不需要再配。低于 2.4.8 的老版本才需要单独指定 ChainFile。 - 检查配置:
apachectl configtest或httpd -t,输出Syntax OK才能继续。 - 重载:
systemctl reload apache2,RHEL 系为systemctl reload httpd。
Apache 还有一个坑:全局 SSLProtocol 与 SSLSessionTickets 默认写在 /etc/apache2/mods-available/ssl.conf 里,改虚拟主机前先确认全局配置没有把 TLS 1.2 关掉。想拿 SSL Labs A+,还需要在虚拟主机里加 HSTS 头与 SSLHonorCipherOrder off(交由客户端选套件更利于 TLS 1.3)。
第三步:IIS、Tomcat、宝塔面板与 CDN 的实操步骤
IIS(Windows Server)
Win + R输入certlm.msc打开“本地计算机证书”管理控制台。- 右键“个人 → 所有任务 → 导入”,选择
server.pfx,输入导出密码,证书存储保持“个人”。 - 关键一步:把中间证书单独导入到“中间证书颁发机构 → 证书”存储,否则部分客户端会报链不完整(Windows 虽能通过 AIA 自动下载,但内网或离线环境会失败)。
- IIS 管理器 → 站点 → 绑定 → 添加 → 类型 https → 端口 443 → 选择证书 → 勾选“需要服务器名称指示(SNI)”,同一 IP 多站点必须勾。
- HTTP 跳转 HTTPS 需安装 URL Rewrite 模块,再在站点根目录
web.config写 301 规则。
Tomcat
Tomcat 8.5 及以上直接在 conf/server.xml 的 Connector 中配置 PKCS#12,无需先用 keytool 转 JKS;Tomcat 9/10 的默认 keystore 类型已是 PKCS12。只有 Tomcat 7 及更老版本才需要 JKS 加 keystoreFile / keystorePass。改完必须重启,reload 不生效。若前面有 Nginx 反向代理,Connector 里要加 proxyPort="443",否则应用生成的绝对链接会退化成 http。
宝塔面板
路径:网站 → 设置 → SSL。Let’s Encrypt 走 HTTP-01 验证,需要 80 端口可直接访问;如果域名已接入 CDN 且开启了代理,验证会失败,此时应先暂停 CDN 代理或改用 DNS-01 验证。粘贴付费证书时,PEM 框要填“叶子 + 中间”两段,KEY 框填私钥,顺序颠倒会直接报错。签发成功后务必打开“强制 HTTPS”。面板自身的证书在“面板设置 → SSL”里单独配置,与站点证书互不影响。
CDN
CDN 是两层证书:边缘证书(用户 ↔ CDN 节点)和回源协议(CDN ↔ 源站)。只配边缘证书、回源仍走 HTTP(Flexible 模式),而源站又强制 301 到 HTTPS,就会形成 ERR_TOO_MANY_REDIRECTS 死循环。正确做法是回源协议选 HTTPS,并保证源站证书有效未过期(Let’s Encrypt 证书同样可用);若用 Full (Strict) 模式,源站证书必须由公共 CA 签发且链完整。同时要把 CDN 回源 IP 段加入源站白名单,否则回源 443 会被防火墙拦掉。
配置示例:四套可直接复制的模板
Nginx(TLS 1.2/1.3 + HSTS + OCSP Stapling)
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-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;
add_header X-Content-Type-Options nosniff always;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header X-Forwarded-Proto https;
}
}
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
Apache(2.4.8+)
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/ssl/example.com/fullchain.pem
SSLCertificateKeyFile /etc/ssl/example.com/example.com.key
SSLProtocol -all +TLSv1.2 +TLSv1.3
Header always set Strict-Transport-Security "max-age=31536000"
<Directory "/var/www/html">
Require all granted
</Directory>
</VirtualHost>
Tomcat 9(conf/server.xml)
<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
SSLEnabled="true" scheme="https" secure="true" proxyPort="443">
<SSLHostConfig>
<Certificate certificateKeystoreFile="conf/server.pfx"
certificateKeystoreType="PKCS12"
certificateKeystorePassword="YourStrongPass"
type="RSA" />
</SSLHostConfig>
</Connector>
IIS web.config(HTTP 跳转 HTTPS)
<configuration>
<system.webServer>
<rewrite>
<rules>
<rule name="Force HTTPS" stopProcessing="true">
<match url="(.*)" />
<conditions>
<add input="{HTTPS}" pattern="^OFF$" />
</conditions>
<action type="Redirect" url="https://{HTTP_HOST}/{R:1}" redirectType="Permanent" />
</rule>
</rules>
</rewrite>
</system.webServer>
</configuration>
四套模板的共同点是:都只启用 TLS 1.2 / 1.3、都做了 HTTP 到 HTTPS 的 301、都不包含根证书。复制后只需要替换域名、路径和密码三项即可上线。
六大环境对比表格:文件格式、关键指令与生效方式
| 环境 | 证书文件格式 | 关键配置项 | 生效命令 | 最常见坑 |
|---|---|---|---|---|
| Nginx | fullchain.pem + .key | ssl_certificate / ssl_certificate_key | nginx -t && systemctl reload nginx | 只配叶子证书导致链不全 |
| Apache 2.4.8+ | fullchain.pem + .key | SSLCertificateFile(含中间)/ SSLCertificateKeyFile | apachectl configtest && systemctl reload apache2 | 多配了已废弃的 SSLCertificateChainFile |
| IIS 10 | .pfx(PKCS#12) | 站点绑定 + SNI + 中间证书存储 | 绑定保存即生效,无需重载 | 中间证书没进“中间证书颁发机构” |
| Tomcat 8.5+ | .pfx(PKCS12) | certificateKeystoreFile / Password | 重启 Tomcat | 密码不一致报 Cannot recover key |
| 宝塔面板 | PEM 文本粘贴 | SSL 页 + 强制 HTTPS | 面板自动 reload | CDN 代理下 HTTP-01 验证失败 |
| CDN | 边缘证书 + 回源证书 | 回源协议 HTTPS / Full (Strict) | 控制台保存即生效 | Flexible 模式导致循环重定向 |
表格里的“生效命令”是最容易出错的一环:Nginx 与 Apache 用 reload 即可,Tomcat 必须 restart,IIS 绑定保存后立即生效,但更换证书后需要在绑定里重新选择一次,否则仍在使用旧证书。文件格式上,只有 IIS 和 Tomcat 需要 .pfx,其余环境一律用 PEM 文本;如果 CA 只给了 pfx,用第一步的 openssl pkcs12 -in ... -nodes 反解出证书和私钥即可。
选择 CDN 回源模式时按安全等级排序:Full (Strict) > Full > Flexible。Flexible 意味着 CDN 到源站是明文 HTTP,既不安全又极易引发重定向循环,除非源站完全无法安装证书,否则不建议使用。
常见错误排查:真实报错与对应解法
以下报错均来自真实环境,按报错原文检索即可定位。
nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem": BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory)—— 路径写错,或 SELinux 拦截。RHEL/CentOS 执行restorecon -Rv /etc/nginx/ssl,或chcon -t httpd_sys_content_t /etc/nginx/ssl/*.pem。nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:04800064:PEM routines::bad base64 decode)—— 文件是 DER 二进制,或混入了多余文本、CRLF 换行。用openssl x509 -in fullchain.pem -text -noout验证,转换:openssl x509 -in cert.cer -inform DER -out cert.pem -outform PEM。SSL_CTX_use_PrivateKey() failed (SSL: error:0A080006:SSL routines::EVP_PKEY_CTX_set0_rsa_oaep_label:key values mismatch)—— 证书与私钥不配对,回到第一步用 modulus 或 pubkey 比对。- Chrome 报
ERR_CERT_AUTHORITY_INVALID—— 缺中间证书,grep -c "BEGIN CERTIFICATE" fullchain.pem的结果必须大于等于 2。 - Chrome 报
ERR_SSL_PROTOCOL_ERROR—— 443 端口上跑的不是 TLS 服务,或反向代理把 https 请求转发到了 http 端口。 - Apache
AH02572: Failed to configure at least one certificate and key for example.com:443—— 证书路径、权限或格式有问题,先ls -l确认运行用户可读。 - Apache
AH02032: Hostname example.com provided via SNI and hostname provided via HTTP have no compatible SSL setup—— 同 IP 多虚拟主机的 SNI 配置冲突,检查每个 443 虚拟主机是否都写了SSLEngine on与正确的证书。 - Tomcat
java.security.UnrecoverableKeyException: Cannot recover key—— PKCS12 容器密码与私钥密码不一致,用统一密码重新导出server.pfx。 - 浏览器
ERR_TOO_MANY_REDIRECTS—— CDN 回源协议与源站 301 冲突,把回源改成 HTTPS 并调整源站跳转规则。 - 命令行
curl: (60) SSL certificate problem: unable to get local issuer certificate—— 服务端未下发中间证书,属于服务端问题,不是客户端 CA 库过期。
效果验证:三条命令加一个评级
无论哪种环境,部署完成后都跑同一套验证。
# 1. 看证书链是否完整下发(s: 主题,i: 颁发者,应能看到叶子 + 中间两级)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E "^ [0-9] s:|^ i:"
# 2. 校验结果必须是 0 (ok),非 0 说明链有问题
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | grep "Verify return code"
# 3. 查看实际生效的颁发者与到期时间
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -dates -issuer
# 4. 证明 TLS 1.1 已关闭(应返回协议错误)
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null 2>&1 | grep -i "protocol version"
# 5. 检查 HSTS 头与 301 跳转
curl -sI https://example.com | grep -i strict-transport-security
curl -sI http://example.com | head -1
浏览器侧:地址栏点开小锁 → “连接是安全的” → 证书有效;F12 控制台里不应出现 Mixed Content 警告,否则说明页面里仍有 http 资源。
最后跑一次 SSL Labs:https://www.ssllabs.com/ssltest/analyze.html?d=example.com,目标是 A 或 A+。A+ 的硬性条件是启用 HSTS(max-age 不低于 15552000)且支持 TLS 1.3;如果只拿到 B,通常是仍在支持 TLS 1.0/1.1 或使用了 3DES 等弱套件。需要接入监控时可用 API:curl "https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done&maxAge=24"。
到期监控:openssl x509 -checkend 2592000 -noout -in fullchain.pem,返回 0 表示 30 天内不会过期,返回 1 就该续期了。Let’s Encrypt 的 90 天有效期务必配置 certbot 自动续期并加 --deploy-hook "systemctl reload nginx",否则新证书下载了也不会被加载。
常见问题
pem 与 crt/cer 都是证书本体,区别只在编码,pem 是 Base64 文本;key 是私钥;csr 是申请文件,部署时用不到;pfx/p12 是证书加私钥的打包容器。Nginx、Apache 用 pem + key,IIS、Tomcat 用 pfx。
不需要。用 certbot 安装后系统会写入 systemd timer 或 cron,每天检查两次,剩余 30 天内自动续期。关键是加 –deploy-hook “systemctl reload nginx” 让新证书生效,并先用 certbot renew –dry-run 演练一次。手动下载的证书则必须自己续。
典型缺中间证书。桌面 Chrome 会通过证书里的 AIA 地址自动补链,微信内置浏览器和老 Android 不会。用 openssl s_client -showcerts 看是否只下发了一张证书,把 ca_bundle 合并进 fullchain 后重载即可。
用 SNI。Nginx 为每个域名写独立 server 块并各自配置 ssl_certificate;Apache 每个 VirtualHost *:443 单独配证书;IIS 绑定时勾选“需要服务器名称指示”。只要客户端支持 SNI 就能正确分流。
自 2020-09-01 起,公开信任的 TLS 服务器证书最长 398 天,CA 可签发更短。Let’s Encrypt 免费证书固定 90 天,这是其策略而非限制。到期必须换新证书,不能把同一张证书的有效期续长。
说明回源协议是 HTTP(Flexible),而源站又强制 301 到 HTTPS。把 CDN 回源协议改成 HTTPS,并确保源站证书有效、链完整;Full (Strict) 模式还要求源站证书由公共 CA 签发。改完清一次 CDN 缓存再测。