nginx 中用 alias 映射非标准路径静态资源，核心是前缀替换：location 匹配部分被完全移除，剩余路径拼接至 alias 目录；必须严格匹配斜杠规则，否则导致 404；配合 try_files 可支持 spa 非根路径部署，并建议禁用 autoindex、拦截 ../ 路径遍历以加固安全。
用 alias 映射非标准路径下的静态资源，关键在于“前缀替换”逻辑——它不拼接 URL 全路径，而是把 location 匹配的部分整个砍掉，再把剩余路径拼到 alias 指定的目录后。这让你能自由挂载任意物理位置的资源，比如挂载在 /mnt/nas/、/opt/assets/ 或跨分区目录，完全不受网站根目录限制。
必须严格匹配斜杠规则
这是最容易出 404 的地方：斜杠不是风格问题，是路径计算开关。
- 如果
location以/结尾（如location /admin/ { ... }），那么alias值末尾也必须带/（如alias /var/www/admin-build/;） - 若
alias少了尾部/，Nginx 会把剩余路径直接粘在 alias 值末尾，例如请求/admin/js/app.js可能变成/var/www/admin-buildjs/app.js，直接 404 - 反过来，
location /admin（无尾斜杠）配alias /var/www/admin-build/（有尾斜杠），访问/admin/时会生成双斜杠//，多数系统拒绝解析
多个子应用或资源库独立挂载
不同构建产物放在不同物理路径？不用挪文件、不改结构，每个 location 单独配 alias 即可：
location /admin/ { alias /opt/apps/admin/dist/; try_files $uri $uri/ /admin/index.html; }location /docs/ { alias /srv/docs/v2.1/; }location /assets/icons/ { alias /mnt/shared/icons/; }
它们彼此隔离，互不影响，也不依赖共同父目录，真正实现跨路径、跨挂载点整合。
配合 try_files 防止 SPA 路由 404
Vue/React 等单页应用部署在非根路径（如 /admin/）时，前端路由会触发非真实文件路径请求。仅靠 alias 不够，必须加兜底：
-
try_files $uri $uri/ /admin/index.html;—— 注意 fallback 路径要带原始 location 前缀（这里是/admin/index.html），否则 Nginx 找不到入口文件 - 不能写成
/index.html，那会去 root 下找，和 alias 目录无关
安全加固建议
映射非标准路径时，顺便堵住常见风险：
- 禁用自动索引：
autoindex off; - 拦截路径遍历：
if ($request_uri ~ "\.\./") { return 403; }或更稳妥地用try_files $uri =404;兜底 - 关闭符号链接检查（可选）：
disable_symlinks on;，防止绕过目录限制 - 避免用
root替代alias，因为root会保留 location 前缀拼接，天然存在遍历隐患
