proxy_set_header仅修改发往后端的请求头，不影响响应头或响应体；修改响应头需用proxy_hide_header、add_header或more_set_headers，修改响应体需用sub_filter或lua模块。

注意：proxy_set_header 用于修改发送给后端服务器的请求头，不能修改后端返回的响应头。 Nginx 的 `proxy_set_header` 指令作用于**请求阶段**，即 Nginx 作为反向代理，将客户端请求转发给上游（后端）服务时，用来添加或覆盖请求头字段。它对后端返回的响应内容（包括响应头和响应体）**没有影响**。 如果你的目标是“修改后端响应”，需要区分两种常见需求：

✅ 修改后端返回的响应头

使用 proxy_hide_header、proxy_pass_request_headers off（不常用）、add_header（注意作用域）或更灵活的 more_set_headers（需安装 headers-more-nginx-module）。

• proxy_hide_header X-Powered-By; —— 屏蔽后端设置的特定响应头
• add_header X-Proxy-By nginx; —— 在响应中添加新头（仅对 2xx 和 3xx 生效，默认不覆盖已有同名头）
• 若需强制覆盖或设置任意状态码下的响应头，推荐使用第三方模块：more_set_headers "X-Content-Type-Options: nosniff";

✅ 修改后端返回的响应体（HTML/JSON 等）

使用 sub_filter 指令进行简单文本替换（支持正则需搭配 sub_filter_once off 和 sub_filter_types）。

• sub_filter 'http://backend.example' 'https://public.example';
• sub_filter_types text/html application/json;
• sub_filter_once off; —— 允许全局替换（非仅首处）
• 注意：sub_filter 是流式替换，不适用于压缩响应（需禁用 gzip：gzip off;）

❌ 常见误解澄清

proxy_set_header 的典型用法是：

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

• proxy_set_header Host $host; —— 把原始 Host 传给后端
• proxy_set_header X-Real-IP $remote_addr; —— 透传真实客户端 IP
• proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

这些都发生在请求发出前，与后端响应无关。

✅ 替代方案：用 Lua（OpenResty）精细控制响应

如果需动态修改响应头或响应体（如根据响应状态码、内容特征做不同处理），可借助 ngx_lua 模块：

• 在 header_filter_by_lua_block 中修改响应头
• 在 body_filter_by_lua_block 中流式处理响应体
• 适合复杂逻辑，但需部署 OpenResty 或编译含 Lua 支持的 Nginx