Nginx 文件路径加载配置指南

Nginx 加载文件路径主要通过 root 和 alias 指令来实现。以下是详细的配置方法和区别：

1. root 指令

root 指令会将请求的 URI 附加到指定的路径后面：

server {
    listen 80;
    server_name example.com;

    # 对于请求 /images/logo.png，Nginx会查找 /var/www/example.com/images/logo.png
    location /images/ {
        root /var/www/example.com;
    }
}

2. alias 指令

alias 指令会用指定的路径替换匹配的 URI 部分：

server {
    listen 80;
    server_name example.com;

    # 对于请求 /static/logo.png，Nginx会查找 /var/www/assets/logo.png
    location /static/ {
        alias /var/www/assets/;
    }
}

重要区别

常见配置示例

1. 静态文件服务

server {
    location /static/ {
        alias /path/to/your/static/files/;
        expires 30d;
        access_log off;
    }
}

2. 多个目录映射

server {
    location /images/ {
        root /var/www/media;
    }

    location /downloads/ {
        alias /opt/shared/files/;
    }
}

3. 单页应用配置

server {
    root /var/www/app/dist;

    location / {
        try_files $uri $uri/ /index.html;
    }
}

注意事项

1. 路径末尾斜线：

   • alias 指令必须包含结尾斜线
   • root 指令可省略

2. 权限问题：

   • 确保 Nginx 用户(通常是 www-data 或 nginx)有读取权限
   • 检查 SELinux 或 AppArmor 限制(如有)

3. 符号链接：

   • 默认情况下 Nginx 会跟随符号链接
   • 使用 disable_symlinks 指令可以禁用

4. 性能优化：

   • 对大文件使用 sendfile on
   • 考虑启用 gzip 压缩

5. 错误排查：

   • 检查 Nginx 错误日志 /var/log/nginx/error.log
   • 使用 nginx -t 测试配置语法

希望这些信息能帮助你正确配置 Nginx 的文件路径加载。如果有特定场景需要帮助，请提供更多细节。