Nginx 中 HTTP 代理如何配置后端请求压缩算法

Nginx反向代理需显式配置proxy_set_header Accept-Encoding才能触发后端压缩响应，推荐值为”br, gzip, deflate”并配合proxy_http_version 1.1；后端必须启用对应压缩中间件或配置，且Nginx应关闭二次压缩以避免重复处理。

当 Nginx 作为反向代理时，后端请求（即 Nginx 发送给上游服务器的请求）默认不会自动添加 Accept-Encoding 头，也就不会触发后端服务的压缩响应。若希望后端返回压缩内容（如 gzip 或 br），需显式配置 Nginx 主动协商压缩算法。

让 Nginx 代理请求带上 Accept-Encoding

Nginx 本身不压缩它发给后端的请求，但可以控制它向后端发送的请求头。关键在于手动设置 Accept-Encoding 请求头：

• 在 location 或 upstream 块中使用 proxy_set_header
• 推荐值：gzip, br, deflate（按优先级顺序，br 最优但需后端支持）
• 务必搭配 proxy_http_version 1.1，因 HTTP/1.0 不规范支持压缩协商

配合后端启用压缩的关键点

仅加请求头还不够，后端服务必须实际支持并启用对应压缩算法：

• 如果后端是 Node.js（Express/Koa），需启用 compression() 中间件，并确保开启 br 或 gzip
• 如果后端是 Java（Spring Boot），检查 server.compression.enabled=true 及 mime-types 配置
• 若后端返回 Content-Encoding: gzip 或 br，说明协商成功；否则检查后端日志或响应头

避免重复压缩与兼容性处理

Nginx 作为代理时，通常不应对后端已压缩的响应再做二次 gzip（除非有特殊缓存策略）：

• 关闭 gzip on 或限定 gzip_types 不包含后端返回的压缩类型（如跳过 application/json 若后端已压）
• 若需兼容老客户端（如 IE6/7），可加 gzip_disable "MSIE [1-6].";
• 建议开启 gzip_vary on;，让中间缓存（CDN、浏览器）能区分压缩/未压缩版本

完整代理压缩协商示例

以下配置让 Nginx 向后端请求时声明支持 Brotli 和 gzip，并正确透传压缩响应：

location /api/ {
    proxy_pass https://backend;
    proxy_http_version 1.1;
    proxy_set_header Accept-Encoding "br, gzip, deflate";
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
<pre class='brush:php;toolbar:false;'># 不对后端响应再压缩（假设后端已处理）
gzip off;

# 确保 Vary 头存在，避免缓存混淆
gzip_vary on;