在 linux 中，nginx 的 alias 指令用于将请求 uri 映射到文件系统上的任意绝对路径或相对路径，从而实现非标准磁盘路径（如挂载点、自定义目录）的文件访问。核心做法是在 location 块中使用 alias 指定目标目录，并确保 nginx 运行用户对该路径具有读取权限。
如何配置 alias 以指向特定挂载点
当需要将 URL 路径映射到特定的磁盘挂载点时，只需在 location 块中设置 alias 为该挂载点的绝对路径即可。例如，若有一个数据盘挂载在 /mnt/data，希望用户通过 /files/ 访问其中的内容，配置如下：
server {
listen 80;
server_name example.com;
location /files/ {
alias /mnt/data/files/;
}
}
上述配置中，当请求 /files/image.jpg 时，Nginx 会尝试读取 /mnt/data/files/image.jpg。注意 alias 的值必须以斜杠结尾，且必须是一个完整的绝对路径。如果路径不存在或权限不足，Nginx 将返回 403 或 404 错误。
alias 与 root 在处理路径时的区别是什么
root 和 alias 的主要区别在于它们如何处理 URI 与文件系统的拼接逻辑。root 是将 location 的路径直接追加到 root 指定的根目录下，而 alias 则是用 alias 指定的路径完全替换 location 匹配的部分。对于非标准路径，alias 更灵活，因为它允许 URI 结构与物理目录结构不一致。
server {
listen 80;
server_name example.com;
# 使用 root：/var/www/html + /images/ -> /var/www/html/images/
location /images/ {
root /var/www/html;
}
# 使用 alias：/static/ 被替换为 /opt/assets/ -> /opt/assets/
location /static/ {
alias /opt/assets/;
}
}
在上述示例中，请求 /images/photo.png 会查找 /var/www/html/images/photo.png，而请求 /static/logo.png 会查找 /opt/assets/logo.png。如果使用 root 来模拟 alias 的行为，需要调整 root 的路径结构，这通常不如 alias 直观。因此，在非标准路径映射中，推荐优先使用 alias。
alias 映射后出现 404 或 403 错误如何解决
当配置完 alias 后，常见的错误是 404 Not Found 或 403 Forbidden。404 通常是因为路径拼接错误或文件不存在，而 403 则是因为权限问题。解决步骤包括检查路径是否存在、确认 Nginx 用户（通常是 www-data 或 nginx）是否有读取权限，以及确保路径末尾有斜杠。
# 检查路径是否存在 ls -l /mnt/data/files/ # 检查权限 sudo chown -R www-data:www-data /mnt/data/files/ sudo chmod -R 755 /mnt/data/files/ # 验证 Nginx 配置 sudo nginx -t sudo systemctl reload nginx
此外，还需注意 SELinux 或 AppArmor 等安全模块是否阻止了 Nginx 访问非标准路径。可以使用 auditd 或 dmesg 查看是否有相关拒绝日志。如果使用了符号链接，确保 follow_symlinks 已启用或路径本身是真实目录。
