proxy_hide_header可直接屏蔽后端PHP、Java等应用返回的X-Powered-By、X-AspNet-Version、X-Runtime、X-Generator、Server等敏感响应头，须置于proxy_pass之后、逐行配置，不支持逗号分隔。
直接用 proxy_hide_header 可以有效过滤后端 PHP、Java 等应用主动返回的敏感响应头，比如框架版本、运行环境标识等。它作用于 Nginx 代理响应阶段，不修改后端逻辑，也不依赖后端配合，是隐藏技术栈最常用且见效快的一环。
哪些头需要重点过滤
常见由 PHP（如 Laravel、ThinkPHP）、Java（如 Spring Boot、Tomcat）自动注入的敏感头包括：
-
X-Powered-By：PHP 默认返回
X-Powered-By: PHP/8.2.12，Spring Boot 可能返回X-Powered-By: Express或自定义值 - X-AspNet-Version：.NET 应用特有，暴露 ASP.NET 版本
- X-Runtime：Rails 或部分 Java 中间件添加的请求耗时字段，间接暴露技术选型
- X-Generator：WordPress、Drupal 或静态站点生成器常带此头
-
Server：虽默认不透传，但若后端显式设置（如 Tomcat 返回
Server: Apache-Coyote/1.1），需额外屏蔽
基础配置写法
在 location 或 server 块中加入以下指令即可生效：
location / {
proxy_pass http://backend;
proxy_hide_header X-Powered-By;
proxy_hide_header X-AspNet-Version;
proxy_hide_header X-Runtime;
proxy_hide_header X-Generator;
proxy_hide_header Server;
}
注意：proxy_hide_header 必须放在 proxy_pass 之后才起作用；每行只写一个头字段，不支持逗号分隔或多字段合并。
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
立即学习“PHP免费学习笔记（深入）”；
绕过限制的常见情况与应对
有些头看似被隐藏了，实际仍可能泄露，原因和解法如下：
-
错误页中的 Server 字段未清除：即使设了
proxy_hide_header Server，4xx/5xx 页面仍可能由后端直接渲染并带出原始 Server 头。解决方法是统一自定义错误页，并确保后端关闭调试模式、不输出堆栈或路径信息 -
Set-Cookie、Content-Length 等关键头无法隐藏：Nginx 明确禁止对这类头使用
proxy_hide_header，属于协议安全限制。如需干预 Cookie 内容，应由后端控制HttpOnly、Secure属性，Nginx 只能通过proxy_cookie_path或proxy_cookie_domain重写作用域 -
Location 头被重写后失效：若后端返回 302 并含
Location: http://old.example.com，而 Nginx 同时启用了proxy_redirect，则原始 Location 已被替换，proxy_hide_header Location就不会生效——这不是 bug，而是设计使然
验证是否真正生效
改完配置后务必实测，不能只看配置文件：
- 用
curl -I https://your-domain.com/api/test检查正常接口响应头 - 触发一个 404 或 500 错误（如访问不存在路径），再执行
curl -I，确认错误页也不含被屏蔽的头 - 如果用了负载均衡或多级代理，逐层检查每一跳的响应头，避免某一层漏配
- 定期复查：后端升级新框架、接入新 SDK 或上线新服务时，可能新增未被过滤的头（例如
X-Spring-Cloud-Instance），需同步更新规则
