跳到主要内容
HTTPS安装配置

HTTPS 证书部署实战:Nginx、Apache、IIS 配置、TLS 优化与排错指南

HTTPS 证书部署实战:Nginx、Apache、IIS 配置、TLS 优化与排错指南 — 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,可在证书管理器中右键证书 → 所有任务 → 管理私钥,添加读取权限。

三端配置对比与 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 属性。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。