proxy_set_header仅用于设置转发给后端的请求头，不可修改响应头；统一响应规范应使用add_header或more_set_headers（需安装headers-more模块），并配合proxy_hide_header净化响应头。
在 Nginx 中，proxy_set_header 本身只用于设置**转发给后端服务的请求头**，不能直接修改或统一响应头（即返回给客户端的 Header）。若目标是“统一响应规范”，核心应使用 add_header 或 more_set_headers（需安装 headers-more 模块），而非 proxy_set_header。但可通过合理配合 proxy_set_header 与响应头指令，实现前后端协同的标准化响应行为。
明确 proxy_set_header 的作用边界
proxy_set_header 只影响发往 upstream 的 HTTP 请求头，例如：
- 传递真实客户端 IP：
proxy_set_header X-Real-IP $remote_addr; - 告知后端使用了 HTTPS：
proxy_set_header X-Forwarded-Proto $scheme; - 透传 Host：
proxy_set_header Host $host;
它不修改后端返回的响应头，也不影响 Nginx 自身返回的响应头。误用它试图“统一响应”会导致配置无效或逻辑混乱。
用 add_header 统一添加标准响应头
在 location 或 server 块中使用 add_header，可向所有响应注入一致的头部（注意：它不会覆盖后端已设置的同名响应头，除非启用 always 参数）：
- 强制内容类型与字符集：
add_header Content-Type "application/json; charset=utf-8" always; - 设置跨域安全策略：
add_header X-Content-Type-Options "nosniff" always; - 添加服务标识：
add_header X-Powered-By "nginx-proxy" always;
注意：add_header 在子请求（如 error_page 内部）中默认不生效，且不继承自上级作用域；需在每个需要的 location 中显式配置，或用 map + variables 配合更灵活控制。
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
用 more_set_headers 覆盖或动态设置响应头
若需修改后端已返回的响应头（如覆盖 Content-Type、删除敏感头），需安装并启用 OpenResty 的 headers-more-nginx-module：
- 替换 Content-Type：
more_set_headers 'Content-Type: application/json; charset=utf-8'; - 移除 Server 头：
more_clear_headers Server; - 基于状态码差异化设置：
more_set_headers -s 404 'X-Error: Not Found';
该模块支持条件设置、清除、追加，比原生 add_header 更适合精细的响应头治理。
结合 proxy_hide_header 实现响应头净化
后端可能返回不希望暴露的响应头（如 X-Powered-By、Server、Expires 等），可用 proxy_hide_header 屏蔽：
proxy_hide_header X-Powered-By;proxy_hide_header Server;proxy_hide_header X-AspNet-Version;
此指令仅作用于代理响应，不影响 Nginx 自己生成的响应头。配合 add_header 或 more_set_headers，可构建干净、统一、合规的对外响应规范。
