在 nginx 中，`root` 指令的继承遵循“就近原则”，即 `server` 块中的配置会覆盖 `http` 块中的同名配置。如果 `server` 块未定义 `root`，则直接继承 `http` 块的值；若两者都定义了，则以 `server` 块为准。这种层级关系确保了全局默认路径与特定虚拟主机路径的灵活切换。
当 server 块省略 root 时如何继承
当 `server` 块中没有显式声明 `root` 指令时，Nginx 会向上查找并继承 `http` 块中定义的 `root` 路径。这意味着所有位于该 `http` 块下的、未单独配置 `root` 的 `server` 块都将共享同一个文档根目录。这种设置适用于多个域名指向同一套静态资源文件的场景，减少了重复配置。
worker_processes 1;
events {
worker_connections 1024;
}
http {
include mime.types;
default_type application/octet-stream;
# http 块中定义全局 root
root /var/www/html;
server {
listen 80;
server_name example.com;
# 此处未定义 root，继承上方的 /var/www/html
location / {
index index.html;
}
}
}
在上述配置中，访问 `example.com` 时，Nginx 会在 `/var/www/html` 目录下寻找文件。如果在该目录下存在 `index.html`，则正常返回；否则根据错误处理逻辑返回 404 或其他错误。这种继承机制简化了多站点共用资源的配置管理。
当 server 块定义 root 时的覆盖行为
如果在 `server` 块中显式指定了 `root` 指令，则该值将完全覆盖从 `http` 块继承的路径。此时，该 `server` 块内的所有请求都将基于新的 `root` 路径进行解析，而不会影响其他未定义 `root` 的 `server` 块。这种覆盖行为允许为不同域名提供完全不同的内容结构。
worker_processes 1;
events {
worker_connections 1024;
}
http {
include mime.types;
default_type application/octet-stream;
root /var/www/global;
server {
listen 80;
server_name site-a.com;
# 覆盖 http 块的 root
root /var/www/site-a;
location / {
index index.html;
}
}
server {
listen 80;
server_name site-b.com;
# 未定义 root，继承 http 块的 /var/www/global
location / {
index index.html;
}
}
}
在此配置下，访问 `site-a.com` 时，Nginx 会在 `/var/www/site-a` 目录下查找文件；而访问 `site-b.com` 时，则会使用 `/var/www/global` 目录。这种差异化的路径配置通过 `root` 指令的覆盖特性实现，确保了不同站点内容的隔离性。
location 块中 root 对 server 层级的影响
在 `location` 块中也可以定义 `root` 指令，其优先级高于 `server` 和 `http` 块。当 `location` 块内定义了 `root` 时，该路径仅对该 `location` 匹配的请求生效，而不影响同 `server` 块内其他 `location` 或外层配置。这种细粒度的控制允许针对特定 URL 路径提供不同的物理目录映射。
server {
listen 80;
server_name example.com;
root /var/www/main;
location /api {
# 仅对 /api 开头的请求生效
root /var/www/api;
}
location / {
# 继承 server 层的 /var/www/main
index index.html;
}
}
当请求路径以 `/api` 开头时，Nginx 会在 `/var/www/api` 目录下查找对应文件；而对于其他路径，则继续使用 `/var/www/main`。这种嵌套覆盖机制提供了极高的配置灵活性，但需注意避免路径冲突导致的意外行为。例如，若 `/api` 目录下不存在请求的文件，Nginx 不会回退到 `server` 层的 `root`，而是直接返回错误。
