Nginx 的 root 指令不支持动态匹配子域名，但可通过 server_name + map + root 组合实现多级子域名到目录的自动映射，核心是将子域名按点分隔、反转并转为路径。
在 Nginx 中，root 指令本身**不支持自动解析或动态匹配子域名层级**，它只接受静态路径。但你可以通过 server_name + map + root（或 alias）组合，实现“多级子域名到对应目录”的自动映射效果，例如：
-
blog.example.com→/var/www/example/blog -
api.v2.dev.example.com→/var/www/example/api/v2/dev -
admin.test.staging.example.com→/var/www/example/admin/test/staging
核心思路是：把子域名部分（去掉主域名）按点分隔，反转顺序后拼成路径片段，再映射到文件系统。
1. 提取并处理子域名（用 map 指令）
Nginx 的 map 模块可将 server_name 动态转换为变量。先在 http 块中定义映射逻辑：
http {
# 提取子域名（不含 example.com），并转为路径格式
map $host $subpath {
~^(?<sub>[^.]+\.)*example\.com$ $sub;
default "";
}
<pre class="brush:php;toolbar:false;"># 将子域名（如 "api.v2.dev."）中的点替换为 "/"，并去掉末尾点
map $subpath $docroot_path {
"~^(.+)\.$" /$1;
default "";
}
# 组合成完整 root 路径（假设主站根目录为 /var/www/example）
map $docroot_path $dynamic_root {
"~^/(.+)$" /var/www/example/$1;
default /var/www/example;
}
}
⚠️ 注意：map 不支持嵌套正则捕获重用，所以上面用了两个 map 链式处理。更健壮的做法是用一个 map 处理完整逻辑（见下条）。
2. 推荐写法：单次正则提取 + 路径拼接
更简洁可靠的方式（兼容多级子域）：
http {
map $host $dynamic_root {
# 匹配形如 *.example.com，捕获前面所有部分（含点），然后全局替换 . → /
~^(?<sub>.+)\.example\.com$ /var/www/example${sub//./\/};
# 如果是 example.com 本身，指向默认目录
~^example\.com$ /var/www/example;
default /var/www/example;
}
}</sub>
✅ 这里利用了 Nginx 1.19.0+ 支持的变量字符串替换语法 ${var//old/new}（全局替换）。若版本较旧（map 分步替换，或改用 Lua 模块（OpenResty）。
3. 在 server 块中使用动态 root
在 server 块中直接引用变量即可：
server {
listen 80;
server_name ~^(?:.+\.)*example\.com$;
<pre class="brush:php;toolbar:false;"># 启用动态 root
root $dynamic_root;
location / {
try_files $uri $uri/ /index.html;
}
# 可选：记录实际解析路径，便于调试
error_log /var/log/nginx/dynamic-root.log notice;
log_format dynamic "$host → root: $dynamic_root";
access_log /var/log/nginx/dynamic-access.log dynamic;
}
? 关键点：
-
server_name必须用正则匹配所有可能子域，如~^(?:.+\.)*example\.com$ -
root后直接跟变量（$dynamic_root），Nginx 会在每次请求时求值 - 确保目标目录存在且 Nginx 用户有读取权限（如
www-data或nginx） - 避免路径遍历风险：确认
$host来源可信（反向代理场景建议校验Host头）
4. 替代方案：用 alias + rewrite（适合固定层级）
如果子域层级固定（如统一二级：xxx.example.com），也可用 rewrite + alias，但灵活性不如 map：
server {
server_name ~^([^.]+)\.example\.com$;
location / {
alias /var/www/example/$1/;
try_files $uri $uri/ =404;
}
}
⚠️ 注意：alias 和 root 行为不同——alias 会**完全替换 location 路径**，而 root 是拼接。此处用 alias 更安全，避免意外暴露上级目录。
不复杂但容易忽略：测试前务必 nginx -t 校验配置，并用 curl -H "Host: api.v2.dev.example.com" http://127.0.0.1 模拟请求验证路径是否正确解析。
