01 / CODE & SYSTEM
Nginx 的 TLS 与 HTTP/2:那些容易忽略的小参数
证书配好不等于配对。OCSP、会话复用、HTTP/2 的坑,以及为什么你的 443 块总是用错证书。
给一个站配 HTTPS,十分钟能搞定;配到「没有任何警告、握手足够快、换域名不出错」,就得抠细节了。这篇记录我踩过的几个点。
每个 443 块都要有证书
这是最隐蔽的坑。当你有多个 server 块:裸域 301、www 主站、移动端,只要其中任何一个 listen 443 的块没写 ssl_certificate,nginx 会回退到默认站的证书。表现是:路由完全正常,但浏览器报「证书域名不匹配」。
server {
listen 443 ssl;
http2 on;
server_name example.com;
ssl_certificate /path/fullchain.pem;
ssl_certificate_key /path/privkey.pem;
return 301 https://www.example.com$request_uri;
}
301 要放行 ACME 验证
裸域整块 301 到 www,会让 /.well-known/acme-challenge/ 的验证请求也被跳走,证书续期就失败了。必须单独放行:
location ^~ /.well-known/acme-challenge/ {
root /www/wwwroot/example.com;
try_files $uri =404;
}
^~ 前缀匹配优先级高于普通正则,这是它能生效的关键。
HTTP/2 的正确写法
nginx 1.25 之后推荐 http2 on;,不再写在 listen 后面。老写法还能用,但会有警告。另外 HTTP/2 下不要再开 keepalive_timeout 过长,连接复用交给协议本身。
会话复用能省一次往返
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets on;
10m 大约能放 4 万个会话。对中小站足够,别开太大,内存是共享的。
别在 PHP 里重复加安全头
如果 nginx 已经统一 add_header,PHP 里再 header() 一次,响应里会出现两遍同名头。多数浏览器能容忍,但某些扫描器会判为配置错误。安全头只在一个地方加。
验证方法
配完不要只看浏览器绿锁。用 curl -I 看响应头,用 openssl s_client 看证书链,再换一个没缓存的浏览器配置访问一次:
curl -sI https://www.example.com | grep -iE 'strict|content-security|x-frame'
openssl s_client -connect www.example.com:443 -servername www.example.com </dev/null 2>/dev/null | openssl x509 -noout -dates -subject
HTTPS 不是装饰品,它是你和访客之间唯一一条不被中间人改写内容的通道。值得多花二十分钟。
— 完 —