HTTPS 证书部署实战:Nginx、Apache、IIS 配置、TLS 优化与排错指南
问题背景与根因:HTTPS 部署为什么总在最后一步失败
原文只回答了”支持哪些服务器”这类售前问题:需要有服务器控制权、需要知道用的是 Apache、Nginx、IIS、Tomcat 还是宝塔面板、需要确认 CMS 是否支持 HTTPS。这些是前置条件,不是部署方案。真正落地时,失败原因高度集中在六类:
- 证书链不完整:只部署了站点证书(example.com.crt),漏掉中间证书(Intermediate CA)。桌面浏览器会通过 AIA 字段自动补链,所以”看起来正常”;但 curl、Java、Android 旧版本、微信内置浏览器会直接报
unable to get local issuer certificate。 - 私钥与证书不匹配:续期时换了 cert 却没换 key,Nginx 启动即失败。
- 443 端口未放行:云厂商安全组、firewalld/ufw、iptables 三层任缺一层,现象是连接超时而非证书报错,容易被误判为证书问题。
- 协议版本过旧:仍启用 TLSv1.0/1.1,这两个版本已被 RFC 8996 正式弃用,Chrome、Firefox、Safari 会直接拒绝握手。
- 混合内容:页面里仍有 http:// 的 js、css、图片,地址栏显示”不安全”,HSTS 也无法真正生效。
- 有效期管理缺失:自 2020-09-01 起,公有 CA 签发的 TLS 证书最长有效期被限制为 398 天;Let’s Encrypt 默认 90 天。没有自动续期,一年后必然过期。
多域名场景还有两个高频问题:IIS 绑定 443 时未勾选”需要服务器名称指示(SNI)”,导致同一 IP 上多个站点互相串证书;Nginx 未正确配置 server_name 或缺少默认 server 块,同样会返回错误的证书。下文按”准备 → 三端实操 → 参数对比 → 排错 → 验证”的顺序给出可直接执行的方案。
部署前准备:CSR、私钥与证书文件清单
先确认 OpenSSL 版本,低于 1.1.1 不支持 TLS 1.3 与 -addext 参数,建议升级到 3.x:
openssl version -a
生成 2048 位 RSA 私钥与 CSR(生产环境推荐 RSA 2048 或 ECDSA P-256;RSA 4096 会显著增加握手耗时,安全收益有限):
openssl req -new -newkey rsa:2048 -sha256 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
签发前务必检查 CSR 的 SAN 是否完整——只写 CN 不写 SAN 的证书在 Chrome 58+ 会被判定为 NET::ERR_CERT_COMMON_NAME_INVALID:
openssl req -in example.com.csr -noout -text | grep -A2 "Subject Alternative Name"
拿到证书后,用模数(RSA)或公钥(ECDSA)比对私钥是否匹配,这一步能提前拦住大部分启动失败:
openssl x509 -noout -modulus -in example.com.crt | openssl sha256
openssl rsa -noout -modulus -in example.com.key | openssl sha256
两条命令输出的哈希必须完全一致。文件清单与用途对照:
| 文件 | 内容 | 使用场景 |
|---|---|---|
| example.com.key | 私钥 | 三端通用,权限设为 600 |
| example.com.csr | 证书签名请求 | 提交给 CA |
| example.com.crt | 站点证书(叶子证书) | 单独使用会缺链 |
| chain.crt / ca-bundle | 中间证书 | 与站点证书拼接 |
| fullchain.pem | 站点证书 + 中间证书 | Nginx ssl_certificate、Apache 2.4.8+ SSLCertificateFile |
| example.com.pfx | 含私钥的 PKCS#12 | IIS 导入 |
拼接 fullchain 的顺序必须是”叶子证书在前、中间证书在后”,顺序颠倒会导致部分客户端握手失败:
cat example.com.crt chain.crt > fullchain.pem
chmod 600 example.com.key
IIS 需要 PFX,可用 OpenSSL 转换:
openssl pkcs12 -export -out example.com.pfx
-inkey example.com.key -in fullchain.pem -passout pass:YourPfxPassword
Nginx 配置实操:从 80 跳转到 TLS 1.3
证书放到 /etc/nginx/ssl/,配置两个 server 块,80 端口只做 301:
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-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
ssl_prefer_server_ciphers off; # TLS 1.3 由客户端决定顺序,保持 off
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
ssl_stapling off; # Let's Encrypt 已于 2025 年停止 OCSP 服务
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
add_header X-Content-Type-Options nosniff always;
root /var/www/example;
index index.php index.html;
}
几个关键点:ssl_certificate 必须指向 fullchain 而不是叶子证书;ssl_session_cache 用 shared 内存可让多个 worker 共享会话,减少重复握手;OCSP Stapling 在新环境下已无意义,Let’s Encrypt 自 2025 年起停止提供 OCSP responder,继续开启只会产生告警和额外解析开销,建议直接 ssl_stapling off。若使用仍支持 OCSP 的商业 CA,则改为 on 并配置 ssl_trusted_certificate 指向链文件。
检查并重载:
nginx -t
systemctl reload nginx
systemctl status nginx --no-pager
nginx -t 会同时校验证书文件可读性与私钥匹配性,输出 syntax is ok / test is successful 才算通过。若出现 [warn] "ssl_stapling" ignored, issuer certificate not found,说明缺中间证书或未配 trusted certificate。
Apache 配置实操:SSLCertificateFile 与协议裁剪
Apache 2.4.8 起不再需要单独的 SSLCertificateChainFile,直接把 fullchain 内容放进 SSLCertificateFile 即可。虚拟主机配置:
<VirtualHost *:80>
ServerName example.com
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
ServerName example.com
ServerAlias www.example.com
DocumentRoot /var/www/example
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305
SSLHonorCipherOrder off
SSLSessionTickets off
SSLUseStapling off
Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains"
<Directory /var/www/example>
Require all granted
</Directory>
</VirtualHost>
若使用 Apache 2.4.7 及更早版本(如 CentOS 7 默认的 2.4.6),必须额外写 SSLCertificateChainFile /etc/httpd/ssl/chain.crt,否则同样会缺链。检查与重载:
apachectl configtest # 或 httpd -t
systemctl reload httpd # Debian/Ubuntu 为 apache2
apachectl -M | grep -E "ssl|http2"
启用 HTTP/2:Debian/Ubuntu 执行 a2enmod http2,或确认 mod_http2 已加载,然后在 VirtualHost 内加 Protocols h2 http/1.1。注意 Apache 的 HTTP/2 只在 HTTPS 下生效。
常见报错 AH02572: Failed to configure at least one certificate and key for example.com:443,含义是证书或私钥文件路径错误、权限不足(httpd 用户无法读取 600 权限的 key),或 SELinux 上下文不对。CentOS/RHEL 下需要:
chcon -t cert_t /etc/httpd/ssl/*.pem /etc/httpd/ssl/*.key
restorecon -Rv /etc/httpd/ssl
IIS 配置实操:PFX 导入、SNI 绑定与 PowerShell 命令
IIS 使用 Windows 证书存储,流程是”导入 PFX → 绑定 443 → 勾选 SNI”。图形界面用 certlm.msc(本地计算机 → 个人 → 证书 → 所有任务 → 导入),把 PFX 导入”个人”存储。命令行等价操作:
$pwd = ConvertTo-SecureString -String "YourPfxPassword" -AsPlainText -Force
Import-PfxCertificate -FilePath C:certsexample.com.pfx `
-CertStoreLocation Cert:LocalMachineMy -Password $pwd
Get-ChildItem Cert:LocalMachineMy | Where-Object {$_.Subject -like "*example.com*"} |
Select-Object Subject, Thumbprint, NotAfter
用 PowerShell 建立带 SNI 的 HTTPS 绑定(SslFlags 1 表示启用 SNI,3 表示 SNI + 集中证书存储):
New-WebBinding -Name "Default Web Site" -Protocol https -Port 443 `
-HostHeader "example.com" -SslFlags 1
Get-WebBinding -Name "Default Web Site" -Protocol https |
ForEach-Object { $_.AddSslCertificate("THUMBPRINT_HERE", "My") }
验证绑定是否生效:
netsh http show sslcert hostnameport=example.com:443
输出中应能看到 Certificate Hash 与 Application ID。多个站点共用 443 时,每个站点必须有自己的 HostHeader 并勾选 SNI,否则后绑定的站点会覆盖先绑定的证书,表现为”访问 A 域名却拿到 B 域名证书”。
Windows Server 2012 R2 及以上默认启用 TLS 1.2;如需禁用旧协议,通过注册表调整并重启:
New-Item -Path "HKLM:SYSTEMCurrentControlSetControlSecurityProvidersSCHANNELProtocolsTLS 1.0Server" -Force
New-ItemProperty -Path "HKLM:SYSTEMCurrentControlSetControlSecurityProvidersSCHANNELProtocolsTLS 1.0Server" `
-Name "Enabled" -Value 0 -PropertyType DWORD -Force
IIS 上另一类常见故障是站点启动报 0x80070005 拒绝访问,原因多为私钥 ACL 未授予 IIS_IUSRS 或 NETWORK SERVICE,可在证书管理器中右键证书 → 所有任务 → 管理私钥,添加读取权限。
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
- Wildcard 通配符 SSL 证书安装部署续费申请
三端配置对比与 TLS 参数推荐
下表把 Nginx、Apache、IIS 在 HTTPS 部署中的关键差异列在一起,便于迁移或混用环境时对照:
| 对比项 | Nginx | Apache | IIS |
|---|---|---|---|
| 证书文件格式 | PEM(fullchain.pem) | PEM(2.4.8+ 用 fullchain) | PFX(PKCS#12) |
| 证书指令 | ssl_certificate / ssl_certificate_key | SSLCertificateFile / SSLCertificateKeyFile | 图形绑定 + netsh http |
| 协议控制 | ssl_protocols | SSLProtocol | SCHANNEL 注册表 |
| 加密套件 | ssl_ciphers | SSLCipherSuite | 组策略 / 注册表 |
| HTTP/2 开关 | listen 443 ssl http2 或 http2 on | Protocols h2 http/1.1 | Windows Server 2016+ 默认支持 |
| 配置检查 | nginx -t | apachectl configtest | Get-WebBinding / netsh http show sslcert |
| 重载方式 | systemctl reload nginx | systemctl reload httpd | iisreset /noforce |
证书与协议参数的推荐值(当前基线):
| 项目 | 推荐值 | 说明 |
|---|---|---|
| 证书最长有效期 | 公有 CA ≤ 398 天 | 2020-09-01 起生效,按 398 天规划续期 |
| Let’s Encrypt | 90 天 | 必须自动化续期 |
| 协议版本 | TLSv1.2 + TLSv1.3 | TLS 1.0/1.1 已被 RFC 8996 弃用 |
| 密钥类型 | ECDSA P-256 或 RSA 2048 | RSA 4096 握手开销大 |
| OCSP Stapling | 关闭(Let’s Encrypt) | LE 已停止 OCSP 服务 |
| HSTS max-age | 31536000 秒 | 首次上线建议先用 300 秒灰度 |
HSTS 要特别小心:一旦下发 includeSubDomains 并被浏览器缓存,回退成本极高。建议第一周用 max-age=300,确认所有子域都有可用证书后再改到一年。
常见错误排查:真实报错与定位命令
1) nginx: [emerg] SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
私钥与证书不匹配。用前文的 modulus 比对命令确认;若不一致,重新找出与 key 配对的证书,或直接用该 key 重新签发。
2) curl: (60) SSL certificate problem: unable to get local issuer certificate
服务器缺中间证书。用 openssl s_client -connect example.com:443 -servername example.com -showcerts 查看返回的证书条数,正常应为 2 条以上;只有 1 条就是没配链。
3) SSL_ERROR_RX_RECORD_TOO_LONG,或 400 Bad Request (The plain HTTP request was sent to HTTPS port)
用 https 访问了 80 端口,或反向代理后面是 http 而上游按 https 解析。检查 listen 与 SLB/负载均衡的回源协议。
4) NET::ERR_CERT_COMMON_NAME_INVALID
访问的域名不在证书 SAN 列表里(www 与非 www 被视为两个域名)。重新签发带双 SAN 的证书,或做 301 统一到一个域名。
5) Mixed Content: The page at ‘https://…’ was loaded over HTTPS, but requested an insecure element ‘http://…’
页面内仍有 http 资源。除了改源码,可先加 add_header Content-Security-Policy "upgrade-insecure-requests"; 应急,但无法解决第三方接口硬编码 http 的问题。
6) AH02572: Failed to configure at least one certificate and key for example.com:443
Apache 读不到证书文件:检查路径、chmod 600 后 httpd 用户是否有权读、SELinux 上下文是否为 cert_t。
7) 连接超时(无任何 TLS 报错)
这不是证书问题。依次检查云安全组 443 入方向、firewall-cmd --list-ports 或 ufw status、ss -lntp | grep 443。
效果验证与自动化续期监控
部署完成后用三条命令验收。第一条看证书链与有效期:
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
输出中的 notAfter 应晚于当前时间且距签发不超过 398 天;issuer 应是中间 CA 而不是根 CA。第二条确认 TLS 1.0/1.1 已被拒绝:
openssl s_client -connect example.com:443 -tls1_1 </dev/null
预期返回 alert protocol version 或 no protocols available。第三条看跳转与 HSTS 头:
curl -I http://example.com
curl -sI https://example.com | grep -i strict-transport-security
自动续期以 Let’s Encrypt 为例,certbot 安装后先试运行一次:
certbot renew --dry-run
systemctl list-timers | grep certbot
certbot 会写入 systemd timer(或 cron),每日两次检查。续期后需要重载服务,在 /etc/letsencrypt/renewal-hooks/deploy/reload.sh 中放置:
#!/bin/sh
nginx -t && systemctl reload nginx
# Apache: apachectl configtest && systemctl reload httpd
别忘了 chmod +x,否则 hook 会静默失败,证书更新了但进程仍加载旧证书。最后做一次外部体检:SSL Labs 评级目标 A 及以上,重点看 Certificate Chain Complete 是否为 Yes、TLS 1.0/1.1 是否为 No。监控层面建议对 443 端口做每日探测,在证书剩余 21 天(398 天证书)或 14 天(90 天证书)时告警。
常见问题
证书有效期到底是 398 天还是 90 天?
两个都对,但适用范围不同。2020-09-01 起,所有公有 CA 签发的 TLS 证书最长有效期被限制为 398 天;Let’s Encrypt 作为免费 CA,自己把有效期定为 90 天(近年还提供可选的 6 天短期证书)。所以规划续期时,商业证书按 398 天倒排,Let’s Encrypt 按 90 天并强制自动化。
为什么浏览器显示正常,但 curl 和手机 App 报证书错误?
典型缺中间证书。桌面浏览器会通过证书里的 AIA 字段自动下载中间证书补全链,所以看起来没问题;curl、Java、旧版 Android、微信内置浏览器不做 AIA 补链,直接报 unable to get local issuer certificate。解决办法是把站点证书和中间证书拼成 fullchain 后重新部署,再用 openssl s_client -showcerts 确认返回 2 条以上证书。
Nginx 的 ssl_stapling 还要开吗?
用 Let’s Encrypt 的话不要开。Let’s Encrypt 已于 2025 年停止提供 OCSP responder 服务,开启 stapling 只会产生 issuer certificate not found 之类的告警和额外解析开销,建议 ssl_stapling off。若使用仍支持 OCSP 的商业 CA,则开启并同时配置 ssl_trusted_certificate 指向链文件。
同一台服务器多个站点共用 443,为什么证书会串?
缺少 SNI。Nginx 靠 server_name 匹配,需要为每个域名建独立 server 块,并保证有一个 default_server 兜底;IIS 则必须在绑定 443 时勾选”需要服务器名称指示”,PowerShell 中对应 -SslFlags 1。否则客户端不带 SNI 或配置缺失时会命中第一个绑定,返回别的域名证书。
启用 HSTS 后还能回退到 HTTP 吗?
很难。HSTS 由浏览器缓存,max-age 内即使服务器撤掉响应头,浏览器仍强制 HTTPS;加了 includeSubDomains 还会波及所有子域。上线策略建议先用 max-age=300 观察一周,确认所有子域、所有第三方资源都能走 HTTPS,再逐步提高到 31536000,最后再考虑是否加入 preload 列表(加入后移除需要数月)。
从 HTTP 切到 HTTPS 后排名和流量会掉吗?
不会因为 HTTPS 本身掉,通常是 301 链路没做好或混合内容导致。确保 80 端口用 301(不是 302)指向 https,且跳转目标域名与证书域名完全一致(www 与非 www 不要来回跳);页面内所有资源改相对协议或 https;最后在 Search Console 或站长平台重新提交 sitemap 与 HTTPS 属性。