为Docker+Nginx环境的Angular应用启用Brotli压缩遇版本错误求助

方案1：安装与Nginx版本匹配的预编译Brotli模块 #

版本不匹配的核心原因是你安装的nginx-mod-http-brotli模块版本和Nginx主程序版本不兼容，按以下步骤修复：

• 先确认当前Nginx镜像的具体版本，在Dockerfile中加一行：

  RUN nginx -v
  

  比如输出是nginx version: nginx/1.23.4，对应的模块版本标识是1023004（版本号转数字规则：11000000 +231000 +4）。
• 替换软件源为支持对应版本模块的第三方源（比如deb.sury.org，该源提供全版本的Nginx模块），以debian系镜像为例：

  RUN apt-get update && apt-get install -y --no-install-recommends \
      apt-transport-https ca-certificates curl gnupg2 \
      && curl -fsSL https://packages.sury.org/nginx/apt.gpg | gpg --dearmor -o /usr/share/keyrings/nginx-archive-keyring.gpg \
      && echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://packages.sury.org/nginx/ bullseye main" > /etc/apt/sources.list.d/nginx.list \
      && apt-get update \
      && apt-get install -y nginx-mod-http-brotli \
      && apt-get clean && rm -rf /var/lib/apt/lists/*
  

• 确保nginx.conf顶部加载正确的模块文件：

  load_module /usr/lib/nginx/modules/ngx_http_brotli_filter_module.so;
  load_module /usr/lib/nginx/modules/ngx_http_brotli_static_module.so;
  

• 最后在default.conf中添加Brotli压缩规则：

  brotli on;
  brotli_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
  brotli_comp_level 6;
  

方案2：从源码编译Nginx并内置Brotli模块 #

这种方式能彻底规避版本兼容问题，步骤如下：

• 基于Alpine镜像构建（镜像体积更小，编译速度更快）：

  FROM alpine:3.18
  
  # 安装编译依赖
  RUN apk add --no-cache gcc g++ make pcre-dev zlib-dev openssl-dev git
  
  # 克隆Nginx和Brotli源码
  RUN git clone https://github.com/nginx/nginx.git /usr/src/nginx \
      && git clone https://github.com/google/ngx_brotli.git /usr/src/ngx_brotli \
      && cd /usr/src/ngx_brotli && git submodule update --init --recursive
  
  # 编译Nginx并集成Brotli模块
  RUN cd /usr/src/nginx \
      && ./configure \
          --prefix=/etc/nginx \
          --sbin-path=/usr/sbin/nginx \
          --modules-path=/usr/lib/nginx/modules \
          --conf-path=/etc/nginx/nginx.conf \
          --error-log-path=/var/log/nginx/error.log \
          --http-log-path=/var/log/nginx/access.log \
          --pid-path=/var/run/nginx.pid \
          --lock-path=/var/run/nginx.lock \
          --http-client-body-temp-path=/var/cache/nginx/client_temp \
          --http-proxy-temp-path=/var/cache/nginx/proxy_temp \
          --http-fastcgi-temp-path=/var/cache/nginx/fastcgi_temp \
          --http-uwsgi-temp-path=/var/cache/nginx/uwsgi_temp \
          --http-scgi-temp-path=/var/cache/nginx/scgi_temp \
          --with-compat \
          --with-file-aio \
          --with-threads \
          --with-http_addition_module \
          --with-http_auth_request_module \
          --with-http_dav_module \
          --with-http_flv_module \
          --with-http_gunzip_module \
          --with-http_gzip_static_module \
          --with-http_mp4_module \
          --with-http_random_index_module \
          --with-http_realip_module \
          --with-http_secure_link_module \
          --with-http_slice_module \
          --with-http_ssl_module \
          --with-http_stub_status_module \
          --with-http_sub_module \
          --with-http_v2_module \
          --with-mail \
          --with-mail_ssl_module \
          --with-stream \
          --with-stream_realip_module \
          --with-stream_ssl_module \
          --with-stream_ssl_preread_module \
          --add-module=/usr/src/ngx_brotli \
      && make && make install
  
  # 复制Angular静态文件和自定义Nginx配置
  COPY dist/your-angular-app /usr/share/nginx/html
  COPY nginx/default.conf /etc/nginx/conf.d/default.conf
  
  EXPOSE 80
  
  CMD ["nginx", "-g", "daemon off;"]
  

• 编译完成后，无需手动加载模块，直接在default.conf中配置Brotli规则即可。

方案3：使用预集成Brotli的第三方Nginx镜像 #

直接用已经内置Brotli模块的镜像，省去自己安装和编译的麻烦，比如fholzer/nginx-brotli：

• 修改Dockerfile如下：

  FROM fholzer/nginx-brotli:latest
  
  # 复制Angular静态文件和自定义配置
  COPY dist/your-angular-app /usr/share/nginx/html
  COPY nginx/default.conf /etc/nginx/conf.d/default.conf
  
  EXPOSE 80
  
  CMD ["nginx", "-g", "daemon off;"]
  

• 直接在default.conf中添加Brotli配置，不需要写load_module指令。

内容的提问来源于stack exchange，提问作者Zaki Mohammed