在容器化环境中集成Nginx的Brotli模块，核心是在构建镜像时完成源码编译与模块注入，而非运行时加载；需基于官方源码镜像（如nginx:alpine）编译Nginx+ngx_brotli，显式安装libbrotli依赖、执行完整make&&make install、复制.so模块、配置load_module及brotli指令，并通过多阶段构建精简最终镜像体积。
在容器化环境中集成 Nginx 的 Brotli 模块，核心不是“安装包”，而是**在构建镜像时完成源码编译与模块注入**。Docker 本身不支持运行时动态加载第三方模块（如 load_module），必须把编译好的 .so 模块和启用配置一并打包进镜像，且确保底层依赖（libbrotli）已静态链接或系统级就位。
基础镜像选择与依赖准备
推荐从官方 nginx:alpine 或 nginx:slim 源码构建镜像，避免使用预编译的二进制包（如 nginx:latest on Debian/Ubuntu），因其不含 Brotli 支持且无法后期注入模块。
-
Alpine 用户：先装
apk add brotli-dev cmake make gcc g++ autoconf automake autoconf-archive libtool；注意 Alpine 的brotli-dev版本需 ≥1.0.9，否则 ngx_brotli 编译可能失败 -
Debian/Ubuntu 用户：运行
apt-get update && apt-get install -y build-essential libssl-dev libpcre3-dev zlib1g-dev libbrotli-dev - 无论哪种基础镜像，都要显式执行
ldconfig或设置LD_LIBRARY_PATH，确保 Nginx 编译时能定位到libbrotlienc.so
Dockerfile 中完成模块编译与打包
关键在于复用原始 Nginx 的 configure 参数，并加入 Brotli 支持——不能只 make modules，而要完整 make && make install，确保生成的二进制、模块、配置模板全部就绪。
- 克隆 Nginx 源码（版本需与线上一致，如
nginx-1.24.0）和ngx_brotli模块（注意git submodule update --init拉取 deps/brotli） - configure 命令必须含：
--add-dynamic-module=/path/to/ngx_brotli --with-compat --with-http_ssl_module --with-http_v2_module（其他模块按需保留） - 执行
make -j$(nproc) && make install，默认安装到/usr/local/nginx；再把生成的objs/ngx_http_brotli_filter_module.so复制到/usr/local/nginx/modules/ - 最后在
/usr/local/nginx/conf/nginx.conf开头添加load_module modules/ngx_http_brotli_filter_module.so;
配置启用与运行时验证
容器启动后，Brotli 必须通过 http{} 块统一启用，且不能与 gzip 冲突：
- 在
nginx.conf的http块中写：brotli on; brotli_static off; brotli_types text/plain text/css application/javascript application/json text/html image/svg+xml; - 务必加
gzip off;或至少gzip_disable "msie6";，避免现代浏览器因 Vary 头混乱导致缓存失效 - 验证方式：进入容器执行
curl -I -H "Accept-Encoding: br" http://localhost/app.js，响应头应含Content-Encoding: br，且状态码为 200
多阶段构建优化镜像体积
编译环境臃肿（gcc、cmake 等）不应留在最终镜像中。采用多阶段构建可大幅减小体积：
- 第一阶段（
builder）：基于debian:slim安装所有编译依赖，完成 Nginx + ngx_brotli 编译安装 - 第二阶段（
final）：基于debian:slim或alpine:latest，仅复制/usr/local/nginx目录、证书、日志路径及自定义配置 - 最终镜像大小可控制在 20–30MB（Alpine）或 45–60MB（Debian），远低于带编译链的镜像（>200MB）
