nginx优先使用精确匹配需严格按优先级组织配置:精确域名须各自独立server块、泛域名另起块、每个端口显式设default_server,并通过nginx -t和curl验证。

要让 Nginx 优先使用精确匹配而非泛域名,关键不是“开启”某个开关,而是严格按匹配优先级规则组织配置:把精确域名写在前面、避免正则干扰、显式声明 default_server 防兜底错位。
把精确域名单独写在独立的 server 块里
每个需要被精准路由的域名(如 www.example.com、api.example.com、admin.example.com)都应各自拥有一个 dedicated 的 server 块,并在其中只写该域名:
- server_name www.example.com;
- server_name api.example.com;
- server_name admin.example.com;
不要把这些和泛域名混在一个块里。Nginx 对每个请求只选一个 server 块,独立声明才能触发最高优先级的精确匹配。
泛域名配置必须另起 server 块,且不与精确域名共存
泛匹配(如 *.example.com 或正则)必须放在**其他独立的 server 块**中,例如:
- server { listen 80; server_name *.example.com; … }
- server { listen 443 ssl; server_name ~^([^.]+)\.example\.com$; … }
如果把 www.example.com *.example.com 写在同一行或同一块里,Nginx 仍会先尝试精确匹配 www.example.com —— 这没问题;但一旦 Host 是 blog.example.com,它就会落到 *.example.com 上。真正危险的是误把泛匹配块写在精确块之前,又没设 default_server,导致请求被错误捕获。
显式设置 default_server 避免隐式兜底
Nginx 在无匹配时,默认选**第一个 listen 相同端口的 server 块**,这个行为极易引发意外响应。务必为每个端口显式指定 default_server:
- server { listen 80 default_server; server_name _; … }(用下划线 _ 表示无效域名)
- server { listen 443 ssl default_server; server_name _; … }
这样即使泛域名配置有遗漏,也不会让请求悄悄跑到某个业务 server 块里去。
验证配置是否按预期生效
改完后别直接 reload,先执行两步检查:
- nginx -t 确保语法正确
- 用 curl -H "Host: xxx.example.com" http://127.0.0.1 模拟不同 Host 请求,观察返回的 server 标识或日志中的 $server_name 变量值
特别注意大小写无关性:example.com 和 EXAMPLE.COM 视为相同,无需重复写。











