在 Docker 中为 Nginx 集成 Brotli 压缩，核心是将 ngx_brotli 编译为动态模块（.so）并通过 load_module 加载，而非重编 Nginx 二进制；需使用与目标 Nginx 版本一致的源码，安装对应系统级 libbrotli 库，执行 configure --with-compat --add-dynamic-module=... 后 make modules 生成 .so，复制到容器模块路径，再在 nginx.conf 开头加载模块、http 块中配置 brotli on 等参数，并确保 HTTPS 环境下用 curl 验证 Content-Encoding: br。
在 Docker 中为 Nginx 集成 Brotli 压缩，核心是把 ngx_brotli 编译为动态模块（.so），再通过 load_module 加载，而非重编整个 Nginx 二进制。这种方式兼容性强、升级安全，也符合 Docker 分层构建与复用原则。
准备基础镜像与依赖库
必须使用与目标 Nginx 版本完全一致的源码包，否则动态模块加载会失败。例如你线上运行的是 nginx:1.24.0-alpine，Dockerfile 就得下载同版本源码。
- 先安装系统级 Brotli 库：
libbrotli-dev（Debian/Ubuntu）或brotil-devel（CentOS/RHEL）；Alpine 则用apk add brotli-dev - 克隆
google/ngx_brotli并初始化子模块（含deps/brotli）：确保它不依赖外部网络拉取——可提前 git clone 到构建上下文 - 注意：Nginx 1.9.11+ 才支持动态模块，所有主流 LTS 版本（1.20+）均满足
编译 ngx_brotli 动态模块
关键不是重新安装 Nginx，而是只生成 ngx_http_brotli_filter_module.so。这步必须在构建阶段完成，且路径需固定。
- 进入 Nginx 源码目录，执行：
./configure --with-compat --add-dynamic-module=/path/to/ngx_brotli - 运行
make modules（不是make install），生成的.so文件位于objs/下 - 将
objs/ngx_http_brotli_filter_module.so复制到容器内标准模块路径，如/etc/nginx/modules/
配置加载与启用 Brotli
模块文件就位后，还需两处配置才能生效：全局加载声明 + HTTP 块启用规则。
- 在
nginx.conf开头（user或worker_processes后）添加：load_module modules/ngx_http_brotli_filter_module.so; - 在
http块中配置压缩参数（注意关闭 gzip 冲突或明确优先级）：brotli on;<br>brotli_comp_level 4;<br>brotli_min_length 1024;<br>brotli_types text/plain text/css text/xml application/javascript application/json application/xml image/svg+xml;
- HTTPS 是硬性前提：Brotli 不会在纯 HTTP 请求中被浏览器协商启用，务必确认容器外有 TLS 终止（如反向代理或 ingress）
验证是否生效
容器启动后，用 curl -I -H "Accept-Encoding: br" https://your-domain.com/test.js 检查响应头：
- 若返回
Content-Encoding: br，说明 Brotli 已成功启用 - 若返回
gzip或无编码头，检查：nginx -t是否报模块未找到、brotli on是否拼写错误、HTTPS 是否到位、浏览器是否实际发送了br在Accept-Encoding - 可加
brotli_static on;配合预压缩的.br文件提升静态资源性能
