指令参考

modern_browser

'modern_browser' 指令允许在 NGINX 中对现代网页浏览器的兼容性进行微调。 — NGINX HTTP Core

modern_browser
httpserverlocation
语法modern_browser [];
默认值none
上下文http, server, location
模块NGINX HTTP Core
参数1-2

说明

'modern_browser' 指令在 NGINX 配置中使用，用于指定哪些浏览器应被视为现代浏览器并在处理请求时区别对待。它可以通过根据客户端能力启用或禁用某些功能或行为来提升 Web 应用的性能。该指令可以接受一个或两个参数，允许用户定义在何种具体条件下对现代浏览器应用某些优化或规则。例如，如果请求来自被识别为现代浏览器的客户端，NGINX 可以相应地调整其响应或路由行为。 在配置该指令时，如果指定一个参数，则表示浏览器版本；第二个可选参数可定义额外的兼容性设置。该指令适用于多种上下文，包括 HTTP、server 和 location 块，允许管理员根据用户的浏览器优化服务器响应，可能通过利用诸如 HTTP/2 或特定缓存机制等现代技术来提升整体用户体验。要有效利用此指令，正确理解 user-agent strings 和浏览器能力至关重要。

配置示例

server {
    location / {
        modern_browser Firefox 90;
    }
}
⚠

确保 user-agent strings 已正确指定，以避免发生意外行为。

⚠

如果未正确配置，使用过于宽泛的术语可能会无意中影响旧版浏览器。

相关指令

allowdenyproxy_pass