Nginx虚拟主机实战：利用alias指令解决虚拟目录路径映射-Nginx-PHP中文网

alias指令用于完全替换location匹配的URL路径段，将剩余部分拼接到指定绝对路径；如location /static/ { alias /data/assets/; }时，/static/js/app.js对应文件系统/data/assets/js/app.js。

nginx虚拟主机实战：利用alias指令解决虚拟目录路径映射

在 Nginx 中，alias 指令是实现虚拟目录路径映射的关键工具，特别适用于将 URL 路径指向服务器上非根目录的任意物理位置。它和 root 容易混淆，但行为本质不同：前者会**完全替换匹配的 location 路径段**，后者只是拼接路径。用错会导致 404 或权限错误。

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 严格匹配路径层级）。

常见错误是把 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 默认把用户上传文件存到 storage/app/public/，需通过 php artisan storage:link 创建软链到 public/storage。但有时想绕过 public 目录直接暴露存储路径，可借助 alias：

location /uploads/ {
    alias /var/www/myapp/storage/app/public/;
    expires 1h;
    add_header Cache-Control "public, immutable";
}

这样访问 https://example.com/uploads/avatar.png 就能直接返回对应文件，无需走 PHP 脚本，提升性能又安全。