Nginx多实例Brotli压缩“实时同步”指配置与模块版本的一致性，而非运行时状态同步；需统一ngx_brotli源码版本、nginx.conf中brotli指令及.so二进制文件，并通过CI/CD分发镜像与配置确保收敛。
在 Nginx 多实例集群中，Brotli 压缩配置本身不依赖运行时状态或共享内存，因此“实时同步”不是指动态传播压缩动作，而是确保所有节点使用**完全一致、可验证的 Brotli 模块版本与配置参数**。只要编译环境、模块路径、启用开关和 MIME 类型列表统一，各实例压缩行为就天然一致。
核心原则：配置即代码，而非运行时同步
Brotli 是编译期加载的模块（动态 .so 或静态链接），其行为由 nginx.conf 中的 brotli on、brotli_comp_level 等指令决定，不涉及跨节点通信或状态共享。所谓“同步”，本质是运维一致性问题：
- 所有节点必须使用**同一版本的 ngx_brotli 源码**（如 commit hash 或 release tag）编译模块
- 所有节点的
nginx.conf中 brotli 相关指令（含brotli_types列表）需逐字相同 - 所有节点加载的
.so模块文件需二进制一致（推荐通过构建产物分发，而非各自编译）
推荐落地方式：CI/CD 流水线驱动配置分发
避免手动同步或脚本轮询，用基础设施即代码（IaC）保障收敛：
- 将 Nginx 编译过程（含
--add-dynamic-module=/path/to/ngx_brotli）封装为 Docker 镜像或 RPM 包，由 CI 构建并推送到私有仓库 - 配置文件模板（如
nginx.conf.j2）存入 Git，其中 brotli 段落固定为：brotli on;<br>brotli_comp_level 5;<br>brotli_min_length 1000;<br>brotli_types text/html application/javascript text/css application/json image/svg+xml;
- 部署时通过 Ansible / SaltStack / Terraform 渲染配置，并校验
nginx -t通过后 reload —— 所有节点最终生效的配置来自同一份源码
关键避坑点：别踩“伪实时”陷阱
以下做法看似“同步”，实则引入风险或无效：
- 不用 rsync 定期推送
/etc/nginx/conf.d/*.conf：若某节点因权限/SELinux/语法错误 reload 失败，配置已覆盖但未生效，形成“假同步” - 不依赖 etcd/Consul 等 KV 存储动态下发 brotli 配置：Nginx 不支持运行时重载 brotli 模块参数，
reload仍需完整配置文件 - 不混用不同编译参数的 Nginx 二进制：比如 A 节点用
--with-compat，B 节点没加，会导致load_module失败，即使配置相同也无法启用 brotli
验证是否真正一致：三步检查法
上线后快速确认集群行为统一：
- 在每台节点执行：
nginx -V 2>&1 | grep -o 'ngx_brotli'，确认输出非空且版本一致 - 抽样请求（如
curl -H "Accept-Encoding: br" -I https://node1.example.com/app.js），对比所有节点响应头中content-encoding: br和content-length是否相同 - 检查 access log 中
$sent_http_content_encoding字段统计，各节点 br / –（未压缩）占比应基本一致，偏差 >2% 就说明某节点配置漏项或模块未加载
