alias指令用于完全替换location匹配的URL路径段，将剩余部分拼接到指定绝对路径；如location /static/ { alias /data/assets/; }时，/static/js/app.js对应文件系统/data/assets/js/app.js。
在 Nginx 中，alias 指令是实现虚拟目录路径映射的关键工具，特别适用于将 URL 路径指向服务器上非根目录的任意物理位置。它和 root 容易混淆，但行为本质不同：前者会**完全替换匹配的 location 路径段**，后者只是拼接路径。用错会导致 404 或权限错误。
alias 的核心行为：路径替换而非拼接
alias 的作用是把 location 匹配到的 URI 前缀“去掉”，再把剩余部分拼接到指定的本地路径后。关键点在于：location 中的路径会被完整截断。
例如：
-
location /static/ { alias /data/assets/; }
访问/static/js/app.js→ 实际读取/data/assets/js/app.js -
location /api/ { alias /opt/backend/dist/; }
访问/api/index.html→ 实际读取/opt/backend/dist/index.html
注意：location 末尾的 / 必须与 alias 路径末尾的 / 保持一致，否则可能触发 404（Nginx 严格匹配路径层级）。
alias vs root：一个典型误用场景
常见错误是把 root 当作 alias 用：
-
location /media/ { root /var/www/uploads; }
访问/media/photo.jpg→ 尝试读取/var/www/uploads/media/photo.jpg（多了一层media） -
location /media/ { alias /var/www/uploads/; }
访问/media/photo.jpg→ 正确读取/var/www/uploads/photo.jpg
简单判断法：如果希望 URL 路径不体现在文件系统路径中，就用 alias；如果希望保留前缀结构，就用 root。
实战：为 Laravel 项目配置上传资源虚拟目录
Laravel 默认把用户上传文件存到 storage/app/public/，需通过 php artisan storage:link 创建软链到 public/storage。但有时想绕过 public 目录直接暴露存储路径，可借助 alias：
- 确保
/var/www/myapp/storage/app/public存在且有读取权限 - 在 server 块中添加：
location /uploads/ {
alias /var/www/myapp/storage/app/public/;
expires 1h;
add_header Cache-Control "public, immutable";
}
这样访问 https://example.com/uploads/avatar.png 就能直接返回对应文件，无需走 PHP 脚本，提升性能又安全。
注意事项与排错要点
-
alias后的路径必须是绝对路径（以/开头），相对路径会引发 500 错误 - location 使用正则表达式时，
alias不支持变量捕获（如$1），应改用rewrite + root组合 - 若出现 403，检查目标目录的执行权限（
x权限对 Nginx 用户必需） - 修改后务必运行
nginx -t校验语法，再nginx -s reload生效
