alias指令用于完全替换location匹配的uri路径段，而非拼接；例如location /static/ { alias /var/www/assets/; }时，/static/js/app.js对应文件为/var/www/assets/js/app.js。
Alias 指令用于将 URL 路径映射到服务器上的实际文件系统路径，和 root 不同，它不拼接 location 后缀，而是直接替换整个匹配部分。
Alias 的基本用法
Alias 必须写在 location 块中，且只对当前 location 生效。它的值是绝对路径或相对于 nginx 配置文件所在目录的相对路径（推荐用绝对路径）。
- location 匹配的 URI 会被完全替换为 alias 指定的路径，不保留原 URI 的尾部
- 例如：location /static/ { alias /var/www/assets/; }，访问 /static/js/app.js 实际读取的是 /var/www/assets/js/app.js
- 注意末尾斜杠：location 和 alias 的结尾斜杠必须逻辑一致，否则容易 404
常见配置示例
以下几种典型场景要注意路径对应关系：
- 映射子目录：
location /images/ { alias /data/pics/; }→ /images/logo.png → /data/pics/logo.png - 映射到根目录下某个目录：
location /admin { alias /opt/webapp/dashboard; }→ /admin/index.html → /opt/webapp/dashboard/index.html（注意这里没有尾部斜杠，所以 /admin 不等价于 /admin/） - 避免混淆：不要把 alias 和 root 混用；root 是拼接，alias 是替换
Alias 和 root 的关键区别
理解差异能避免 404 或权限错误：
- root：/var/www；location /img/ { root /var/www; } → 请求 /img/a.jpg → 文件路径是 /var/www/img/a.jpg
- alias：location /img/ { alias /var/www/static/; } → 请求 /img/a.jpg → 文件路径是 /var/www/static/a.jpg（/img/ 被整个替换成 /var/www/static/）
- alias 不支持正则 location 的捕获变量（$1 等），如需动态映射，改用 rewrite + root 或 try_files
调试与注意事项
配置后务必验证路径是否准确：
- 确保 alias 指向的目录存在，且 nginx 工作进程（如 www-data）有读取权限
- 检查 nginx -t 测试语法，reload 后用 curl -I 查看响应头或返回内容确认是否命中目标文件
- 如果页面显示 404 但路径看似正确，重点检查 location 正则是否贪婪匹配、alias 末尾斜杠是否遗漏、SELinux 或 AppArmor 是否拦截
