Nginx servername匹配规则都有什么?

off999 2025-03-24 18:58 42 浏览 0 评论

Nginx 的 server_name 指令用于配置虚拟主机，它决定了 Nginx 如何根据客户端请求的 Host 请求头来选择哪个 server 块来处理请求。 Nginx 的 server_name 匹配规则有以下几种，并按照优先级顺序进行匹配：

1. 精确匹配 (Exact Match)

规则: server_name 指令中直接写明完整的域名或 IP 地址。
优先级: 最高。
示例:
nginx复制代码
server { listen 80; server_name example.com; # ... } server { listen 80; server_name www.example.com; # ... } server { listen 80; server_name 192.168.1.100; # ... } 当请求的 Host 头完全匹配 example.com、www.example.com 或 192.168.1.100 时，对应的 server 块会被选中。

2. 通配符匹配 (Wildcard Match)

通配符匹配允许使用 * 字符来匹配多个域名。Nginx 支持两种类型的通配符匹配：

规则: server_name 指令以 *. 开头。
优先级: 低于精确匹配，高于后缀通配符和正则表达式匹配。
示例:
nginx复制代码
server { listen 80; server_name *.example.com; # 匹配 example.com 的所有子域名，如 blog.example.com, api.example.com 等 # ... } 请求 Host 头为 blog.example.com、api.example.com 等都会匹配到这个 server 块。

规则: server_name 指令以 .* 结尾。
优先级: 低于精确匹配和前缀通配符匹配，高于正则表达式匹配。
示例:
nginx复制代码
server { listen 80; server_name www.example.*; # 匹配 www.example.com, www.example.net, www.example.org 等 # ... } 请求 Host 头为 www.example.com、www.example.net 等都会匹配到这个 server 块。

通配符匹配的注意事项:

只匹配一个层级: 通配符 * 只能匹配一个层级的域名部分。例如，*.example.com 可以匹配 blog.example.com，但不能匹配 a.b.example.com。
最长匹配原则: 当多个通配符 server_name 都可能匹配时，Nginx 会选择最长的通配符匹配。例如，如果同时配置了 *.example.com 和 *.com，对于 blog.example.com 的请求，会优先匹配 *.example.com。

3. 正则表达式匹配 (Regular Expression Match)

规则: server_name 指令以 ~ 开头，后面跟正则表达式。
优先级: 最低。
示例:
nginx复制代码
server { listen 80; server_name ~^www\d+\.example\.com$; # 匹配 www1.example.com, www2.example.com, www123.example.com 等 # ... } server { listen 80; server_name ~^(?.+)\.example\.net$; # 使用命名捕获组 # ... }

~^www\d+\.example\.com$: 这个正则表达式匹配以 www 开头，后面跟着一个或多个数字，然后是 .example.com 的域名。
~^(?.+)\.example\.net$: 这个正则表达式使用了命名捕获组 (?.+)，可以将匹配到的子域名部分提取出来，在 server 块内部可以使用 $subdomain 变量引用。

正则表达式匹配的注意事项:

匹配优先级顺序总结 (从高到低):

default_server 指令

如果没有任何 server_name 匹配到请求的 Host 头，Nginx 会使用 默认服务器 (default server) 来处理请求。

如何设置默认服务器: 在 listen 指令中添加 default_server 参数。
nginx复制代码
server { listen 80 default_server; # 设置为默认服务器 server_name _; # 可以使用 _ 或其他无效域名作为 server_name，表示不匹配任何域名 # ... }
默认服务器的选择:如果在 listen 指令中显式指定了 default_server，则该 server 块成为默认服务器。如果没有显式指定 default_server，则 配置文件中第一个 监听相同端口和协议的 server 块会被作为默认服务器。

最佳实践和建议:

优先使用精确匹配: 对于已知的域名，尽量使用精确匹配，以提高性能和匹配效率。
合理使用通配符: 对于子域名较多的情况，可以使用通配符简化配置。
谨慎使用正则表达式: 正则表达式匹配性能较低，只在必要时使用，并尽量写高效的正则表达式。
明确设置 default_server: 建议显式设置 default_server，避免意外的默认服务器选择，并可以用于处理未匹配到任何 server_name 的请求，例如返回错误页面或重定向。
避免 server_name 重叠: 尽量避免 server_name 配置出现重叠，导致匹配规则混乱。可以使用 nginx -t 命令检查配置文件是否有语法错误和潜在的配置问题。
测试配置: 修改 server_name 配置后，务必使用 nginx -t 命令测试配置是否正确，并重启或重新加载 Nginx 服务。