NGINX内容缓存配置

NGINX内容缓存配置

本节介绍如何启用和配置从代理服务器收到的响应的缓存。

• 总览
• 启用响应缓存
• 缓存涉及的NGINX进程
• 指定要缓存的请求
• 限制或绕过缓存
• 从缓存中清除内容
  • 配置缓存清除
  • 发送清除命令
  • 限制对清除命令的访问
  • 从缓存中完全删除文件
  • 缓存清除配置示例
• 字节范围缓存
• 组合配置示例

 

总览

启用缓存后，NGINX Plus将响应保存在磁盘缓存中，并使用它们来响应客户端，而不必每次都代理相同内容的请求。

要了解有关NGINX Plus缓存功能的更多信息，请观看NGINX网络研讨会的内容缓存，并深入了解诸如动态内容缓存，缓存清除和延迟缓存等功能。

 

启用响应缓存

要启用缓存，请将proxy_cache_path指令包含在顶级上下文中。强制性的第一个参数是缓存内容的本地文件系统路径，而强制性参数定义用于存储有关缓存项的元数据的共享内存区的名称和大小：http {}keys_zone

然后将proxy_cache指令包含在要为其缓存服务器响应的上下文（协议类型，虚拟服务器或位置）中，并keys_zone为proxy_cache_path指令指定参数定义的区域名称（在本例中为one）：

请注意，keys_zone参数定义的大小并不限制缓存的响应数据的总量。缓存的响应本身与元数据的副本一起存储在文件系统上的特定文件中。要限制缓存的响应数据量，请max_size在proxy_cache_path指令中包含参数。（但是请注意，缓存的数据量可能会暂时超过此限制，如下一节所述。）

 

缓存涉及的NGINX进程

缓存还涉及另外两个NGINX流程：

• 该高速缓存管理器周期性地起动，检查高速缓存的状态。如果高速缓存大小超出了max_size参数由proxy_cache_path伪指令设置的限制，则高速缓存管理器将删除最近最少访问的数据。如前所述，在缓存管理器激活之间的时间内，缓存的数据量可能会暂时超过限制。
• 该缓存加载器只运行一次，NGINX开始之后。它将有关先前缓存的数据的元数据加载到共享内存区域中。在启动后的最初几分钟内，一次加载整个缓存可能会消耗足够的资源，从而降低NGINX的性能。为避免这种情况，请通过在proxy_cache_path伪指令中包含以下参数来配置缓存的迭代加载：
  • loader_threshold –迭代持续时间，以毫秒为单位（默认为  200）
  • loader_files –一次迭代期间加载的最大项目数（默认为  100）
  • loader_sleeps –迭代之间的延迟，以毫秒为单位（默认为  50）

在下面的示例中，迭代持续300 毫秒或直到200 加载项为止：

proxy_cache_path /data/nginx/cache keys_zone=one:10m loader_threshold=300 loader_files=200;

 

指定要缓存的请求

默认情况下，NGINX Plus会缓存对使用HTTP发出的请求的所有响应，GET并HEAD在首次从代理服务器接收到此类响应时使用方法。NGINX Plus使用请求字符串作为请求的键（标识符）。如果请求具有与缓存的响应相同的密钥，则NGINX Plus会将缓存的响应发送到客户端。您可以在不同的指令，或上下文来控制其响应缓存。http {}server {}location {}

要更改用于计算密钥的请求特征，请包含以下proxy_cache_key指令：

proxy_cache_key "$host$request_uri$cookie_user";

要定义在缓存响应之前必须进行具有相同密钥的请求的最小次数，请包含以下proxy_cache_min_uses指令：

proxy_cache_min_uses 5;

要使用GET和以外的方法来缓存对请求的响应HEAD，请将它们与GET和一起HEAD作为proxy_cache_methods指令的参数列出：

proxy_cache_methods GET HEAD POST;

 

限制或禁用缓存

默认情况下，响应会无限期保留在缓存中。仅当高速缓存超过最大配置大小时才将其删除，然后按自上次请求以来的时间长度顺序进行删除。您可以设置多长时间缓存的响应被认为是有效的，甚至他们是否在所有使用，通过在指示，或上下文：http {}server {}location {}

要限制具有特定状态码的缓存响应被视为有效的时间，请包含以下proxy_cache_valid指令：

proxy_cache_valid 200 302 10m;
proxy_cache_valid 404      1m;

在此示例中，带有代码200或的响应302被认为有效10分钟，带有代码的响应被认为有效4041分钟。要定义所有状态代码的响应的有效时间，请指定any作为第一个参数：

proxy_cache_valid any 5m;

要定义NGINX Plus不向客户端发送缓存的响应的条件，请包含proxy_cache_bypass指令。每个参数定义一个条件，并由许多变量组成。如果至少一个参数不为空并且不等于“ 0”（零），则NGINX Plus不会在高速缓存中查找响应，而是立即将请求转发给后端服务器。

proxy_cache_bypass $cookie_nocache $arg_nocache$arg_comment;

要定义NGINX Plus根本不缓存响应的条件，请包含proxy_no_cache指令，以与proxy_cache_bypass指令相同的方式定义参数。

proxy_no_cache $http_pragma $http_authorization;

 

从缓存中清除内容

NGINX可以从缓存中删除过期的缓存文件。这对于删除过期的缓存内容是必要的，以防止同时提供新旧版本的网页。收到包含自定义HTTP标头或HTTP PURGE方法的特殊“清除”请求后，将清除缓存。

 

配置缓存清除

让我们设置一个配置，该配置标识使用HTTP PURGE方法的请求并删除匹配的URL。

• 在上下文中，创建一个新变量，例如，该变量取决于该变量：http {}$purge_method$request_method

​​​​​​               ​

• 在配置了缓存的块中，包括指令以指定用于缓存清除请求的条件。在我们的示例中，它是上一步中配置的：location {}proxy_cache_purge$purge_method

  server {
      listen      80;
      server_name www.example.com;
  
      location / {
          proxy_pass  https://localhost:8002;
          proxy_cache mycache;
  
          proxy_cache_purge $purge_method;
      }
  }

 

发送清除命令

当proxy_cache_purge指令配置，你需要发送一个特殊的缓存清除请求清除缓存。您可以使用多种工具发出清除请求，包括curl以下示例中的命令：

在该示例中，将清除具有公共URL部分（由星号通配符指定）的资源。但是，此类高速缓存条目不会完全从高速缓存中删除：它们保留在磁盘上，直到因不活动（由指令的inactive参数确定proxy_cache_path）或由高速缓存清除程序（将purger参数启用为proxy_cache_path）或客户端而被删除为止。尝试访问它们。

 

限制对清除命令的访问

我们建议您限制允许发送缓存清除请求的IP地址数量：

geo $purge_allowed {
   default         0;  # deny from other
   10.0.0.1        1;  # allow from localhost
   192.168.0.0/24  1;  # allow from 10.0.0.0/24
}

map $request_method $purge_method {
   PURGE   $purge_allowed;
   default 0;
}

在此示例中，NGINX检查PURGE请求中是否使用了该方法，如果是，则分析客户端IP地址。如果IP地址已列入白名单，则将$purge_method设置为$purge_allowed：1允许清除，并0拒绝它。

 

从缓存中完全删除文件

要完全删除与星号匹配的缓存文件，请激活一个特殊过程，该过程永久性地遍历所有缓存条目，并删除与通配符匹配的条目。在上下文中将参数包含在指令中：cache purgerpurgerproxy_cache_pathhttp {}

proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=mycache:10m purger=on;

 

缓存清除配置示例

http {
    ...
    proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=mycache:10m purger=on;

    map $request_method $purge_method {
        PURGE 1;
        default 0;
    }

    server {
        listen      80;
        server_name www.example.com;

        location / {
            proxy_pass        https://localhost:8002;
            proxy_cache       mycache;
            proxy_cache_purge $purge_method;
        }
    }

    geo $purge_allowed {
       default         0;
       10.0.0.1        1;
       192.168.0.0/24  1;
    }

    map $request_method $purge_method {
       PURGE   $purge_allowed;
       default 0;
    }
}

 

字节范围缓存

初始高速缓存填充操作有时会花费很长时间，尤其是对于大文件。例如，当视频文件开始下载以满足部分文件的初始请求时，后续请求必须等待整个文件被下载并放入缓存中。

NGINX可以缓存此类范围请求，并使用“ 缓存切片”模块逐渐填充缓存，该模块将文件分成较小的“切片”。每个范围请求都选择覆盖所请求范围的特定切片，如果仍未缓存该范围，则将其放入缓存。对这些切片的所有其他请求均从缓存中获取数据。

要启用字节范围缓存：

1. 确保NGINX是使用“ 缓存切片”模块编译的。

2. 使用slice指令指定切片的大小：

   location / {
       slice  1m;
   }

选择切片大小以使切片下载速度更快。如果大小太小，则内存使用可能会过多，并且在处理请求时会打开大量文件描述符，而太大的大小可能会导致延迟。

1. 将$slice_range变量包括到缓存键中：

   proxy_cache_key $uri$is_args$args$slice_range;

2. 使用206状态码启用响应缓存：

   proxy_cache_valid 200 206 1h;

3. 通过$slice_range在Range标头字段中设置变量，可以将范围请求传递到代理服务器：

   proxy_set_header  Range $slice_range;

这是完整的配置：

location / {
    slice             1m;
    proxy_cache       cache;
    proxy_cache_key   $uri$is_args$args$slice_range;
    proxy_set_header  Range $slice_range;
    proxy_cache_valid 200 206 1h;
    proxy_pass        http://localhost:8000;
}

请注意，如果启用了切片缓存，则不得更改初始文件。

 

组合配置示例

下面的示例配置结合了上述某些缓存选项。

http {
    ...
    proxy_cache_path /data/nginx/cache keys_zone=one:10m loader_threshold=300 
                     loader_files=200 max_size=200m;

    server {
        listen 8080;
        proxy_cache mycache;

        location / {
            proxy_pass http://backend1;
        }

        location /some/path {
            proxy_pass http://backend2;
            proxy_cache_valid any 1m;
            proxy_cache_min_uses 3;
            proxy_cache_bypass $cookie_nocache $arg_nocache$arg_comment;
        }
    }
}

在此示例中，两个位置使用相同的缓存，但方式不同。

由于响应backend1很少改变，因此不包括缓存控制指令。响应在第一次发出请求时被缓存，并无限期保持有效。

相比之下，对请求的响应backend2通常由更改来服务，因此它们仅在1分钟内有效，并且直到发出相同请求3次后才被缓存。此外，如果请求符合proxy_cache_bypass指令定义的条件，NGINX Plus会立即将请求传递给，backend2而无需在缓存中查找相应的响应。