应显式设置 proxy_set_header accept-encoding "gzip"; 统一后端返回 gzip 压缩内容，避免缓存膨胀与兼容性问题；需配合 gunzip on 实现自动解压，禁用 br 等多值以防旧后端异常。
在 Linux 的 Nginx 中配置 proxy_set_header Accept-Encoding，核心目标是**统一后端响应的压缩格式，避免缓存膨胀、兼容性问题和解压不可控**。默认透传客户端头（如 br, gzip, deflate）看似“原样”，实则带来隐患——后端可能返回 Brotli、gzip 或明文，Nginx 缓存会为同一 URL 存多份，老客户端或中间设备还可能无法处理 br。
推荐做法：显式设为 "gzip"
让后端只返回 gzip 压缩内容，便于 Nginx 统一处理（缓存、日志、改写）：
- 在
location或server块中添加：proxy_set_header Accept-Encoding "gzip"; - 双引号必须保留，否则分号会被误解析为指令分隔符
- 确保后端已启用 gzip 输出（如 Node.js 的
compression、Python 的gzip middleware） - 该配置会覆盖客户端原始头，所有请求都“建议”后端用 gzip 压缩
需要 Nginx 自动解压时：启用 gunzip
若你希望 Nginx 接收 gzip 响应后先解压，再发给客户端（例如做内容替换、适配不支持 gzip 的终端），需额外开启：
- 添加配置：
gunzip on; - 注意：
gunzip仅支持gzip，不支持br—— 这正是限制Accept-Encoding为"gzip"的关键原因 - 无需额外设置
gzip_proxied或gzip on，它们影响的是 Nginx 自身生成的响应压缩
慎用多值或 br
除非明确后端全量兼容且运维可控，否则避免以下写法：
-
proxy_set_header Accept-Encoding "br, gzip";—— 部分旧后端不认识br，可能忽略整个头或报错 -
proxy_set_header Accept-Encoding $http_accept_encoding;—— 回退到默认透传，失去统一控制 - Nginx 版本低于 1.13.6 时，
br代理存在缓存与透传缺陷，不建议启用
配套建议：清理干扰头
避免其他配置意外覆盖或冲突：
- 检查是否误启用了
proxy_buffering off，它可能导致 gzip 响应流式转发失败 - 确认未在
upstream块中使用proxy_set_header（该指令只在http/server/location中生效） - 若需禁用后端压缩（强制明文），可设为空：
proxy_set_header Accept-Encoding "";
