fastcgi_cache_max_range_offset

控制 FastCGI 缓存中范围请求允许的最大偏移量。 — NGINX HTTP Core

fastcgi_cache_max_range_offset
httpserverlocation
语法fastcgi_cache_max_range_offset size;
默认值none
上下文http, server, location
模块NGINX HTTP Core
参数1

说明

`fastcgi_cache_max_range_offset` 指令定义了当客户端对由 FastCGI 缓存提供的资源发起范围请求时,作为偏移量可以指定的最大字节数。该指令有助于优化缓存行为和对部分下载资源的响应,确保当客户端仅请求文件的特定部分时,服务器不会过度提供过时或过多的数据。 将此指令设置为数值可以让您控制对缓存内容的范围请求响应的粒度。如果偏移量超过指定值,NGINX 可能会选择拒绝该范围请求或根据 FastCGI 模块的实现和现有的缓存策略对其进行不同处理。在需要尽量减少带宽使用的场景中,或在处理经常按部分访问的大文件时,这一点尤其有用,可提供更高效的响应。 此指令可以在 NGINX 配置文件的多个上下文中使用,包括 http、server 和 location 块,从而在不同的使用场景和服务器配置中具有灵活性。

配置示例

http {
    fastcgi_cache_path /var/cache/nginx/fastcgi_temp levels=1:2 keys_zone=my_cache:10m;
    server {
        location / {
            fastcgi_pass backend;
            fastcgi_cache my_cache;
            fastcgi_cache_max_range_offset 1048576;  # 1 MB
        }
    }
}

将偏移量设置得过高可能在检索部分内容时导致不必要的带宽消耗。

如果未设置且出现具有较大偏移量的范围请求,NGINX 可能会拒绝该请求或返回 416 错误。

请确保所指定的大小与所提供内容的预期范围大小一致,以避免性能问题。