Nginx容器中集成Brotli压缩应编译动态模块ngx_brotli.so并load_module加载，需严格匹配基础镜像源码版本，Alpine下路径为/usr/lib/nginx/modules/，启用brotli on并关闭gzip，HTTPS下通过curl验证Content-Encoding: br。
在 Docker 容器化环境中为 Nginx 集成 Brotli 压缩，核心是**不重编整个 Nginx 二进制，而是单独编译 ngx_brotli 动态模块（.so 文件），再通过 load_module 加载**。这种方式轻量、可复用、升级安全，也符合 Docker 分层构建逻辑。
确保基础镜像与源码版本严格一致
动态模块加载失败最常见的原因是版本不匹配。必须使用与目标 Nginx 镜像完全相同的源码版本：
- 运行
docker run --rm nginx:1.25.5-alpine nginx -V，查看输出中的nginx version和configure arguments - 从 nginx.org 下载对应版本的源码包（如
nginx-1.25.5.tar.gz） - Alpine 用户注意：镜像中默认路径常为
/usr/lib/nginx/modules/，模块需复制到该位置
构建阶段编译 ngx_brotli.so 动态模块
在 Dockerfile 的 builder 阶段完成编译，只生成模块文件，不安装新 Nginx：
- 安装依赖：
apk add --no-cache git build-base cmake zlib-dev openssl-dev brotli-dev（Alpine）或apt-get install -y build-essential libssl-dev libpcre3-dev zlib1g-dev libbrotli-dev（Debian） - 克隆模块并初始化子模块：
git clone https://github.com/google/ngx_brotli && cd ngx_brotli && git submodule update --init - 进入 Nginx 源码目录，执行：
./configure --with-compat --add-dynamic-module=/tmp/ngx_brotli
（务必保留原始 configure 中的--with-compat） - 运行
make modules（不是make install），生成的ngx_http_brotli_filter_module.so在objs/下
运行阶段加载模块并启用压缩
最终镜像只需最小依赖，仅复制模块文件和配置：
- 用
COPY --from=builder将.so文件复制到容器模块路径，例如：COPY --from=builder /tmp/nginx-1.25.5/objs/ngx_http_brotli_filter_module.so /usr/lib/nginx/modules/ - 在
nginx.conf最开头（user或worker_processes后）添加：load_module modules/ngx_http_brotli_filter_module.so; - 在
http块中启用并配置：brotli on;<br>brotli_comp_level 4;<br>brotli_min_length 1024;<br>brotli_types text/plain text/css application/javascript application/json image/svg+xml;<br>gzip off;
验证是否生效
启动容器后，用 HTTPS 请求验证（Brotli 不在 HTTP 下协商）：
curl -I -H "Accept-Encoding: br" https://your-domain.com/style.css- 响应头中应包含：
Content-Encoding: br - 若返回
gzip或无压缩头，检查是否启用了gzip off，以及 TLS 是否由容器外（如 ingress 或负载均衡器）终止
