之前的项目里一直是用 redis 做缓存,也有些场景是用 java 的 Map/List 等数据结构做本地缓存;这次接手浏览器项目,发现他们用到了 nginx 的缓存,所以就研究了一下 nginx 的缓存配置
启动缓存支持以后,nginx 在将请求转发到 jetty 之前会在缓存里查找结果,如果缓存里存在匹配客户端请求的结果,则直接返回给客户端,不会将请求发送给 jetty;如果缓存没有命中,才会将请求发送给 jetty,接收到 jetty 返回的结果后,会将结果进行缓存以备客户端下次的请求。示意图如下
@Controller
public class TestController {
@ResponseBody
@RequestMapping("time.do")
public Map time() {
Map map = new HashMap();
map.put("time", System.currentTimeMillis());
return map;
}
}
这个接口会返回当前时间,精确到毫秒,正常情况下每次刷新返回的值都应该是不一样的
http {
...
# 设置缓存的路径和其他参数
# proxy_cache_path path [levels=levels] keys_zone=name:size [inactive=time] [max_size=size] [loader_files=number] [loader_sleep=time] [loader_threshold=time];
# 缓存路径 /data/nginx/cache 缓存结构为 2 层,即该路径下会有 2 层子目录,缓存文件会保存在最下层子目录
# 缓存的 key 会保存在名为 web_cache 的内存区域,该内存区域大小为 50 m
# 10 分钟内缓存没有被访问就会过期
# 缓存文件最多占用 1g 空间
proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=web_cache:50m inactive=10m max_size=1g;
# proxy_cache_path 指令必须在 include 指令之前
include vhosts/*.conf;
...
}
接下来在 server 小节 的 location / 小节添加如下配置
location / {
proxy_store off;
proxy_redirect off;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Host $http_host;
proxy_pass http://my-server/;
# 缓存使用前面定义的内存区域
proxy_cache web_cache;
# 这个貌似没啥用
proxy_ignore_headers Expires Set-Cookie;
# 对于 200 和 304 的响应码进行缓存,过期时间为 2 分钟,这会覆盖前面定义的 10 分钟过期时间
proxy_cache_valid 200 304 2m;
# 设置缓存的 key,这里用到了 nginx 的内嵌变量,表示用整个 url 作 key
proxy_cache_key $scheme$proxy_host$request_uri;
# 在返回的响应里添加响应头 X-Proxy-Cache,其值表示是否命中了缓存,貌似没啥用
add_header X-Proxy-Cache $upstream_cache_status;
# 返回的响应头里,设置过期时间为 10 分,貌似没啥用
expires 10m;
# 貌似没啥用
add_header Access-Control-Allow-Origin "http://myserver.net";
# 貌似没啥用
add_header Access-Control-Allow-Credentials true;
}
@ResponseBody
@RequestMapping("/test/user.do")
public Map user(String imei, String sn, String phone, String name) {
Map map = new HashMap();
map.put("imei", imei);
map.put("sn", sn);
map.put("phone", phone);
map.put("name", name);
return map;
}
location / {
proxy_store off;
proxy_redirect off;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Host $http_host;
proxy_pass http://my-server/;
# 缓存使用前面定义的内存区域
proxy_cache web_cache;
# 对于 200 和 304 的响应码进行缓存,过期时间为 2 分钟,这会覆盖前面定义的 10 分钟过期时间
proxy_cache_valid 200 304 2m;
# 设置缓存的 key,只用 phone 和 name 构造 key
proxy_cache_key $host$uri$is_args$arg_phone&$arg_name;
}
* $is_args
* $arg_{name}
location / {
proxy_store off;
proxy_redirect off;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Host $http_host;
proxy_pass http://my-server/;
# 不缓存 proxy_cache 默认值就是 off,所以也可以省略这一行
proxy_cache off
}
location /test/ {
proxy_store off;
proxy_redirect off;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Host $http_host;
proxy_pass http://my-server/test/;
# 缓存使用前面定义的内存区域
proxy_cache web_cache;
# 对于 200 和 304 的响应码进行缓存,过期时间为 2 分钟,这会覆盖前面定义的 10 分钟过期时间
proxy_cache_valid 200 304 2m;
# 设置缓存的 key,只用 phone 和 name 构造 key
proxy_cache_key $host$uri$is_args$arg_phone&$arg_name;
}
nginx 缓存适合于实时性要求不高,单次传输数据量较大的场合实时性要求不高,对数据不一致的容忍程度就比较高,这时 nginx 缓存的简单易行的优势还是很明显的数据量较大,从 nginx 返回应该比较有性能优势,毕竟将很大的数据从后端的 jetty 传输给 nginx,耗用的时间也许会远远超过从缓存里获取数据的时间。当然,这也不一定成立,网络传输速度比硬盘读取速度更快并不是新闻。
* [http://tengine.taobao.org/nginx_docs/cn/docs/ Nginx 文档]
在此十分感谢本人导师张彦