Ubuntu 24.04（NGINX 1.26.2）启用Brotli压缩的适配方案咨询

Hey there, let's work through your Brotli setup issue on Ubuntu 24.04 with NGINX 1.26.2. I totally get why older guides aren't cutting it—Ubuntu 24.04 (Noble) is still relatively new, so a lot of the PPAs and methods from previous versions don't play nice anymore, especially since your NGINX is coming from the WordOps repository. Let's break down the most reliable approaches for your setup:

Option 1: Use WordOps Built-in Tools (Simplest Route) #

Since you're using WordOps-managed NGINX, their ecosystem has built-in support for adding modules like Brotli. Here's how to try it:

• First, check your current NGINX stack status to see if Brotli is already available:

  wo stack status
  

• If it's not listed, install the Brotli module using WordOps's dedicated command:

  wo stack install nginx-brotli
  

• Once installed, you'll need to enable Brotli in your NGINX config. Add these lines to your http block (usually in /etc/nginx/nginx.conf):

  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; # Balances compression ratio and performance
  

• Test the config and restart NGINX to apply changes:

  sudo nginx -t
  sudo systemctl restart nginx
  

Option 2: Manually Compile the Brotli Module (For Custom Setups) #

If the WordOps command doesn't work for some reason, manually compiling the module ensures full compatibility with your exact NGINX version. Just follow these steps carefully:

1. Install the required build dependencies:

   sudo apt update && sudo apt install build-essential libpcre3 libpcre3-dev zlib1g zlib1g-dev libssl-dev git
   

2. Download the exact same version of NGINX source code as your installed version (1.26.2):

   wget http://nginx.org/download/nginx-1.26.2.tar.gz
   tar -xzf nginx-1.26.2.tar.gz
   cd nginx-1.26.2
   

3. Clone the official Google Brotli NGINX module source and initialize its submodules:

   git clone https://github.com/google/ngx_brotli.git
   cd ngx_brotli
   git submodule update --init --recursive
   cd ..
   

4. Get your current NGINX's compile arguments (this is critical—we need to match them exactly):

   nginx -V
   

   Copy everything after configure arguments: (it'll look like a long string of --prefix=... flags).
5. Configure the build with your existing arguments plus the Brotli module:

   ./configure [paste-the-compile-arguments-here] --add-dynamic-module=./ngx_brotli
   

6. Compile only the modules (no need to rebuild the entire NGINX binary):

   make modules
   

7. Copy the compiled modules to NGINX's module directory:

   sudo cp objs/ngx_http_brotli_filter_module.so /usr/lib/nginx/modules/
   sudo cp objs/ngx_http_brotli_static_module.so /usr/lib/nginx/modules/
   

8. Load the modules in your NGINX config—add these lines at the very top of /etc/nginx/nginx.conf:

   load_module modules/ngx_http_brotli_filter_module.so;
   load_module modules/ngx_http_brotli_static_module.so;
   

9. Add the Brotli compression rules to your http block (same as Option 1), then test and restart NGINX:

   sudo nginx -t
   sudo systemctl restart nginx
   

How to Verify Brotli is Working #

Once you've set everything up, run this curl command against your domain to confirm:

curl -H "Accept-Encoding: br" -I https://your-domain.com

If you see Content-Encoding: br in the response headers, you're good to go!

Key Notes #

• Always back up your NGINX config files before making changes—you can use sudo cp /etc/nginx/nginx.conf /etc/nginx/nginx.conf.backup to be safe.
• Since your NGINX is from WordOps, avoid mixing with third-party PPAs that aren't tested with their stack—this can cause version conflicts.

备注：内容来源于stack exchange，提问作者grl570810