fastcgi_force_ranges

`fastcgi_force_ranges` 指令强制 FastCGI 服务器对字节范围请求以 `206 Partial Content` 状态进行响应。 — NGINX HTTP Core

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

说明

`fastcgi_force_ranges` 指令在 NGINX 中用于处理发送到 FastCGI 后端的字节范围请求。默认情况下,一些 FastCGI 应用可能无法正确支持字节范围,导致对部分请求的内容传递不正确。当此指令启用(设置为 'on')时,NGINX 将确保字节范围请求被正确解释并由 FastCGI 服务器处理,强制其在指定范围有效的情况下以 `206 Partial Content` 响应。 在实际应用中,该指令对通过 HTTP 提供视频或音频内容尤其重要,因为客户端可能会为流式播放功能请求特定的字节范围。通过指示 FastCGI 服务器确认这些字节范围请求,NGINX 提高了兼容性和内容传递效率。该指令可以全局应用,也可以在特定的 server 和 location 上下文中使用,为各种网站配置提供灵活性。 `fastcgi_force_ranges` 指令接受一个标志:可以设置为 'on' 或 'off',其中 'off' 禁用强制响应行为。启用时,NGINX 会直接与 FastCGI 服务器交互以协商和管理字节范围,确保客户端接收它们请求的适当数据段。此行为增强了最终用户体验,尤其适用于富媒体应用。

配置示例

server {
    location /api {
        fastcgi_pass backend;
        fastcgi_force_ranges on;
    }
}

确保 FastCGI 服务器支持范围请求,因为并非所有服务器都能正确实现此功能。

无差别地使用此指令可能导致意外后果,例如由于请求处理不当而增加服务器负载。