root是拼接（完整URI追加到目录后），要求磁盘存在对应子路径；alias是替换（剥离location前缀后拼接剩余URI），不依赖磁盘层级结构，且alias值末尾必须加/。
配置 root 和 alias 实现静态资源路径精准映射，核心在于理解“拼接”和“替换”的本质差异，并严格匹配 URL 结构与磁盘布局。用错指令，404 就在所难免；路径末尾斜杠、location 写法、try_files 回退路径，每一处细节都影响实际访问效果。
root 适用场景：整站托管或路径结构一致
root 把请求的完整 URI（含 location 前缀）直接拼到指定目录后。它要求磁盘上存在与 URL 层级完全对应的子目录。
- 例如：location /admin/ { root /var/www/html; } → 请求
/admin/js/app.js会查找/var/www/html/admin/js/app.js - root 值末尾加不加
/都可，Nginx 会自动处理，但建议统一写为/var/www/html/避免歧义 - 适合 Vue/React 构建产物整个 dist 目录作为站点根部署，比如主站
location / { root /var/www/web; } - 注意：若磁盘中没有
/var/www/html/admin/这个子目录，就会 404 —— root 不跳过 location 前缀，它依赖真实路径层级
alias 适用场景：子路径映射或路径剥离
alias 会把 location 匹配的部分彻底去掉，只把剩余 URI 拼到目标路径后。它不要求磁盘上有对应前缀目录，是真正的“URL 到物理路径”的映射。
- 例如：location /admin/ { alias /var/www/admin/; } → 请求
/admin/js/app.js查找的是/var/www/admin/js/app.js（/admin/被完全剥离） -
alias 值末尾必须带
/，否则 Nginx 会错误拼接成/var/www/adminjs/app.js - location 也建议以
/结尾（如/admin/），避免正则匹配或路径截断问题 - 典型用途：Vue 子应用部署在非根路径（如
/admin/）、Swagger UI 挂载（/api/v1/docs/ → /opt/swagger-ui/）、公共资源统一挂载（/assets/icons/ → /mnt/shared/icons/）
关键配置细节与避坑点
实际配置中，几个看似微小的写法差异会直接导致服务异常：
- 不能混用 root 和 alias：同一 location 块内二者互斥，Nginx 启动会报错
-
try_files 的 fallback 要带前缀：使用 alias 时，
try_files $uri $uri/ /admin/index.html;中的/admin/index.html必须包含 location 前缀，否则 Vue Router history 模式无法回退到正确入口 -
正则 location 中慎用 alias：旧版 Nginx 不支持，新版虽可配合命名捕获（如
location ~ ^/static/(?<type>css|js)/(.*)$ { alias /data/assets/$type/$2; }），但稳定性不如普通 location，生产环境优先用明确路径 -
权限与 SELinux：若静态资源在外部磁盘（如
/mnt/static/），需确保 Nginx 用户有读取权限，并在 CentOS/RHEL 上检查 SELinux 策略（setsebool -P httpd_read_user_content 1）
多子应用共存的典型配置示例
一个 Nginx 实例托管管理后台、用户前台、API 文档三个 Vue 应用：
-
管理后台：部署在
/admin/，构建产物在/var/www/admin/→ 必须用alias -
用户前台：部署在根路径
/，构建产物在/var/www/web/→ 推荐用root -
API 文档：部署在
/api/v1/docs/，静态文件在/opt/swagger-ui/→ 必须用alias
对应配置片段：
location /admin/ {
alias /var/www/admin/;
try_files $uri $uri/ /admin/index.html;
}
location / {
root /var/www/web;
try_files $uri $uri/ /index.html;
}
location /api/v1/docs/ {
alias /opt/swagger-ui/;
try_files $uri $uri/ /index.html;
}
这种写法让每个子应用路径干净独立，互不干扰，也不暴露真实磁盘结构。
