在 nginx 中设置泛域名通配符,需要在 server_name 指令中使用前导星号(*.)或后导星号(*.)来匹配任意子域名。这种配置允许一个 server 块处理所有形如 *.example.com 的请求,适用于多租户 saas 或动态子域名解析场景。

如何配置前导通配符以捕获所有子域名
使用 *.example.com 可以匹配 a.example.com、b.example.com 等任意一级子域名,但不匹配 example.com 本身。这是最常见的泛域名用法。

server {
listen 80;
server_name *.example.com;
location / {
# 根据 $host 变量动态处理请求
root /var/www/html/$host;
index index.html;
}
}
上述配置中,当用户访问 user1.example.com 时,Nginx 会尝试从 /var/www/html/user1.example.com 目录提供内容。注意,server_name 中的通配符不会自动创建文件系统路径,需要应用层逻辑配合。
如何处理主域名与通配域名的冲突
如果同时存在 example.com 和 *.example.com,Nginx 优先匹配精确名称。因此,必须显式定义一个专门处理 example.com 的 server 块,否则未指定主域名的请求可能落入通配符块或默认块。

# 精确匹配主域名
server {
listen 80;
server_name example.com www.example.com;
root /var/www/main-site;
}
# 通配符匹配子域名
server {
listen 80;
server_name *.example.com;
root /var/www/subdomains;
}
在此结构中,访问 example.com 命中第一个块,而 app.example.com 命中第二个块。若省略第一个块,example.com 将不会被 *.example.com 匹配,因为前导通配符不覆盖裸域名。
$host 变量在通配域名下的具体行为是什么
在泛域名配置的 server 块中,$host 变量始终保留原始请求头中的完整主机名,包括子域名部分。例如,请求 tenant-a.example.com 时,$host 的值为 tenant-a.example.com,而非仅 example.com。这一特性使得基于子域名的路由或资源隔离成为可能。











