在 nginx 中动态加载 brotli 压缩模块,核心做法是使用 -with-compat 参数编译第三方模块,并通过 load_module 指令在配置文件中引入生成的 .so 文件。这样做可以在不重新编译 nginx 主程序的情况下启用 brotli 压缩,且能保持与当前 nginx 版本的兼容性。

如何编译支持动态加载的 Brotli 模块
编译过程需要确保 Nginx 核心和 Brotli 模块都使用 --with-compat 标志,这样生成的共享对象才能被任意版本的 Nginx 加载。具体操作是下载源码后,在 configure 阶段加入相关参数,最后执行 make 命令生成 .so 文件。

cd /usr/local/src
# 1. 获取 Nginx 源码(以 1.24.0 为例)
wget http://nginx.org/download/nginx-1.24.0.tar.gz
tar -zxvf nginx-1.24.0.tar.gz
# 2. 获取 ngx_brotli 模块源码
git clone https://github.com/google/ngx_brotli.git
# 3. 进入 Nginx 源码目录
cd nginx-1.24.0
# 4. 配置编译选项
./configure \
--prefix=/etc/nginx \
--sbin-path=/usr/sbin/nginx \
--modules-path=/usr/lib64/nginx/modules \
--conf-path=/etc/nginx/nginx.conf \
--error-log-path=/var/log/nginx/error.log \
--http-log-path=/var/log/nginx/access.log \
--with-compat \
--add-dynamic-module=../ngx_brotli
# 5. 仅编译,不安装
make
编译成功后,会在 objs/ 目录下生成 ngx_http_brotli_filter_module.so 和 ngx_http_brotli_static_module.so 两个文件。需要将它们复制到 Nginx 的模块目录(通常是 /usr/lib64/nginx/modules/ 或 /usr/lib/nginx/modules/)。
如何在 Nginx 配置中启用 Brotli
加载模块后,需要在 nginx.conf 的全局块中使用 load_module 指令指向 .so 文件路径,并在 http 块中开启 brotli 和 brotli_static 开关。同时建议设置合适的压缩级别和类型。

# /etc/nginx/nginx.conf
# 全局块:加载动态模块
load_module modules/ngx_http_brotli_filter_module.so;
load_module modules/ngx_http_brotli_static_module.so;
events {
worker_connections 1024;
}
http {
include mime.types;
default_type application/octet-stream;
# 基础日志格式
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent"';
access_log /var/log/nginx/access.log main;
sendfile on;
keepalive_timeout 65;
server {
listen 80;
server_name localhost;
location / {
root /usr/share/nginx/html;
index index.html index.htm;
# 启用 Brotli 压缩
brotli on;
# 启用静态文件预压缩检查
brotli_static on;
# 压缩级别 (1-11)
brotli_comp_level 6;
# 最小响应长度才压缩
brotli_min_length 20;
# 压缩 MIME 类型
brotli_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript image/svg+xml;
}
}
}
配置完成后,运行 nginx -t 检查语法,然后 nginx -s reload 重载配置。可以通过浏览器开发者工具查看 Response Headers 中的 Content-Encoding: br 来验证是否生效。
当请求头缺少 Accept-Encoding: br 时模块行为是什么
如果客户端请求头中不包含 Accept-Encoding: br,Nginx 的 Brotli 模块不会进行压缩,而是直接返回原始未压缩的内容。这是 HTTP 协议的标准行为,服务器仅在客户端明确支持时才使用特定编码。
,











