uwsgi_force_ranges

当设置为 'on' 时,`uwsgi_force_ranges` 指令使服务器在处理 uWSGI 应用的范围请求时返回完整响应。 — NGINX HTTP Core

uwsgi_force_ranges
httpserverlocation
语法uwsgi_force_ranges on | off;
默认值off
上下文http, server, location
模块NGINX HTTP Core
参数flag

说明

`uwsgi_force_ranges` 指令是 NGINX 中的一个配置选项,用于影响 uWSGI 应用的范围请求如何被处理。当该指令被启用(设置为 'on')时,NGINX 将忽略针对相关 server 或 location 块收到的任何范围请求,返回完整资源而不是部分响应。这种行为在提供部分内容可能导致应用逻辑或客户端预期产生问题的场景中特别有用。 具体来说,该指令应用于 HTTP、server 和 location 块上下文,允许灵活配置。启用时,它会修改响应的生成过程。通常情况下,范围请求可能要求服务器仅传送资源的特定字节范围。然而,当 `uwsgi_force_ranges` 设置为 'on' 时,NGINX 将以发送整个资源的方式处理请求,从而简化请求处理,并可能避免为期望接收完整内容的应用引起的意外行为。 该指令以标志作为其参数。使用 'on' 值会激活该行为,而设置为 'off'(或未设置,因为该指令默认为 'off')则允许采用标准的范围请求处理方式。

配置示例

location /myapp {
    include uwsgi_params;
    uwsgi_pass myapp;
    uwsgi_force_ranges on;
}

确保底层 uWSGI 应用程序兼容接收完整响应;否则可能导致性能问题或增加加载时间。

如果设置为 'on',通过范围请求期望接收部分内容的客户端会改为收到完整资源,这可能导致客户端出现意外行为。