Nginx 工程实践 -- 7. HTTPS 与证书
把 TLS 终止在 Nginx,是现在绝大多数部署的默认形态:浏览器与 Nginx 之间走 HTTPS,Nginx 与后端之间走内网 HTTP。这样证书只需要在一处签发和续期,后端服务不必各自实现 TLS,协议策略、HSTS、OCSP 也能统一收口。
1 | |
flowchart TD
C["浏览器"] -->|"TLS 握手
SNI + ALPN"| N["Nginx
TLS 终止"]
N -->|"校验"| V["证书链
主证书 → 中间证书 → 根"]
N -->|"HTTP 内网"| B["后端服务"]
一、证书文件的准备
Nginx 的 ssl_certificate 接受 PEM 格式文件,如果证书链不只有一张证书,需要把多张证书按顺序拼在同一个文件里:主证书在前,中间证书(CA)依次在后。顺序反了会导致握手时链校验失败。
1 | |
私钥文件权限建议收紧(chmod 600),并确保 Nginx worker 用户可读。
二、最小可用配置
1 | |
几个要点:
listen 443 ssl;是新版写法;旧版ssl on;指令已废弃,不要再写;- 跳转用
return 301,不要用rewrite ^(.*)$ https://...,前者不重新匹配 location; $host取的是Host头/请求行的主机名(不含端口),比$server_name更适合多域名;- 想让 HTTP 也响应 ACME 校验,就把
/.well-known/acme-challenge/单独放行,其余再 301。
三、协议与加密套件
1 | |
ssl_protocols:按需保留TLSv1.2与TLSv1.3;TLS 1.0/1.1 已被主流浏览器弃用,不必再开;ssl_ciphers:默认值是HIGH:!aNULL:!MD5,一般沿用即可;如需收紧,参考 Mozilla 的推荐套件列表;ssl_prefer_server_ciphers on:由服务端决定套件优先级,通常建议开启;ssl_ecdh_curve auto:让 OpenSSL 自动选择椭圆曲线;若使用 ECDSA 证书,要确保证书所用曲线在支持列表里。
四、会话复用:减少握手成本
完整 TLS 握手有额外往返,开启会话复用可以让老客户端"跳过"完整握手:
1 | |
shared:SSL:10m 是所有 worker 共享的内存区(名称 SSL 可自取),10m 大约能存 4 万个会话。ssl_session_tickets 默认是开的,如果你更看重前向保密,可以关掉,只用共享 cache。
五、OCSP Stapling
客户端每次握手都要自己去 CA 的 OCSP 服务器查询证书状态,既慢又泄露访问行为。开启 stapling 后,由 Nginx 定期代查并把结果随握手发给客户端:
1 | |
resolver必须配,否则 Nginx 无法解析 OCSP 响应器域名;ssl_trusted_certificate指向包含中间证书的文件(fullchain.pem即可),用于校验 OCSP 响应签名;- 验证:
openssl s_client -connect example.com:443 -servername example.com -status,看到OCSP Response Status: successful即生效。
六、HSTS:让浏览器强制 HTTPS
1 | |
max-age是秒;建议先小值灰度(如 300),观察一段时间再放大;includeSubDomains会对所有子域生效,前提是所有子域都能提供有效 HTTPS,否则子域会不可访问;preload表示申请进入浏览器的内置 HSTS 列表,提交后基本不可逆(需数周甚至数月才能从列表移除),确认长期承诺再开;add_header记得带always,否则错误响应上不会带这个头。
七、0-RTT:更快,但要想清楚
TLS 1.3 的 early data 允许客户端在第一个往返就带上请求数据,Nginx 用 ssl_early_data 开关:
1 | |
风险:0-RTT 数据可能被重放。官方文档明确要求应用层用 $ssl_early_data 判断,只对幂等请求(GET 且无副作用)放行,写操作(POST/PUT/DELETE)应拒绝或要求完整握手。没有这层防护时不要开。
八、证书自动续期
以 certbot 为例,续期成功后触发一次 reload,而不是 restart:
1 | |
nginx -s reload会先做语法检查,再平滑替换 worker,不会断开已有连接;- 续期脚本要保证
ssl_certificate指向的文件路径不变(软链或--deploy-hook里拷贝),reload 才能读到新证书; - 用
acme.sh时同理,把--reloadcmd设成nginx -s reload。
九、排错速查
| 现象 / 日志 | 可能原因 |
|---|---|
SSL_do_handshake() failed | 证书链顺序错误、私钥与证书不匹配、时间不同步 |
| 浏览器提示"证书不受信任" | 缺中间证书;ssl_certificate 里只放了主证书 |
| 握手偶发失败 | 没配 ssl_session_cache / ssl_session_timeout 过短 |
| OCSP 查询失败 | 没配 resolver,或 ssl_trusted_certificate 指向了只有主证书的文件 |
| 子域全部打不开 | HSTS 带了 includeSubDomains,但子域没有 HTTPS |
| 想回退 HTTP 却跳不回去 | HSTS 缓存 + 已提交 preload |
| 0-RTT 请求被重复处理 | 后端没检查 $ssl_early_data,把写请求也放行了 |
常用验证命令:
1 | |
参考链接
- Nginx 官方文档:ngx_http_ssl_module ——
ssl_certificate/ssl_protocols/ssl_stapling/ssl_early_data等全部指令; - Nginx 官方文档:Configuring HTTPS servers —— 证书链顺序、SNI、HTTPS 服务器整体配置建议;
- RFC 6797:HTTP Strict Transport Security (HSTS) —— HSTS 的规范定义与 preload 语义;
- RFC 8446 §2.3:TLS 1.3 Early Data、RFC 8470:Using Early Data in HTTP —— 0-RTT 与重放攻击;
- certbot 官方文档 —— 证书签发与自动续期;
- MDN:Strict-Transport-Security。
小结
- 证书文件按「主证书在前、中间证书在后」的顺序拼成一个 PEM,私钥单独放并收紧权限;
listen 443 ssl;+ssl_certificate[_key]是最小可用集;HTTP 用独立 serverreturn 301跳转;- 协议只留
TLSv1.2/TLSv1.3,套件沿用默认或按 Mozilla 推荐收紧; - 会话复用、OCSP Stapling、HSTS 是性能与安全的三个增量,按需逐个打开;
- 0-RTT 只在后端能识别并拒绝非幂等请求时开启;
- 续期后
nginx -s reload,不要 restart。
系列导航
Nginx 工程实践 -- 7. HTTPS 与证书
https://bubao.github.io/posts/d6e4f5a7.html
