proxy_hide_header用于移除后端返回的指定响应头（如x-powered-by、server），仅作用于proxy_pass上游响应，不处理nginx自身头；须置于location内proxy_pass之后，每行配置一个头，不支持正则，需配合server_tokens off隐藏nginx自身server版本。

proxy_hide_header 是 Nginx 作为反向代理时，用于**移除后端服务器返回的特定响应头字段**的指令，它只影响从上游（upstream）接收到的响应头，不会影响 Nginx 自己生成或添加的头（比如 Server、Date 等）。

基本用法：隐藏单个响应头

在 location 或 server 块中使用：

location /api/ {
    proxy_pass https://backend;
    proxy_hide_header X-Powered-By;
}

这样，当后端返回 X-Powered-By: Express 时，Nginx 会将其从最终发给客户端的响应中完全删除。

隐藏多个响应头

可以多次写 proxy_hide_header，每行一个字段：

CPA Update - Secure CLI Proxy API Maintenance

安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。

下载

• proxy_hide_header X-Powered-By;
• proxy_hide_header X-AspNet-Version;
• proxy_hide_header Server;

⚠️ 注意：Server 头默认由 Nginx 自己添加（值为 nginx），若要隐藏它，需额外配合 server_tokens off;（关闭版本号）和 underscores_in_headers on;（如需处理带下划线的自定义头）。

常见误区与注意事项

• 该指令**不支持通配符或正则表达式**，必须精确写出头字段名（大小写不敏感，但建议按规范大驼峰写法）。
• 它只对 proxy_pass 流量生效，对 fastcgi_pass、uwsgi_pass 等无效——那些场景要用对应指令，如 fastcgi_hide_header。
• 如果后端用了多层代理（比如后端又转发给另一个服务），proxy_hide_header 只作用于 Nginx 直接收到的那一层响应头。
• 想彻底禁用某些头（如 Server），除了 proxy_hide_header，还要确认没有其他模块（如第三方模块）重新注入该头。

验证是否生效

用 curl 查看响应头即可：

curl -I https://your-domain.com/api/test

对比开启/注释 proxy_hide_header 后的输出，确认目标头已消失。也可用浏览器开发者工具的 Network 面板检查 Response Headers。