Nginx中gzip资源压缩的5大场景配置实战指南

# ❌ 危险的“万能”配置（生产环境慎用！）
gzip on;
gzip_types *;
gzip_min_length 10;
gzip_comp_level 6;

# /etc/nginx/conf.d/frontend.conf
server {
    listen 80;
    server_name app.example.com;

    # 启用 gzip（全局开关）
    gzip on;
    gzip_vary on;                    # 关键！让缓存系统区分压缩/未压缩版本
    gzip_proxied any;                # 对代理响应也启用（重要！后端 java 可能返回未压缩体）
    gzip_disable "msie6";            # 兼容 ie6（若仍需支持）

    # ✅ 精确 mime 类型白名单（拒绝 *！）
    gzip_types
        text/css
        text/javascript
        text/html
        text/plain
        application/javascript
        application/json
        application/xml
        application/rss+xml
        image/svg+xml;

    # 分层最小长度（小文件不压，大文件必压）
    gzip_min_length 512;

    # 统一中等压缩等级（兼顾速度与体积）
    gzip_comp_level 6;

    # 静态资源根目录
    location /static/ {
        alias /var/www/app/static/;
        expires 1y;
        add_header cache-control "public, immutable";
        
        # 针对 .map 文件单独降级（可选）
        location ~ \.map$ {
            gzip_comp_level 3;
            gzip_min_length 2048;
        }
    }

    # html 入口页（常含动态变量，需配合后端）
    location / {
        proxy_pass http://backend_java;
        proxy_set_header host $host;
        proxy_set_header x-real-ip $remote_addr;
        # 传递 accept-encoding 给后端，让 java 层也可决策
        proxy_set_header accept-encoding $http_accept_encoding;
    }
}

// vite.config.ts（vite 项目）
export default defineconfig({
  build: {
    rollupoptions: {
      output: {
        // ❌ 关闭 vite 自动 gzip（交由 nginx 统一处理）
        manualchunks: undefined,
      }
    },
    // ✅ 启用 brotli（更优替代，见后文扩展）
    brotlisize: false, // 不校验大小
  }
})

# application.yml
server:
  compression:
    enabled: false  # 🔑 关键！交由 nginx 统一处理
    mime-types: ""  # 清空（即使 enabled: true 也不生效）

// compresshintfilter.java
@component
@order(ordered.highest_precedence)
public class compresshintfilter implements filter {
    @override
    public void dofilter(servletrequest request, servletresponse response,
                         filterchain chain) throws ioexception, servletexception {
        httpservletresponse httpresponse = (httpservletresponse) response;
        httpservletrequest httprequest = (httpservletrequest) request;
        // 对 /api/** json 响应添加 hint（仅作标识，nginx 需配合配置）
        string requesturi = httprequest.getrequesturi();
        if (requesturi.startswith("/api/") && 
            "application/json".equals(httpresponse.getcontenttype())) {
            // 建议 nginx 压缩（实际由 gzip_types 控制，此头仅为可观测性）
            httpresponse.setheader("x-content-compress", "auto");
        }
        chain.dofilter(request, response);
    }
}

# 在 upstream 或 location 中添加
location /api/ {
    proxy_pass http://spring_boot_backend;
    
    # 关键：强制清除上游可能误设的 content-encoding
    proxy_hide_header content-encoding;
    proxy_hide_header vary;

    # ✅ 确保 nginx 对 json 响应执行压缩（即使上游没设）
    proxy_set_header accept-encoding "gzip";
    
    # 可选：根据 x-content-compress 头做条件压缩（需 nginx-plus 或第三方模块）
    # 此处用基础版，依赖 gzip_types 白名单即可
}

# 全局 gzip_types 已包含 application/json → 自动生效

location / {
    proxy_pass http://java_template_engine;

    # 1️⃣ 强制指定响应编码（关键！）
    charset utf-8;

    # 2️⃣ 确保 gzip_types 包含 text/html
    # （已在全局配置）

    # 3️⃣ 禁用可能的编码转换（避免 gzip 与 charset 冲突）
    proxy_force_ranges off;

    # 4️⃣ 设置 vary 头（nginx 自动加，此处显式确认）
    add_header vary "accept-encoding";
}

// thymeleafconfig.java
@bean
public springtemplateengine templateengine() {
    springtemplateengine templateengine = new springtemplateengine();
    // ✅ 确保模板输出 utf-8
    templateengine.settemplateresolver(templateresolver());
    return templateengine;
}
@bean
public templateresolver templateresolver() {
    servletcontexttemplateresolver resolver = new servletcontexttemplateresolver();
    resolver.setcharacterencoding("utf-8"); // 🔑
    resolver.setcacheable(false); // 开发期关缓存，压缩不影响
    return resolver;
}

content-encoding: gzip
vary: accept-encoding
content-length: 12480  ← 明显小于原始 html（如 42kb）

# 字体路径（/fonts/）
location /fonts/ {
    alias /var/www/app/fonts/;
    expires 1y;
    add_header cache-control "public, immutable";

    # ✅ 显式允许 svg 压缩（image/svg+xml 已在 gzip_types 中）
    # ❌ 禁止 woff2（通过 map 拦截）
    if ($sent_http_content_type = "font/woff2") {
        gzip off;
    }

    # 可选：对 woff 降级压缩
    if ($sent_http_content_type = "font/woff") {
        gzip_comp_level 3;
        gzip_min_length 1024;
    }
}

@font-face {
  font-family: 'myfont';
  src: url('/fonts/myfont.woff2') format('woff2'), /* ✅ 首选 */
       url('/fonts/myfont.woff') format('woff');   /* ⚠️ 回退 */
  font-weight: normal;
  font-style: normal;
}

gzip_min_length 10; # 对 328 字节的 health 响应也压缩 → 得不偿失

# 健康检查路径（禁用压缩）
location /actuator/health {
    proxy_pass http://spring_boot_backend;
    gzip off; # 🔑 强制关闭
}

# metrics 路径（启用压缩）
location /actuator/metrics {
    proxy_pass http://spring_boot_backend;
    # 继承全局 gzip 配置（因 >1kb，自动触发）
}

# prometheus 指标（大文本，明确启用）
location /prometheus {
    proxy_pass http://prometheus_exporter;
    # 全局 gzip_types 已含 application/json → 自动生效
}

# 启用 brotli（需 nginx 编译支持）
brotli on;
brotli_comp_level 6;
brotli_types
    text/css
    text/javascript
    text/html
    application/json
    application/xml
    image/svg+xml;

# 与 gzip 共存：按 accept-encoding 自动协商
gzip on;
gzip_types ... ; # 同前

# ✅ 关键：vary 头需同时包含两者
add_header vary "accept-encoding";

location /events/ {
    proxy_pass http://sse_backend;
    proxy_buffering off;          # 关键：禁用缓冲
    proxy_cache off;
    gzip off;                       # 🔑 绝对禁用
    chunked_transfer_encoding on;

    # 保持长连接
    proxy_http_version 1.1;
    proxy_set_header connection '';
}

location /nginx_status {
    stub_status on;
    access_log off;
    allow 127.0.0.1;
    deny all;
}

# 定义日志格式（含压缩信息）
log_format gzip_log '$remote_addr - $remote_user [$time_local] '
                     '"$request" $status $body_bytes_sent '
                     '"$http_referer" "$http_user_agent" '
                     'gzip: $gzip_ratio req_time: $request_time';

access_log /var/log/nginx/gzip_access.log gzip_log;

# 测量原始体积与延迟
ab -n 1000 -c 100 -h "accept-encoding: identity" http://app.example.com/api/products
# → body size: 245800 bytes, time per request: 178ms

# 在 /api/products location 中临时启用
gzip on;
gzip_types application/json;
gzip_min_length 1024;
gzip_comp_level 6;

ab -n 1000 -c 100 -h "accept-encoding: gzip" http://app.example.com/api/products
# → body size: 58200 bytes (-76%), time per request: 142ms (-20%)

# 监控 nginx worker cpu
top -p $(pgrep -f "nginx: worker")
# → 观察 %cpu 是否稳定 < 30%

# 仅对特定 ua 启用（如内部测试流量）
map $http_x_test_flag $enable_gzip {
    "true" "on";
    default "off";
}
gzip $enable_gzip;