nginx Proxy Cache 配置

Posted 2022-08-02 itsuibi

总结一下 proxy cache 设置的常用指令及使用方法：

• proxy_cache

proxy_cache zone | off

配置一块公用的内存区域的名称，该区域可以存放缓存的索引数据。注意：zone 代表用于存放缓存索引的内存区域的名称（需要使用 proxy_cache_path指令设置）；off 代表关闭Proxy Cache功能

• proxy_cache_path

proxy_cache_path path [levels=levels] keys_zone=name:size [inactive=time1] [max_size=size2] [loader_files=number] [loader_sleep=time2] [loader_threshold=time3];

设置nginx服务器存储缓存数据的路径以及和缓存索引相关的内容

path，设置缓存数据存放的根路径

levels，设置在相对path路径的第几级hash目录中缓存数据。levels=1，表示一级hash目录；levels=1:2，表示两级，依次类推

name:size，设置存放缓存索引的内存区域名称的大小 例如 zone:100m

time1，设置强制更新缓存的时间，如果在time1时间内缓存没有被访问，那么就强制删除磁盘上的缓存

size2，设置硬盘中缓存数据的大小限制，超过该限制的时候根据最少访问原则删除缓存

number，缓存索引重建进程每次加载的数据元素的数量上限

time2，设置缓存索引重建进程在一次遍历结束，下次遍历开始之间的暂停时长

time3，设置遍历一次磁盘索引源数据的时间上限

• proxy_cache_bypass

proxy_cache_bypass string

配置nginx服务器向客户端发送相应数据时，不从缓存中获取的条件。这些条件支持nginx配置的常用变量。

例如

proxy_cache_bypass $cookie_nocache $arg_nocache $arg_comment $http_pragma $http_authorization

当至少有一个字符串指令不为空或者不等于0时,相应数据不从缓存获取

• proxy_cache_key

proxy_cache_key string;

用于设置nginx在内存中建立索引时使用的关键字

例如

proxy_cache_key $scheme$proxy_host$uri$is_args$args;

• proxy_cache_lock

proxy_cache_lock  on|off;

是否开启缓存的锁功能

• proxy_cache_lock_timeout

proxy_cache_lock_timeout time;

设置缓存的锁功能开启后锁的超时时间

• proxy_cache_min_uses

proxy_cache_min_uses number;

当客户端向被代理服务器发送相同的请求达到指定的次数时，nginx服务器才会对该请求的响应数据做缓存，默认为1

• proxy_cache_use_stale

proxy_cache_use_stale error|timeout|invalid_header|updating|http_500|http_502|http_503|http_504|http_404|off ...

当nginx服务器访问被代理服务器时出现服务器无法访问或者访问错误等现象时。nginx服务器可以使用历史缓存响应客户端的请求

• proxy_cache_valid

proxy_cache_valid [code ...] time;

针对不同的HTTP响应状态设置不同的缓存时间

例如

proxy_cache_valid 200 302 10m;
proxy_cache_valid  301 1h;

 

以上就是设置 Proxy Cache时常使用的几种指令，但是有时候我们自己进行测试时会发现我们制定的缓存目录并没有生成缓存，只是我们需要确认一下这几个指令是否进行了设置：

proxy_cache_path、proxy_pass、proxy_cache、proxy_cache_valid、proxy_cache_key

例如

http
  proxy_cache_path  /home/soft/nginx/data/cache keys_zone=mayuan:100m;

  server
         ..  省略其他配置  ..
    
         location / 
            proxy_pass http://127.0.0.1:8080;
            proxy_cache mayuan;
            proxy_cache_key $scheme$proxy_host$uri$is_args$args;
            proxy_cache_valid  200 304 302 24h;