龙龙的博客

FRED'S BLOG 写于西安 · 在线第 7,387 天 · 2026 · 11 月

公告

现在只要不停地奔跑,只要目标远大—— Fred‘s BloG

01 / CODE & SYSTEM

Nginx 的 TLS 与 HTTP/2:那些容易忽略的小参数

证书配好不等于配对。OCSP、会话复用、HTTP/2 的坑,以及为什么你的 443 块总是用错证书。

·约 4 分钟 ·龙龙 NginxHTTPS运维

给一个站配 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 不是装饰品,它是你和访客之间唯一一条不被中间人改写内容的通道。值得多花二十分钟。

— 完 —

作者 / AUTHOR

龙龙 / Fred · 写代码的人,弹吉他的人,打了二十年 CS 的人。住在西安,这个站从 2006 年写到现在。更多 →