Nginx 缓存调优:从 100% MISS 到 90% HIT

作者:姜鱼问生日期:2026/10/15

背景
监控大屏用 Nginx 反代两个 Flask 实例,开了 proxy_cache 想减轻后端压力。

配置看起来没问题,响应头也有 X-Cache-Status。但连续 curl 十次,结果全是:

110 MISS
2

缓存目录里只有 1 个文件,基本等于没生效。

想做到:让缓存真正命中。
原因
第一步:看响应头

1$ curl -k -s -D - -o /dev/null https://example.com:8443/ | grep -i cache
2cache-control: no-cache
3x-cache-status: MISS
4

第二步:直连后端看原始响应

1$ curl -s -D - -o /dev/null http://127.0.0.1:5001/
2HTTP/1.1 200 OK
3Cache-Control: no-cache
4

根因:后端返回了 Cache-Control: no-cache。

Nginx 默认尊重上游的 Cache-Control——上游说别缓存,Nginx 就真不缓存。

就像你在货架上贴了「欢迎放商品」,但供应商送货时贴了张纸条「此商品不得上架」。店员只能照办,货架空着。
解决
一、让 Nginx 忽略上游的 Cache-Control

1location / {
2    proxy_cache my_cache;
3
4    # 关键:忽略上游的 Cache-Control 和 Expires
5    proxy_ignore_headers Cache-Control Expires;
6
7    proxy_cache_valid 200 302 5m;
8    proxy_cache_valid 404 1m;
9
10    add_header X-Cache-Status $upstream_cache_status always;
11    proxy_pass http://backend_cluster;
12}
13

只忽略这两个,别一股脑全忽略:

响应头是否忽略原因
Cache-Control✅ 忽略上游默认带 no-cache,会阻止缓存
Expires✅ 忽略和 Cache-Control 配套
Set-Cookie❌ 不忽略忽略会串号
Vary❌ 不忽略忽略会破坏多版本缓存

二、固定 proxy_cache_key

1proxy_cache_key "$scheme$request_method$host$request_uri";
2

排除 $args 和 cookie 干扰,同一个 URL 共用一份缓存。

副作用:如果页面按 cookie 分版本就不能这么做。我这里是内部大屏,可以接受。
三、加 proxy_cache_lock 防击穿

1proxy_cache_lock on;
2proxy_cache_lock_timeout 5s;
3

货架上的牛奶卖完了,10 个顾客同时冲进仓库。
加锁 = 只让第一个人进,后面的人等在门口。
四、后端抖了用过期缓存顶一下(可选)

1proxy_cache_use_stale updating error timeout http_500 http_502 http_503 http_504;
2proxy_cache_background_update on;
3

完整配置

1location / {
2    proxy_cache my_cache;
3    proxy_cache_key "$scheme$request_method$host$request_uri";
4    proxy_ignore_headers Cache-Control Expires;
5
6    proxy_cache_valid 200 302 5m;
7    proxy_cache_valid 404 1m;
8
9    proxy_cache_lock on;
10    proxy_cache_lock_timeout 5s;
11    proxy_cache_use_stale updating error timeout http_500 http_502 http_503 http_504;
12    proxy_cache_background_update on;
13
14    add_header X-Cache-Status $upstream_cache_status always;
15    proxy_pass http://backend_cluster;
16}
17
1sudo nginx -t && sudo systemctl reload nginx
2

验证效果

1$ for i in {1..10}; do
2    curl -k -s -o /dev/null -D - https://example.com:8443/ \
3    | awk -F': ' 'tolower($1)=="x-cache-status"{print $2}'
4    sleep 0.2
5  done | sort | uniq -c
6      1 MISS
7      9 HIT
8

9 HIT / 1 MISS,命中率 90%。

项目优化前优化后
命中率0%~90%
回源次数(10 次)101
响应时间取决于后端命中时几乎为 0

三个坑
坑 1:以为开了 proxy_cache 就会缓存
上游可以返回这些头让 Nginx 放弃缓存:

响应头含义
Cache-Control: no-cache每次都校验
Cache-Control: no-store完全禁止
Cache-Control: private只允许浏览器缓存
Set-Cookie默认不缓存

坑 2:proxy_cache_key 忘了固定
默认 key 里如果带了 ?timestamp=xxx 或 cookie,每次请求都是新 key,缓存命中率永远上不去。

正确做法:显式写 proxy_cache_key,只留真正影响内容的部分。
坑 3:X-Cache-Status 加了,但日志里看不到
add_header 只是返回给客户端,日志统计要单独配:

1# 在 http 块里定义(必须放 conf.d/,不能放 server)
2log_format cache_tsv '$time_iso8601\t$host\t$request_method\t$request_uri\t$status\t$upstream_cache_status';
3
4# 在 server 块里启用
5server {
6    listen 8081;
7    access_log /var/log/nginx/dashboard_cache.log cache_tsv;
8}
9

注意:\t 是字面反斜杠 + t,Nginx 自己解释成制表符。写 heredoc 时用单引号 <<‘EOF’,否则 shell 会展开。

还有:只有配了 proxy_cache 的那层 Nginx 才有 HIT/MISS,外层反代的 $upstream_cache_status 是 -。

生活小插曲:最近我开始写小说了,名字就不说了,等有一定流量再宣传。


参考文档


《Nginx 缓存调优:从 100% MISS 到 90% HIT》 是转载文章,点击查看原文。


相关推荐


大模型多模态、Harness 与 MCP:一个 Agent 开发者的技术笔记
再吃一根胡萝卜2026/10/7

一、大模型与多模态:底层到底发生了什么 很多人初学大模型时会有一个固有印象:大模型只能处理文字。这个说法在早期(GPT-3 时代)是对的,但现在早已过时。 1. 核心事实 大模型内部处理的从来不是"文字"或"图片",而是向量(高维数字) 。所谓多模态,本质是: 识图:图片 → 视觉编码器 → 向量 → 喂入大模型 画图:文字 prompt → 扩散模型 → 从噪点逐步去噪 → 图片 对大模型来说,它从来没有"看到"过图片,它读的是图片的数学表示。图片和文字在训练时被对齐到同一个向量空间中——


GitHub 热榜项目 - 周榜(2026-09-19)
CoderJia_2026/9/29

GitHub 热榜项目 - 周榜(2026-09-19) 生成于:2026-09-19 统计摘要 共发现热门项目: 21 个 Token赞助:siliconflow 前些天发现了一个巨牛的人工智能学习网站,通俗易懂,风趣幽默,忍不住分享一下给大家。点击跳转到网站。 本期热点趋势总结 本期 GitHub 热榜清晰指向 AI Agent 工程化:代码审查、知识库 RAG、多代理编排、上下文压缩、Worktree 协同成为核心热点,配套涌现技能框架、插件生态与终


CentOS 7 下 Nginx 访问自定义目录报 403 的完整排查:从端口权限到 SELinux
小小的木头人2026/9/22

背景 在 CentOS 7 上用 Nginx 部署一个静态站点,root 指向非标准目录 /data/www,监听自定义端口 12000。过程中连续踩了两个坑: Nginx 启动失败:bind() to 0.0.0.0:12000 failed (13: Permission denied)启动成功后访问页面:"/data/www/index.html" is forbidden (13: Permission denied) 两个错误的共同点都是 13: Permission denied,但


我在 Anthropic ELI5 上加了5样东西,做成了更好用的 ELI5+
深小乐2026/9/14

上篇聊过 Anthropic 都在用的 ELI5 Skill。我用了一阵子,它有它的好,也有绕不过去的问题。 好的地方很明确。整个核心就一句话:给完全不懂的人讲,用 HTML,大图少字。它直接把输出从文字改成画面,一个比喻加几步拆解,概念就立住了,建立直觉特别快。 但用久了,三个问题越来越明显。 1,只有比喻,没有机制。 ELI5 的核心手段就是比喻。比喻天生只讲"像什么",不讲"是什么"。它能让你快速建立直觉,但经不起追问。LLM 比作超级自动补全,你懂了它在"猜下一个词",但解释不了模型为什


zynq中axi_dma的sg模式采集--裸机测试(还有bug)
王明列2026/9/6

参考 嵌入式终端AtShell.csdnzynq中axi_dma的四个实验-第1课:PL搭建.csdnzynq中axi_dma的四个实验-第2课:Vitis裸机测试.csdnzynq中axi_dma的四个实验-第3课:Linux寄存器方案驱动测试.csdnzynq中axi_dma的四个实验-第4课:Linux dmaproxy方案驱动测试.csdnzynq中axi_dma的sg模式采集–PL搭建.csdnzynq中axi_dma的sg模式采集–裸机测试.csdn 约定 PL部分参考


深入理解 Transformer:Transformer 究竟是什么?
渡我白衣2026/8/29

目录 一、先从一张经典结构图开始二、Transformer 不是一个模块,而是一组模块的组合三、什么是 Encoder?四、Encoder Block:Transformer 的基本积木五、第一部分:Multi-Head Self-Attention六、第二部分:为什么 Attention 后面还需要 Add?七、第三部分:Norm 又是什么?八、第四部分:Attention 之后,为什么还需要 FFN?九、现在,我们终于可以看懂 Encoder Block 了十、Encoder 到底输出了什


Go 编程实战:指针 Pointer——理解地址、取址与解引用
程序员爱钓鱼2026/8/21

上一篇我们学习了 Map,到这里已经接触了数组、Slice、Map 等常用数据结构。在继续学习函数之前,还有一个非常重要的基础概念必须掌握——指针 Pointer。 很多刚接触 Go 的开发者看到指针会觉得复杂,其实 Go 的指针相比 C/C++ 简单很多。Go 不支持复杂的指针运算,日常开发主要掌握三个概念即可:变量、内存地址、通过地址访问变量。 理解指针之后,后面学习函数参数、Struct、方法、接口以及并发编程都会更加容易。 一、什么是指针 先看一个普通变量: age := 20 程序


【Linux系统篇】Linux入门基础指令(一)
忧郁兔斯基2026/8/8

在上一篇文章中,我们已经谈过Linux的历史以及如何使用云服务器配置Linux环境和使用Xshell来使用Linux,那么我们在本篇文章中将要开始学习Linux的一些基础指令。 目录 一、关于图形化界面 二、Linux文件以及目录结构 2.1 怎么理解文件 2.2 Linux的文件结构 2.3 Linux的目录结构 2.4 路径 三、简单的指令学习 3.1 pwd 命令 3.2 ls指令 -l 列出文件的详细信息 -a 列出目录下的所有文件 指令选项的组合使用方法 l


500 个服务时快 6 倍:我们如何将 Kibana APM 服务地图从 Canvas 重构到 React DOM
Elasticsearch2026/7/30

作者:来自 Elastic Jenny Pavlova 每个服务节点都会显示告警、 SLO 和异常健康状态,因此你可以仅筛选违反阈值的服务,并将结果嵌入到任何 Kibana 仪表板中,同时支持在整个拓扑中使用完整的键盘导航。 我们基于 React Flow 重构了 Elastic Observability 中的 Kibana APM 服务地图。在拥有 500 个服务时,渲染时间仅为 64ms,相比之前基于 Cytoscape.js 的实现快约 6 倍,同时 JavaScript 体积减少了


京东零售组织新变革:取消两级管理岗,推全栈化开发
AIHR数智引擎2026/7/22

近日,京东零售的组织调整方案流传出来。 很多人第一反应是:大厂又在砍中层。但把方案里的三条细节放在一起看,你会发现这事和"裁员"关系不大,它真正改写的,是"管理者"这三个字的定义。 细节一:C4、C5 两级管理者的"管理者身份"被取消。人还在,但"管人"这顶帽子没了,他们直接挂靠到 C3;以后员工请假、调休,C3 一个人拍板。 细节二:创新零售业务的前端团队并进服务端,全员转做全栈开发。第三季度开始,首批全栈工程师就要直接介入业务。 细节三:C2 序列的团队规模必须大于 50 人,没达标

首页编辑器站点地图

本站内容在 CC BY-SA 4.0 协议下发布

Copyright © 2026 聚合阅读