Linux下启用Nginx Brotli压缩需完成三步：1. 编译集成ngx_brotli模块并验证；2. 在http或location块中配置brotli on及brotli_types等参数；3. 按资源类型分层调优压缩级别与参数，并验证生效及兼容性。
Linux 下 Nginx 启用 Brotli 压缩不是改几行配置就能见效的事，核心在于“模块可用、动态启用、按需调优”三步闭环。跳过任一环节，brotli on 都会报错或静默失效。
确认 ngx_brotli 模块已真正集成
Nginx 官方主线版本（含 1.25+）至今不原生支持 Brotli，必须通过 google/ngx_brotli 模块编译接入。验证是否成功只有两个硬指标：
- 执行
nginx -V 2>&1 | grep with-http_brotli_module，有输出才说明模块已编译进内核 - 临时在配置中加
brotli on;后运行nginx -t，若提示unknown directive "brotli"，即模块未加载
宝塔用户需先卸载当前 Nginx，再通过【编译安装】→【添加自定义模块】路径指定 /www/server/ngx_brotli；Docker 或手动部署用户，./configure 必须显式带 --add-module=/path/to/ngx_brotli，且需提前安装 libbrotli-dev（Debian/Ubuntu）或 brotli-devel（RHEL/CentOS）。
在 http 或 location 块中精准启用动态压缩
Brotli 动态压缩由 brotli on 触发，对响应体实时编码，但有两个关键前提不能漏：
-
brotli_static off——设为on会跳过动态压缩，只查找预生成的.br文件，导致配置形同虚设 -
brotli_types必须显式列出实际返回的 MIME 类型，例如：text/plain text/css application/javascript application/json text/html image/svg+xml
漏掉application/javascript就压不到现代前端打包的 JS 文件
推荐统一放在 http{} 块顶层全局生效；如需精细控制（如仅对 API 接口启用），可放在 location /api/ { ... } 内，并搭配 brotli_comp_level 4 等场景化参数。
按资源类型分层调优压缩参数
Brotli 提供 0–11 共 12 级压缩质量，不同级别对 CPU 和首字节延迟（TTFB）影响显著，不能一刀切：
-
动态内容（PHP 渲染页、API JSON 返回）：用
brotli_comp_level 3–5，实测压缩耗时比 level 11 低 60%，压缩率仍高于 Gzip level 9 -
静态文本资源（JS/CSS/HTML/SVG）：可设
6–7，服务器压力可控时收益明显；长期不变文件（如 reset.css）可配8–11+brotli_static on预压缩 -
brotli_min_length 1024——默认值 20 字节太低，小响应不值得压缩，建议设为 1KB 避免无效 CPU 开销 - 大文件流式传输（如长日志、CSV 导出）：可增大
brotli_window 1m提升长距离重复字符串识别能力
验证与兼容性兜底要点
配置完成后务必验证是否真正生效：
- 用
curl -H "Accept-Encoding: br" -I https://yoursite.com/app.js，检查响应头含Content-Encoding: br且状态为 200 - 对比原始文件大小与响应
Content-Length，Brotli 对 HTML/JS/CSS 通常比 Gzip 多压 17–26% - 浏览器 Network 面板查看资源 Size 列，确认显示为
br编码体积
兼容性方面，所有现代浏览器（Chrome 49+、Firefox 44+、Edge 11+、Safari 11+）均支持 Brotli，且优先选择 br。但仍建议保留 Gzip 兜底：
— 若无需支持 IE11 或老旧 WebView，可直接 gzip off;
— 若需兼容，仅对基础类型启用：gzip_types text/plain;，避免与 Brotli 同时作用于同一资源造成 CPU 浪费。
