uwsgi_cache_max_range_offset

设置 uWSGI 缓存中范围请求的最大字节偏移量。 — NGINX HTTP Core

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

说明

在 NGINX 使用 uWSGI 缓存机制时,`uwsgi_cache_max_range_offset` 指令指定范围请求可偏移的最大字节数。范围请求允许客户端仅请求文件的一部分,该部分由字节范围标识,对于恢复中断的下载或媒体流等场景很有用。 当客户端带有 Range 请求头发起请求时,本指令会限制请求在内容中可到达的偏移位置。如果指定的偏移量超过本指令设置的限制,NGINX 将以表明范围不可满足的状态码(HTTP 416)进行响应。该指令的值以字节为单位指定,因此应根据预期的使用模式和所提供内容的类型对其进行微调。 例如,如果 `uwsgi_cache_max_range_offset` 设置为 1024,客户端只能请求缓存对象前 1024 字节范围内的部分内容偏移。这可以防止大文件导致的过度资源消耗,并通过限制为提供部分内容而进行的缓存查找和内存分配范围来提高性能。

配置示例

location /app {
    uwsgi_pass 127.0.0.1:9000;
    uwsgi_cache my_cache;
    uwsgi_cache_max_range_offset 2048;
}

将该值设置得过高可能在处理大文件的范围请求时导致资源使用过多。

不设置此指令可能会导致某些期望使用范围定位功能的客户端出现意外行为。