SSL 证书安装教程配置示例:Nginx 1.26 与 Apache 2.4 的 TLS 1.3 套件、OCSP Stapling 参数逐行怎么写
把证书装对其实只有三件事:fullchain.pem 按「站点证书→中间证书」顺序拼接、私钥设 600 权限、配置里 ssl_certificate 与 ssl_certificate_key 成对出现后 reload——剩下让人以为「装完仍不安全」的,几乎都是协议版本与密码套件参数没跟上版本。 Nginx 自 1.23.4 起 ssl_protocols 的默认值已改为 TLSv1.2 TLSv1.3,旧模板里若仍写 TLSv1 TLSv1.1,SSL Labs 扫描会直接判为 B 级以下并标注 TLS 1.0 enabled。 ssl_ciphers 只对 TLS 1.2 生效;TLS 1.3 的套件必须用 ssl_conf_command Ciphersuites(Nginx ≥ 1.19.4)设置,写进 ssl_ciphers 里不会报错但也不会生效。 OCSP Stapling 起不来的最常见原因是缺 resolver 与 ssl_trusted_certificate:Nginx 需要 resolver 223.5.5.5 119.29.29.29 valid=300s 才能主动去拉取 OCSP 响应并缓存。 一条命令完成验收:openssl s_client -connect example.com:443 -servername example.com -status /dev/null | grep -E "Protocol|Cipher|OCSP Response Status",同时看到协议版本、套件与装订状态。
为什么同一张证书换个配置文件就握手失败?先看清 5 类根因
同一张 fullchain.pem,在测试机上 curl 通、到生产机却握手失败,九成不是证书本身的问题,而是配置写法。下面按排查频率从高到低列出 5 类根因,每条都给出可复现的判定命令——这也是绝大多数「ssl证书 安装教程配置示例」类文档最容易漏掉的一环。
根因一:链文件不完整或顺序错。Nginx 的 ssl_certificate 必须指向「站点证书 + 中间证书」的拼接文件(Let’s Encrypt 输出目录里的 fullchain.pem)。只放站点证书时,Chrome/Firefox 因自带中间证书缓存仍会显示小锁,而 curl、Java、Python requests 会直接抛 SSL certificate problem: unable to get local issuer certificate。数一下证书张数即可判定:
# 统计 PEM 里的证书数量:期望 2 或 3;输出 1 说明只有站点证书,缺中间证书
awk 'BEGIN{c=0} /BEGIN CERTIFICATE/{c++} END{print c}' /etc/nginx/ssl/fullchain.pem
# 正确拼接顺序:站点证书在前,中间证书在后(顺序反了部分客户端会报链错误)
cat cert.pem chain.pem > fullchain.pem
# 核对证书与私钥是否配对:两条命令输出的 md5 必须一致
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa -noout -modulus -in privkey.pem | openssl md5
根因二:协议版本与套件不匹配。ssl_protocols 的默认值在版本间改过,沿用 2018 年老模板的站点常常踩坑:
| 服务器与版本 | 协议默认值 | 典型症状 |
|---|---|---|
| Nginx < 1.23.4 | TLSv1 TLSv1.1 TLSv1.2 |
扫描器标 TLS 1.0 enabled,PCI DSS 不合规 |
| Nginx ≥ 1.23.4 | TLSv1.2 TLSv1.3 |
老模板未显式声明时反而漏开 TLS 1.3 |
| Apache 2.4.35+ | SSLProtocol all -SSLv3 |
仍含 TLSv1/1.1,需显式减掉 |
# 确认实际版本与编译参数(Nginx 1.23.4 是协议默认值的分水岭)
nginx -v && nginx -V 2>&1 | tr ' ' 'n' | grep -E 'openssl|TLS'
# 打印合并后的完整生效配置,确认没有被 include 的旧文件覆盖
nginx -T | grep -nE 'ssl_protocols|ssl_ciphers|ssl_certificate'
根因三:SNI 未命中。同一 IP 上多个 server 块时,不带 SNI 的客户端会落到 default_server,拿到的证书域名对不上。据 RFC 6066,SNI 在 ClientHello 中传递,因此用 openssl s_client 复现时必须显式加 -servername,否则测的根本不是浏览器行为:
# 带 SNI 与不带 SNI 对比,前者应返回目标域名证书,后者返回默认站点证书
openssl s_client -connect 203.0.113.10:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer
根因四:OCSP 无法回源。ssl_stapling on 只是「允许装订」,真正拉取响应依赖 resolver 指令。缺少 resolver 时 nginx -t 不报任何错,但握手时服务器端不发响应:
# 配置片段:resolver 不可省略,ssl_trusted_certificate 用于校验响应签名
ssl_stapling on;
ssl_stapling_verify on;
resolver 1.1.1.1 8.8.8.8 valid=300s; # 默认无 resolver,必须显式指定
resolver_timeout 5s;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
# 验证:正常应输出 "OCSP Response Status: successful",异常则是 "OCSP response: no response sent"
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null | grep -A2 'OCSP'
根因五:私钥格式与权限。OpenSSL 3.x 的 genpkey 默认输出 PKCS#8(-----BEGIN PRIVATE KEY-----),而部分老版本 Java/Tomcat 与 IIS 导入向导只认 PKCS#1(-----BEGIN RSA PRIVATE KEY-----);SELinux 开启的机器上,文件放对位置仍可能因安全上下文被拒:
# PKCS#8 转 PKCS#1(OpenSSL 3.x 用 -traditional,1.1.1 直接 openssl rsa)
openssl pkey -in privkey.pem -traditional -out privkey.pkcs1.pem
# 权限落地:目录 700、私钥 600 且属主为 root
install -d -m 700 -o root -g root /etc/nginx/ssl
install -m 600 -o root -g root privkey.pem /etc/nginx/ssl/privkey.pem
restorecon -Rv /etc/nginx/ssl # SELinux 开启时修正 httpd_config_t 上下文
# 重载前必做语法检查,reload 而非 restart,避免中断现有连接
nginx -t && systemctl reload nginx
据 Let’s Encrypt 官方文档,其证书有效期 90 天、建议到期前 30 天续期,因此上述配置应保证「续期后只 reload 即生效」,而不是依赖手工改路径。本文后续的配置示例默认你手上已有 fullchain.pem、privkey.pem、chain.pem 三件套,不再重复 CSR 生成与 ACME 签发流程。
从文件校验到平滑重载:7 步完成 SSL 证书安装配置
证书文件到手后别急着改配置。这份 ssl证书 安装教程配置示例把”装”拆成 7 个可回滚的步骤:前 3 步只读、不碰生产;第 4~5 步落地;第 6~7 步才是切换与验证。任何一步失败都可以直接停手,不影响线上服务。
-
第 1 步:先看证书本身写了什么。据 RFC 5280,有效期由 notBefore/notAfter 定义;而据 RFC 6125 与现代浏览器实现,域名匹配只认 SAN 扩展,CN 早已被忽略(Chrome 58 起彻底不校验 CN)。
# -noout 抑制 PEM 原文输出,只看摘要字段 openssl x509 -in fullchain.pem -noout -subject -issuer -dates -fingerprint -sha256 # 单独把 SAN 拎出来看,确认覆盖 www 与裸域 openssl x509 -in fullchain.pem -noout -ext subjectAltName判读要点:notAfter 必须晚于当前时间且留足续期窗口;SAN 列表要包含你实际访问的每一个主机名,通配符
*.example.com只覆盖一级子域。 -
第 2 步:确认证书与私钥配对。比对两者的公钥指纹,不一致会在 reload 时炸出
SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。openssl x509 -noout -pubkey -in fullchain.pem | openssl sha256 openssl pkey -pubout -in privkey.pem | openssl sha256 # 两行输出的哈希必须逐字符相同 -
第 3 步:单独验一次信任链。把 fullchain.pem 拆成站点证书 cert.pem 与中间证书 chain.pem(顺序:站点证书在前),再用
-untrusted指定中间证书。openssl verify -untrusted chain.pem cert.pem # 期望输出:cert.pem: OK # 常见失败:error 20 at 0 depth lookup: unable to get local issuer certificate # → chain.pem 缺中间证书或顺序颠倒若中间证书带交叉签名(如 Let’s Encrypt 的 R3 同时指向 ISRG Root X1 与 DST Root CA X3),优先选指向 ISRG Root X1 或 DigiCert Global Root G2 的那一条,覆盖面最广。
-
第 4 步:落地并收紧权限。Nginx master 以 root 启动、读完私钥后 fork 出 worker 并降权,因此”600 + root 属主”既安全又能正常工作。
chmod 700 /etc/nginx/ssl install -D -m 600 -o root -g root privkey.pem /etc/nginx/ssl/example.com.key install -D -m 644 -o root -g root fullchain.pem /etc/nginx/ssl/example.com.crt install -D -m 644 -o root -g root chain.pem /etc/nginx/ssl/example.com.chain.pem -
第 5 步:写配置。关键细节:
ssl_trusted_certificate指向 chain.pem 而非 fullchain.pem,否则 OCSP 校验会把站点证书当成签发者而失败。另注意ssl_ciphers只管 TLS 1.2 及以下,TLS 1.3 套件需 OpenSSL 1.1.1+ 配合ssl_conf_command Ciphersuites(nginx ≥ 1.19.4)。ssl_certificate /etc/nginx/ssl/example.com.crt; ssl_certificate_key /etc/nginx/ssl/example.com.key; ssl_trusted_certificate /etc/nginx/ssl/example.com.chain.pem; # 供 OCSP 校验 ssl_protocols TLSv1.2 TLSv1.3; # 1.26 默认即 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_conf_command Ciphersuites TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256; ssl_prefer_server_ciphers off; # 默认 off,TLS 1.3 由客户端排序 ssl_session_cache shared:SSL:10m; # 默认 none,务必显式开启 ssl_session_timeout 1d; # 默认 5m ssl_stapling on; # 默认 off ssl_stapling_verify on; # 默认 off resolver 1.1.1.1 8.8.8.8 valid=300s; resolver_timeout 5s;Apache 2.4 对应写法是
SSLUseStapling on(默认 off)、SSLStaplingCache "shmcb:logs/ssl_stapling(32768)"(缺失会报AH02217: ssl_stapling_init_cert: can't retrieve issuer certificate),以及SSLStaplingResponderTimeout 10(默认 10 秒)。 -
第 6 步:语法检查后平滑重载。注意 Tomcat 不在此列——改 server.xml 必须重启 JVM,热加载对 Connector 无效。
nginx -t && nginx -s reload # 或 systemctl reload nginx apachectl configtest && systemctl reload httpd # 确认 master 未重启、worker 已换新 ps -o lstart -p $(cat /run/nginx.pid)
| 运行环境 | 生效命令 | 是否中断长连接 | 证书/私钥改动是否需重启进程 |
|---|---|---|---|
| Nginx 1.26 | nginx -s reload |
否,老 worker 处理完存量请求后退出 | 否 |
| Apache 2.4 | systemctl reload httpd |
否,优雅重启 | 否 |
| Tomcat 9/10 | systemctl restart tomcat |
是 | 是,必须重启 JVM |
第 7 步:分三次抽检,别只测一次就收工。上线 5 分钟内做即时验证;1 小时后跑完整扫描;24 小时后回看 OCSP 装订缓存是否已填充、监控是否采到新的到期时间。
# 1) 握手与链,看 Verify return code: 0 (ok) 与 OCSP Response Status: successful
echo | openssl s_client -connect example.com:443 -servername example.com -status -CAfile chain.pem 2>/dev/null | openssl x509 -noout -dates
# 2) 端到端
curl -sSI --tlsv1.3 https://example.com | head -1
# 3) 一小时后的深度体检(Mozilla 推荐的扫描工具之一)
testssl.sh --quiet --protocols --ciphers --ocsp example.com
若第 1 步输出了 OCSP response: no response sent,多数是 resolver 不可达或 chain.pem 里缺中间证书,而不是证书本身有问题。配置基线可对照 Mozilla SSL Configuration Generator(intermediate 档位)与 Let’s Encrypt 官方文档中关于 fullchain.pem 与 chain.pem 的拆分说明。
配置示例:Nginx 1.26、Apache 2.4.62、Tomcat 10.1 的片段逐行对照
三个平台配同一张证书,最容易抄错的是参数名——Nginx 叫 ssl_protocols,Apache 叫 SSLProtocol,Tomcat 塞进 SSLHostConfig 的 protocols 属性里。下面按「可直接粘贴」的粒度给出 ssl证书 安装教程配置示例,并逐行说明每个值的来源、默认值和取值范围。
Nginx 1.26.0:server 块核心片段怎么写?
以下片段放在 listen 443 ssl; 之后。据 Nginx 官方文档,ssl_protocols 自 1.23.4 起默认值已变为 TLSv1.2 TLSv1.3,但仍建议显式声明,避免旧配置迁移时残留 TLSv1/1.1。
server {
listen 443 ssl;
http2 on; # Nginx ≥1.25.1 用 on,旧版为 listen 443 ssl http2;
ssl_certificate /etc/nginx/ssl/example.com.crt; # 站点证书(含或不含中间证书均可)
ssl_certificate_key /etc/nginx/ssl/example.com.key; # 私钥,权限建议 600 且属主 root
ssl_trusted_certificate /etc/nginx/ssl/chain.pem; # 仅用于 OCSP 校验,不下发给客户端
ssl_protocols TLSv1.2 TLSv1.3; # 默认 TLSv1.2 TLSv1.3(1.23.4+)
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; # 默认 off;TLS1.3 下由客户端选序,保持 off 更利于 CDN/移动端
ssl_session_cache shared:SSL:10m; # 1 MB ≈ 4000 会话,10m 约 4 万会话,日 PV 十万级够用
ssl_session_timeout 1d; # 默认 5m
ssl_session_tickets off; # 默认 on;关闭以支持前向保密轮换
# TLS 1.3 套件必须单独设,需 Nginx ≥1.19.4 且链接 OpenSSL 1.1.1+
ssl_conf_command Ciphersuites TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256;
ssl_stapling on; # 默认 off
ssl_stapling_verify on;
resolver 223.5.5.5 119.29.29.29 valid=300s;
resolver_timeout 5s;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
}
HSTS 首次上线不要直接上一年:先用 max-age=300 观察一周,确认全站子域均支持 HTTPS 后,再阶梯提升到 31536000。据 Let’s Encrypt 文档,一旦浏览器缓存了 includeSubDomains 且某子域只有 HTTP,回滚成本极高。改完务必 nginx -t && nginx -s reload,再用 openssl s_client -connect example.com:443 -status </dev/null | grep -A2 "OCSP Response" 验证 stapling 是否真的生效——返回 OCSP Response Status: successful 才算成功。
Apache 2.4.62 与 Nginx 的写法差在哪?
Apache 的协议开关是「先 -all 再 +」的增量语法,与 Nginx 的空白分隔列表语义完全不同;漏掉 -all 会让 httpd 默认的 SSLProtocol all -SSLv3 继续放行 TLSv1。
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/chain.pem # 2.4.8+ 可并入 SSLCertificateFile
SSLProtocol -all +TLSv1.2 +TLSv1.3 # 必须 -all,否则继承 all -SSLv3
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
SSLHonorCipherOrder off # 默认 off
SSLSessionCache "shmcb:/run/httpd/ssl_scache(512000)" # 512 KB ≈ 2000 会话
SSLSessionCacheTimeout 86400 # 默认 300 秒
SSLUseStapling on # 默认 off,需配合全局 SSLStaplingCache
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
# 以下必须在全局配置(非 VirtualHost 内)
SSLStaplingCache "shmcb:logs/stapling-cache(150000)"
Apache 2.4.62 默认 SSLSessionCache 为 none,而 SSLStaplingCache 若写在 VirtualHost 里会报 AH01980: SSLStaplingCache 只能在 server config 中使用,这是最常见的启动失败原因。校验用 apachectl configtest,重载用 systemctl reload httpd。
Tomcat 10.1 的 SSLHostConfig 怎么写?
<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol" SSLEnabled="true">
<SSLHostConfig protocols="TLSv1.2,TLSv1.3"
ciphers="TLS_AES_128_GCM_SHA256,TLS_AES_256_GCM_SHA384,ECDHE-RSA-AES128-GCM-SHA256"
sslProtocol="TLS">
<Certificate certificateFile="/opt/tomcat/ssl/example.com.crt"
certificateKeyFile="/opt/tomcat/ssl/example.com.key"
certificateChainFile="/opt/tomcat/ssl/chain.pem"/>
</SSLHostConfig>
</Connector>
Tomcat 8.5 起旧的 sslProtocol/keystoreFile 直接挂在 Connector 上的属性已不推荐,改用 SSLHostConfig 嵌套;protocols 与 ciphers 都用英文逗号分隔,写成分号会静默忽略。
三个平台的参数名怎么一一对应?
| 功能 | Nginx 1.26 | Apache 2.4.62 | Tomcat 10.1 |
|---|---|---|---|
| 协议版本 | ssl_protocols |
SSLProtocol(-all +x) |
protocols(逗号) |
| 套件(TLS1.2) | ssl_ciphers |
SSLCipherSuite |
ciphers |
| 套件(TLS1.3) | ssl_conf_command Ciphersuites |
SSLCipherSuite 自动追加 |
同上 ciphers |
| 会话缓存 | ssl_session_cache(10m) |
SSLSessionCache(字节) |
sessionCacheSize(条数) |
| OCSP 装订 | ssl_stapling |
SSLUseStapling |
JSSE 需自备,无内建开关 |
注意会话缓存的单位陷阱:Nginx 写 10m 是共享内存大小,Apache 写 512000 是字节,而 Tomcat 的 sessionCacheSize 是条数(默认 0 表示不限)。这三者混抄会导致缓存实际失效,用 openssl s_client -reconnect -connect example.com:443 </dev/null | grep "Reused" 可验证是否命中。
参数怎么选:TLS 档位、会话缓存与证书类型的对比表
同一张证书,档位选错,兼容性与安全性会同时受损。这也是大多数 ssl证书 安装教程配置示例 里最容易抄错的一段:直接照搬别人的 ssl_ciphers,结果 IE11 或 Android 5 直接握手失败,浏览器只丢一个 ERR_SSL_VERSION_OR_CIPHER_MISMATCH。先定档位,再谈缓存。
| 档位 | 协议 | 套件与曲线 | 可覆盖客户端 | 适用场景 |
|---|---|---|---|---|
| Modern | 仅 TLSv1.2 + TLSv1.3 | 只留 AEAD(AES-GCM、ChaCha20-Poly1305),曲线限 X25519 / P-256 | Chrome 70+、Firefox 63+、Android 8+ | 新业务、API 网关 |
| Intermediate | TLSv1.2 + TLSv1.3 | 保留 RSA 密钥交换(ECDHE-RSA-AES128-GCM-SHA256) |
绝大多数客户端,含 Win7 + Chrome 49 | Mozilla SSL Configuration Generator 5.7 的默认推荐 |
| Old | 放开 TLSv1 | 兼容 CBC 与 3DES | 老 POS、工控 PLC | 仅对接专用设备,单独子域 + 独立 server 块隔离 |
Modern 能把套件表压到十几行,是因为 RFC 8446 规定 TLS 1.3 只保留 AEAD 套件、密钥交换统一走 supported_groups 扩展,不再需要单独写 ssl_ciphers 区分 RSA/ECDHE。Intermediate 多留的那一组 RSA 套件,正是为了照顾还没支持 TLS 1.3 的老客户端。
会话缓存的坑在于单位不统一,三个组件直接照抄数值必然出事。
| 组件 | 参数 | 单位 | 默认值 | 线上建议 |
|---|---|---|---|---|
| Nginx | ssl_session_cache shared:SSL:10m |
共享内存大小,1MB ≈ 4000 会话 | none(ssl_session_timeout 默认 5m) |
10m ≈ 4 万会话,timeout 1d |
| Apache | SSLSessionCache shmcb:...(512000) |
字节 | 无缓存(SSLSessionCacheTimeout 默认 300 秒) |
512000 ≈ 500KB,timeout 86400 |
| Tomcat | sessionCacheSize |
会话条数 | 20480(sessionTimeout 默认 86400 秒) |
按并发连接数调,非字节 |
# Nginx 1.26(/etc/nginx/conf.d/ssl.conf,http 或 server 块)
ssl_session_cache shared:SSL:10m; # 10MB 共享内存,约 4 万条会话
ssl_session_timeout 1d; # 默认 5m,放到 1d 可显著降低全握手比例
ssl_session_tickets off; # 关票证,避免 ticket key 轮换前的会话被复用
# Apache 2.4(httpd-ssl.conf)
SSLSessionCache shmcb:/var/run/ssl_scache(512000) # 单位是字节,≈500KB
SSLSessionCacheTimeout 86400 # 单位是秒,默认 300
OCSP Stapling 的开关数量差异很大:Nginx 是”四件套”,缺 resolver 会导致装订静默失效,用 openssl s_client -connect example.com:443 -status 检查,输出里没有 OCSP Response Status: successful 就是没生效。
# Nginx:四件套缺一不可
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/fullchain.pem; # 必须含根证书与中间链
resolver 223.5.5.5 1.1.1.1 valid=300s; # 无 resolver 则装订不工作
resolver_timeout 5s;
# Apache 2.4:SSLUseStapling on + SSLStaplingCache,链由 SSLCertificateFile 承载
SSLUseStapling on
SSLStaplingCache "shmcb:logs/ssl_stapling(32768)"
SSLCertificateFile /etc/httpd/ssl/fullchain.pem # 2.4.8 起链文件并入此处
# SSLCertificateChainFile 已废弃(仍可用,但会告警)
Tomcat 原生不支持 OCSP 装订,只能靠前置 Nginx 或云负载均衡完成——这也是为什么很多 Java 站点在 SSL 检测工具里 Stapling 一栏总是失败。
| 证书类型 | 2025 年国内参考价 | 签发时长 | 配置层面的差异 |
|---|---|---|---|
| DV 单域名(Let’s Encrypt) | 0 元 / 90 天 | 分钟级(ACME 自动) | 仅链文件与有效期不同,写法一致 |
| 商业 DV 单域名 | 约 50–300 元/年 | 分钟级 | 同上 |
| DV 通配符 | 约 300–1500 元/年 | 分钟级(须 DNS-01 验证) | 同上 |
| OV 单域名 | 约 600–2000 元/年 | 1–3 个工作日 | 同上 |
| EV | 约 1500–6000 元/年 | 3–7 个工作日 | 同上(浏览器已不显示绿色地址栏) |
据 Let’s Encrypt 文档,其证书固定 90 天有效期、依赖 ACME 协议(RFC 8555)自动续期,所以这份 ssl证书 安装教程配置示例 里真正的运维成本不在首次部署,而在续期钩子:Nginx 用 --deploy-hook "systemctl reload nginx",Apache 用 apachectl -k graceful。
HSTS 别一步到位。max-age 首周用 300,稳定一周后升到 86400,一个月后再上 31536000;includeSubDomains 必须确认所有子域(含内网面板、老 API)都已启用 HTTPS 再加;preload 一旦提交进浏览器预置列表(RFC 6797 定义的机制),回退周期以月计。
# Nginx ≥ 1.25.1:http2 改为独立指令,旧的 listen 443 ssl http2 已 deprecated
listen 443 ssl;
http2 on;
add_header Strict-Transport-Security "max-age=300" always; # 先短后长
# HTTP/3 需 Nginx ≥ 1.25.0 且编译 --with-http_v3_module
listen 443 quic reuseport;
add_header Alt-Svc 'h3=":443"; ma=86400';
ssl_early_data on; # 0-RTT,仅对幂等请求开启,注意重放风险
常见错误与排查:这 6 条真实报错分别对应哪个参数
1. nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/example.com.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)——这条报错指向 ssl_certificate 与 ssl_certificate_key 不配对。最常见的情况是续期后只替换了 .crt、没替换 .key,或者把 A 域名的证书配了 B 域名的私钥。不要靠肉眼判断,直接比对公钥哈希(据 OpenSSL 文档,RSA 证书也可用 -modulus 方式):
# 两条命令输出的 SHA256 必须完全一致,不一致就是文件拿错了
openssl x509 -in /etc/nginx/ssl/example.com.crt -noout -pubkey | openssl sha256
openssl pkey -in /etc/nginx/ssl/example.com.key -pubout | openssl sha256
# OpenSSL 1.0.2 等旧版本可用 RSA modulus 方式
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
2. nginx: [warn] "ssl_stapling" ignored, issuer certificate not found——缺 ssl_trusted_certificate,或者该文件里没有中间证书。关键点:这个参数应指向只含中间证书的 chain.pem,不要指向 fullchain.pem。据 Let’s Encrypt 文档,certbot 生成的 fullchain.pem = 站点证书 + 中间证书,OpenSSL 在构建 stapling 验证链时会因首证书是叶子证书而找不到 issuer。正确写法:ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;,并确保 ssl_stapling on;(默认 off)、ssl_stapling_verify on;(默认 off)同时开启。
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- Wildcard 通配符 SSL 证书安装部署续费申请
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
3. nginx: [emerg] unknown directive "ssl_conf_command"——ssl_conf_command 要求 Nginx ≥ 1.19.4 且链接 OpenSSL ≥ 1.1.1。先确认版本再决定改配置还是升级:
# 一行同时看到 Nginx 版本与编译链接的 OpenSSL 版本
nginx -V 2>&1 | grep -E "nginx version|built with OpenSSL"
若显示 built with OpenSSL 1.0.2k,即使 Nginx 版本够也无法使用该指令——需重新编译或换发行版包(Debian 12 / Ubuntu 22.04 自带 1.1.1 或 3.x)。临时方案:删掉该行,只用 ssl_ciphers 约束 TLS 1.2,TLS 1.3 套件走 OpenSSL 默认值。
4. SSL_CTX_set_cipher_list("...") failed (SSL: error:0A0000B1:SSL routines::no cipher match)——ssl_ciphers 里写了 TLS 1.3 套件名(如 TLS_AES_128_GCM_SHA256)或拼写错误。TLS 1.3 的套件不能出现在 ssl_ciphers 中,OpenSSL 3.x 会直接拒绝整串并导致 nginx 启动失败。ssl_ciphers 的默认值是 HIGH:!aNULL:!MD5,它只作用于 TLS 1.2 及以下:
# TLS 1.2 套件 -> ssl_ciphers;TLS 1.3 套件 -> ssl_conf_command Ciphersuites
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305;
ssl_conf_command Ciphersuites TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256;
# 上面三个正是 OpenSSL 1.1.1+ 的 TLS 1.3 默认套件,不写也是这三项
5. curl: (60) SSL certificate problem: unable to get local issuer certificate——服务端下发的证书链不完整,客户端无法构建到根证书的路径。先数服务端到底发了几个证书:
# 期望输出 2 或 3;只输出 1 说明漏发中间证书
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| grep -c "BEGIN CERTIFICATE"
Nginx 侧应把 ssl_certificate 指向 fullchain.pem;Apache 2.4.8+ 推荐把中间证书直接拼进 SSLCertificateFile,而不是依赖已废弃的 SSLCertificateChainFile。
6. Apache: AH02217: ssl_stapling_init_cert: can't retrieve issuer certificate!——与第 2 条同源:SSLCertificateFile 中未附带中间证书,或 SSLCertificateChainFile 路径错误。同族问题还有 Tomcat 的 java.security.cert.CertificateException: No name matching example.com found(certificateFile 里放成了 chain,或 CN/SAN 不匹配),以及 Java 客户端 javax.net.ssl.SSLHandshakeException: The server selected protocol version TLS10 is not accepted by client preferences——JDK 8u291 起 java.security 的 jdk.tls.disabledAlgorithms 默认已禁用 TLSv1/TLSv1.1,服务端必须把 ssl_protocols 收紧(Nginx 1.23.0 起默认值已改为 TLSv1.2 TLSv1.3,旧版本默认仍含 TLSv1)。
| 报错关键词 | 罪魁参数 | 修复动作 |
|---|---|---|
| key values mismatch | ssl_certificate_key / SSLCertificateKeyFile |
比对公钥 SHA256,换回配对文件 |
| issuer certificate not found | ssl_trusted_certificate |
改指 chain.pem(仅中间证书) |
| unknown directive “ssl_conf_command” | Nginx / OpenSSL 版本 | Nginx ≥ 1.19.4 且 OpenSSL ≥ 1.1.1 |
| no cipher match | ssl_ciphers |
TLS 1.3 套件移到 ssl_conf_command Ciphersuites |
| unable to get local issuer certificate | ssl_certificate / SSLCertificateFile |
改为 fullchain,或拼接中间证书 |
| AH02217 / TLS10 not accepted | SSLCertificateChainFile / ssl_protocols |
补链 + 关闭 TLSv1/1.1 |
怎么确认配置真的生效:5 道验收从命令行到扫描器
改完 ssl_protocols 或 SSLProtocol 之后跑一次 nginx -t 或 apachectl configtest,只能证明语法没写错,不能证明握手真的按你写的在跑。配置被 include 覆盖、SNI 默认 server 命中错误证书、中间证书漏装,这几种问题语法检查一律放行。下面 5 道验收按”握手 → 装订 → HTTP 层 → 全量套件 → 评级”的顺序排,全部可以在同一台跳板机上跑完。默认前提:Nginx 1.26、Apache 2.4.5x、OpenSSL 1.1.1 以上(openssl version 确认;1.0.2 不认 -tls1_3,会直接报 unknown option -tls1_3,需换 openssl11 或 3.x)。
第一道:协议与套件到底协商成了什么?
-servername 必须带上,否则 SNI 虚拟主机可能返回默认站点的证书,测出来的不是你配的那个 server 块。
# 强制只走 TLS 1.3,看实际协商结果
openssl s_client -connect example.com:443 -servername example.com -tls1_3 /dev/null
| grep -E "Protocol|Cipher"
# 期望:Protocol: TLSv1.3
# Cipher : TLS_AES_256_GCM_SHA384 或 TLS_CHACHA20_POLY1305_SHA256
# 复测 TLS 1.2 是否仍然保留(老客户端兼容性),把 -tls1_3 换成 -tls1_2
openssl s_client -connect example.com:443 -servername example.com -tls1_2 /dev/null
| grep -E "Protocol|Cipher"
# 期望:Protocol: TLSv1.2,Cipher 为 ECDHE-*GCM 或 CHACHA20,不应出现 CBC/3DES
如果 TLS 1.3 那行报 no protocols available,多半是 Nginx 里 ssl_protocols 没写 TLSv1.3,或者用 listen 443 ssl 之外还残留了旧配置块覆盖。版本要点:Nginx 自 1.23.4 起把 ssl_protocols 的默认值从 TLSv1 TLSv1.1 TLSv1.2 改为 TLSv1.2 TLSv1.3,1.26 上不显式写也是安全的;Apache 2.4 的 SSLProtocol 默认是 all -SSLv3,仍可能放开 TLSv1.0/1.1,必须显式写 SSLProtocol -all +TLSv1.2 +TLSv1.3。
第二道:OCSP Stapling 真的装订上了吗?
openssl s_client -connect example.com:443 -servername example.com -status /dev/null
| grep -A3 "OCSP Response Status"
# 期望:OCSP Response Status: successful (0x0)
# 失败:OCSP Response Status: no response sent → 服务器没装订,回到配置检查
出现 no response sent 时按这个顺序查:① Nginx 侧需要 ssl_stapling on; + ssl_stapling_verify on;,且 ssl_trusted_certificate 必须指向含中间证书的 fullchain(指向叶子证书会静默失败);② resolver 必须可用且不能写在 location 里,例如 resolver 223.5.5.5 1.1.1.1 valid=300s;;③ Apache 侧需要 SSLUseStapling on 配合全局的 SSLStaplingCache "shmcb:logs/ssl_stapling(32768)",缺 cache 会报 AH01957: stapling cache not configured。另外要注意:据 Let’s Encrypt 2025 年公告,其已停止在证书中写入 OCSP URL 并关停 OCSP 响应器、转向 CRL,因此对 Let’s Encrypt 新证书来说 no response sent 将属于预期行为,验收时应以证书签发方为准判断。
第三道:HTTP 层的头和证书链验证
# HSTS 是否存在、max-age 是否够
curl -sI https://example.com | grep -iE "strict-transport|alt-svc"
# 期望:strict-transport-security: max-age=31536000; includeSubDomains
# 证书链验证 + 握手耗时(含 OCSP 抓取)
curl -o /dev/null -s -w '%{http_code} %{ssl_verify_result} %{time_appconnect}n' https://example.com
# 期望:200 0 0.08x ;ssl_verify_result 非 0 即链有问题(60 = 证书不受信任)
ssl_verify_result 是最省事的链完整性判据,比肉眼数证书可靠。想要 SSL Labs 的 A+,HSTS 的 max-age 至少要 15768000 秒(6 个月),只写 max-age=300 只能拿 A。
第四道:全量套件扫描,确认没有 CBC / RC4 残留
# nmap 7.94 起 ssl-enum-ciphers 支持 TLS 1.3;输出中不应出现 TLSv1.0 / TLSv1.1 段落
nmap --script ssl-enum-ciphers -p 443 example.com
# testssl.sh 3.2:只报 HIGH 及以上风险,静默模式便于脚本化
./testssl.sh --severity HIGH --quiet https://example.com
# 重点看输出里是否还有 CBC、RC4、3DES、EXPORT 字样
第五道:评级与到期时间,接进监控
# 取到期时间,喂给监控;阈值建议设在剩余 21 天(Let's Encrypt 有效期 90 天)
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -enddate -issuer
# 输出示例:notAfter=Jun 12 03:14:07 2026 GMT
同时用 SSL Labs 扫描,目标是 A 或 A+。若 DevTools 的 Security 面板显示 This page is not secure,点开证书看「证书路径」是否有红叉——多数情况是中间证书缺失,而不是套件配错。
| 检查项 | 核心命令 | 通过标准 | 失败首查 |
|---|---|---|---|
| 协议/套件 | s_client -tls1_3 / -tls1_2 |
TLSv1.3 + AEAD 套件,1.2 仍可用 | ssl_protocols 是否被覆盖 |
| OCSP 装订 | s_client -status |
successful (0x0) |
resolver、ssl_trusted_certificate |
| HTTP 层 | curl -I / -w '%{ssl_verify_result}' |
HSTS 存在,结果为 0 | 中间证书缺失、头未下发 |
| 全量套件 | nmap ssl-enum-ciphers、testssl.sh |
无 TLSv1.0/1.1、无 CBC/RC4 | ssl_ciphers 顺序与排除项 |
| 评级/到期 | SSL Labs、x509 -enddate |
A/A+,剩余 > 21 天 | HSTS max-age、续期自动化 |
不同场景下的配置取舍:TLS 卸载、多站点 SNI、内网 mTLS 与 HTTP/3
边缘终止还是直连?TLS 卸载后为什么页面里的链接全变成了 http?
当 TLS 在 CDN 或四层/七层负载均衡上终止时,证书、ssl_protocols、ssl_ciphers、HSTS 全部由边缘节点负责,后端 Nginx 只需监听 80 端口或使用自签/内部 ACME 证书(如 step-ca、Vault PKI)走 TLS 1.2 回源。最容易踩的坑是忘记透传 X-Forwarded-Proto:Django、Laravel、Spring 等框架据 request.scheme 生成绝对 URL,一旦缺失就输出 http:// 链接,浏览器在 HTTPS 页面加载 http 资源即触发混合内容告警。据 RFC 7239 与 Mozilla 的代理部署建议,回源侧应显式声明信任边界:
# 后端 Nginx:仅在来自可信边缘网段时采信转发头
set_real_ip_from 10.0.0.0/8;
real_ip_header X-Forwarded-For;
# 关键行:让 $scheme 与应用看到 https,避免跳转回 http
map $http_x_forwarded_proto $forwarded_scheme {
default $scheme;
https https;
}
proxy_set_header X-Forwarded-Proto $forwarded_scheme;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $host;
| 部署形态 | 证书位置 | 谁管 ssl_protocols/HSTS | 回源方式 | 主要风险 |
|---|---|---|---|---|
| CDN 卸载 | CDN 边缘 | CDN 控制台 | TLS 1.2 + 内部证书 | 未透传 X-Forwarded-Proto |
| SLB/LB 卸载 | 负载均衡器 | LB 监听器配置 | 明文 80 或 TLS 1.2 | 内网明文被旁路嗅探 |
| Nginx 直连 | Nginx 本机 | Nginx 配置 | — | 需自行做 OCSP Stapling |
多域名 SNI:怎样让未知域名和不带 SNI 的扫描器直接吃闭门羹?
Nginx 默认把第一个 listen 443 ssl 的 server 块当作默认站点,导致 IP 直连或未知 Host 访问时返回该站证书,扫描器随即报告”证书与域名不符”。Nginx ≥ 1.19.4 提供 ssl_reject_handshake(默认 off),在握手阶段直接发 unrecognized_name 告警并断开:
server {
listen 443 ssl default_server;
server_name _;
ssl_reject_handshake on; # 1.19.4+,默认 off
# 无需配置证书,握手即被拒绝
}
内网 mTLS:客户端证书校验失败,日志里为什么是 495?
Nginx 的 access_log 会把证书校验失败记为 495、客户端未提供证书记为 496,而客户端实际收到的是 HTTP 400 Bad Request(可用 error_page 495 496 = @deny; 自定义响应体)。ssl_verify_depth 默认值为 1,内部 CA 常签发”根 CA → 中间 CA → 终端证书”两级链,必须调到 2 或更高;同时只有配置 ssl_trusted_certificate 才能对客户端证书链做 OCSP 装订(Stapling):
ssl_client_certificate /etc/nginx/ssl/ca.crt; # 用于校验的完整链
ssl_trusted_certificate /etc/nginx/ssl/ca.crt; # 用于 OCSP stapling
ssl_verify_client on; # off | on | optional | optional_no_ca
ssl_verify_depth 2; # 默认 1,内部两级 CA 必须 ≥2
ssl_crl /etc/nginx/ssl/ca.crl; # 吊销列表,建议配合定时更新
还有 Windows 7 老客户端怎么办?HTTP/3 和证书轮换要注意什么?
不要为兼容 Windows 7 SP1(未打 KB3140245 时无 TLS 1.3)或 Android 5 而全局放开 TLSv1——那会让 Mozilla Intermediate 档位直接失效。做法是单开 legacy.example.com、单独证书、单独 server 块,只保留 ssl_protocols TLSv1.2; 并接受评级下降,主站维持 Intermediate。HTTP/3 需 Nginx 1.25.0+(含 --with-http_v3_module,1.26 仍标 experimental),listen 443 quic reuseport 必须与 listen 443 ssl 并存;ssl_early_data on 开启 0-RTT 存在重放风险,按 RFC 9114 建议仅对幂等 GET 放行,POST 接口应在应用层检查 Early-Data: 1 头并返回 425 Too Early。
证书轮换最常见的故障是”换了证书还是旧的”——只覆盖文件却没 reload。把流程固化为脚本,参考 Let’s Encrypt 与 Mozilla SSL Configuration Generator 的实践:
#!/bin/bash
set -e
nginx -t && nginx -s reload # 先校验再热加载
sleep 1
# 取回线上证书,比对指纹与到期时间
openssl s_client -connect example.com:443 -servername example.com </dev/null
| openssl x509 -noout -subject -dates -fingerprint -sha256
# 与本地新证书指纹比对,一致才算轮换成功
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -fingerprint -sha256
这套 ssl证书 安装教程配置示例 的取舍逻辑是:边缘节点管协议与 HSTS,后端管信任边界与透传头;每个例外(legacy 子域、mTLS 内网、HTTP/3)都应有独立 server 块和独立证书,避免例外配置污染主站安全基线。
因为 Windows 的 CryptoAPI 与 curl、Java 一样,要求服务端下发完整链才能构建到受信任根;安卓部分版本会走自己的信任库并尝试用 AIA 字段去下载中间证书,所以看起来正常。把站点证书与中间证书按顺序拼成 fullchain.pem 写进 ssl_certificate,再用 awk 统计 BEGIN CERTIFICATE 出现次数确认是 2 或 3 即可。
不能。协议开关的语义不同:Nginx 的 ssl_protocols TLSv1.2 TLSv1.3 是白名单,Apache 的 SSLProtocol 需要先 -all 再 +TLSv1.2 +TLSv1.3;会话缓存单位也不同,Nginx 的 shared:SSL:10m 是 10 MB,Apache 的 shmcb 括号里是字节数,Tomcat 的 sessionCacheSize 是会话条数。抄错单位不会报错,但会导致会话复用率异常。
ssl_ciphers 只作用于 TLS 1.2 及以下,TLS 1.3 的套件由 OpenSSL 的 Ciphersuites 选项控制。Nginx 需 ≥ 1.19.4 用 ssl_conf_command Ciphersuites TLS_AES_128_GCM_SHA256:…;Apache 2.4.62 用 SSLOpenSSLConfCmd Ciphersuites。若把 TLS 1.3 套件写进 ssl_ciphers,OpenSSL 3.x 反而会整串拒绝并报 no cipher match。
配置写法完全一致,都是 fullchain + key 两个文件。差异在三点:Let's Encrypt 有效期 90 天、链默认走 ISRG Root X1(交叉签名到期后需注意老设备信任)、无组织信息校验;OV 证书有效期通常 1 年、签发需 1–3 个工作日、需提交营业执照,价格约 600–2000 元/年。选型看是否需要组织身份展示与更长的续期周期。
先确认 nginx -t 通过且 reload 命令返回 0,再用 ps -o lstart -p $(cat /run/nginx.pid) 看 master 进程启动时间是否变化;如果配置里 ssl_certificate 指向的是软链接(如 /etc/letsencrypt/live/xxx/fullchain.pem),要确认软链接目标已更新。另外检查是否有多个 server 块或 include 的文件里重复定义了 ssl_certificate,后加载的会覆盖前面的。
这条警告表示 Nginx 找不到签发者证书来验证 OCSP 响应。补上 ssl_trusted_certificate /etc/nginx/ssl/chain.pem(只放中间证书,不要放 fullchain),再配 resolver 223.5.5.5 119.29.29.29 valid=300s,reload 后用 openssl s_client -status 复查是否出现 OCSP Response Status: successful。
不是必须,但开了可以消除首次 HTTP 明文请求被劫持的窗口。建议先用 max-age=300 试运行一周,确认全站与所有子域都能走 HTTPS 后再升到 31536000;注意 HSTS 一旦下发,浏览器在 max-age 到期前会强制走 HTTPS,回退只能等缓存过期,所以不要一上来就写一年并提交 preload。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。