必须用 alias 而非 root，因 alias 精准替换路径前缀（如 /admin/ → 剥离后拼接），适配 Vue 子应用非根部署；root 是简单拼接，易致资源 404。
部署 Vue 项目时用 alias 映射多个静态资源目录，核心是让不同 URL 路径精准指向各自物理目录，互不干扰，尤其适合一个 Nginx 实例托管管理后台、用户前台、文档中心等多子应用的场景。关键不在“多”，而在“映射干净”——每个 location 独立生效，路径前缀被完整剥离，资源定位不依赖 URL 层级。
为什么必须用 alias，而不是 root？
root 是拼接：配置 root /var/www + 请求 /admin/js/app.js → 实际找 /var/www/admin/js/app.js。
alias 是替换：配置 location /admin/ { alias /var/www/admin/; } + 同样请求 → 实际找 /var/www/admin/js/app.js（/admin/ 被完全去掉，再拼剩余路径）。
这对 Vue 子应用至关重要：打包后资源路径基于 publicPath，若部署在 /admin/ 下，用 root 会导致资源路径多套一层前缀，极易 404；而 alias 天然适配非根路径部署。
基础多目录映射配置示例
假设三个 Vue 项目构建产物分别放在：
立即学习“前端免费学习笔记（深入）”；
vue-admin-change-reviewer
下载
审查 Vue 管理后台的变更请求（Vue 2 + Element UI，Vue 3 + Element Plus）。重点关注最小化变更实现、上线风险检查以及回归检查清单生成。
- 管理后台：
/var/www/admin/→ 访问地址https://example.com/admin/ - 用户前台：
/var/www/web/→ 访问地址https://example.com/ - API 文档：
/opt/swagger-ui/→ 访问地址https://example.com/api/v1/docs/
对应 Nginx 配置：
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;
}
注意点：
-
alias值末尾必须带/，location匹配路径也建议以/结尾，否则可能截断错误 -
try_files的 fallback 必须含前缀（如/admin/index.html），因为 Vue Router history 模式需要该上下文下的入口文件 - 主站用
root更稳妥；子路径类 SPA 用alias更清晰
处理公共资源跨目录复用
图标、字体、配置文件等常需多个子应用共用，可单独挂载统一资源池：
- 把公共图标放在
/mnt/shared/assets/icons/ - 在 Nginx 中新增映射：
location /assets/icons/ { alias /mnt/shared/assets/icons/; } - Vue 项目中引用
/assets/icons/logo.png，Nginx 直接从独立磁盘读取，不走任何子应用目录
这种写法真正实现跨文件系统访问，且与 root 设置完全解耦。配合权限检查（确保 nginx worker 用户对 /mnt/shared/ 有 r-x 权限），即可安全复用。
常见报错排查要点
实际部署中最常遇到的问题集中在路径和权限层面：
-
404 找不到 index.html：确认
/var/www/admin/index.html文件真实存在，且try_files写的是/admin/index.html（不是/index.html） -
403 Forbidden：执行
docker exec -it <nginx> ls -ld /var/www/admin，检查目录是否可被 nginx worker 用户（如www-data）进入（需x权限）和读取（需r） -
资源路径错乱：检查 Vue 项目的
vue.config.js中publicPath是否与 Nginx 的 location 前缀一致（如部署在/admin/，则publicPath: '/admin/'） -
正则 location 不支持 alias 变量捕获：避免写
location ~ ^/static/(.*)$ { alias /data/$1; }，应改用root或配合rewrite
