server_tokens off仅隐藏Nginx版本号(如nginx/1.24.0→nginx),不删除Server头本身;需配合proxy_hide_header Server(在proxy_pass同location内)和more_clear_headers或Lua清除错误页残留,且须验证HTTPS及502等错误响应。

server_tokens off 只能隐藏版本号,不能删掉 Server 头
很多人以为加了 server_tokens off 就万事大吉,结果用 curl -I 一测,响应头里还是有 Server: nginx。这是因为该指令只移除版本号(比如不显示 nginx/1.24.0),但保留 Server: nginx 字样。它生效范围必须是 http、server 或 location 块,推荐放在 http 块里全局控制。
特别注意:这个设置对 Nginx 自己生成的错误页(如 404、502)也生效,但很多人只测正常 200 响应,漏掉错误路径——停掉后端服务,访问一个不存在的接口,再看响应头,才是真实检验场景。
proxy_hide_header Server 必须写在 proxy_pass 所在 location 里
当 Nginx 作为反向代理时,后端(比如 Spring Boot、Flask、Tomcat)返回的 Server 头默认会被原样转发。想屏蔽它,得用 proxy_hide_header Server,但这条指令不会跨作用域生效:
- 写在
http块里 → 对所有 location 无效 - 写在
server块里 → 若该 server 下没有proxy_pass,也不起作用 - 必须和
proxy_pass在同一个location块内,才真正拦截后端返回的Server头
同理,如果后端还返回 X-Powered-By、X-AspNet-Version 等,也得在同一 location 里补上:proxy_hide_header X-Powered-By。
错误页里的 Server 头最难清,常规配置覆盖不到
Nginx 在返回 404、502、503 这类错误响应时,会用自己的模板生成 HTML 页面,并附带自己的 Server 头。此时 proxy_hide_header 不起作用(因为没经过 upstream),server_tokens off 也只管版本号——你仍可能看到 Server: nginx。
要彻底清除,只有两个现实选项:
- 用
more_clear_headers 'Server'(需安装headers-more-nginx-module,OpenResty 默认带) - 用 Lua(OpenResty 环境):
header_filter_by_lua_block { ngx.header.Server = nil }
别指望重编译 Nginx 加 --without-http-server-token-module,太重,且不解决后端透出或错误页问题。
验证时别只 curl -I http://,HTTPS 和错误码都得测
常见验证失误:
- 只测 HTTP 的 200 响应,忽略 HTTPS 场景 →
curl -I https://domain.com要加-k绕过证书校验,否则连接中断看不到头 - 没触发真实错误 → 主动停掉 upstream 服务,访问任意路径,检查 502 响应头和页面 HTML 源码里是否还有
nginx字样 - 忘了中间件干扰 → CDN、WAF、云防火墙可能自己加回
Server头,得在它们后台关掉或透传控制
最稳妥的验证命令是:curl -kI https://your-domain.com/nonexistent-path,看响应头和 body 是否完全不含 Server 字段。


















