nginx默认内置ngx_http_gzip_module，但精简版或第三方包可能未启用；需通过nginx -v检查with-http_gzip_module，若无输出则须重新编译并添加--with-http_gzip_module参数。

Nginx 默认编译版本大多已内置 ngx_http_gzip_module，但若你使用的是精简版、自定义构建或某些第三方发行包，该模块可能未启用。这时需要在编译安装阶段显式加入。

确认当前 Nginx 是否已含 gzip 模块：
运行命令

nginx -V 2>&1 | grep -o with-http_gzip_module

若有输出，说明模块已存在，无需重新编译；若无输出，则需手动启用。

编译时启用 gzip 模块的关键步骤

在执行 ./configure 阶段，必须添加 --with-http_gzip_module 参数：

Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

• 下载并解压 Nginx 源码（如 nginx-1.24.0.tar.gz）
• 进入源码目录，运行 configure 命令（示例）：
  • 基础必备依赖：确保系统已安装 zlib-devel（gzip 依赖 zlib 压缩库），CentOS/RHEL 执行 yum install -y zlib-devel；Ubuntu/Debian 执行 apt-get install -y zlib1g-dev
  • configure 示例：

    ./configure \
          --with-http_gzip_module \
          --prefix=/usr/local/nginx \
          --with-http_ssl_module \
          --with-http_v2_module

    其中 --with-http_gzip_module 是启用 gzip 的必要项，其余为常用功能可按需添加
  • 编译并安装：make && sudo make install

验证模块是否生效

安装完成后，再次检查：

• nginx -V 2>&1 | grep with-http_gzip_module —— 应有输出
• 启动 Nginx 后，在 nginx.conf 的 http 块中添加 gzip on; 并重载（nginx -s reload）
• 用 curl -I -H "Accept-Encoding: gzip" https://your-site.com/test.js 查看响应头是否含 Content-Encoding: gzip

注意几个常见误区

不是所有“gzip 相关配置”都依赖编译选项：

• gzip_static on 需要额外启用 --with-http_gzip_static_module，和普通 gzip 模块是两个独立模块
• gzip 指令本身只控制运行时行为，但前提是模块已编译进二进制；仅写配置不启用模块会静默失效
• 部分云平台或容器镜像（如 Alpine 官方 nginx 包）默认不含 gzip 模块，需自行构建或换用 full 版本镜像

配置好后，gzip 功能就真正可用，后续只需在 nginx.conf 中合理设置 gzip_types、gzip_min_length 等参数即可发挥效果。