Nginx Location 配置从零开始指南

1. Location 基础概念

Location 是 Nginx 配置中用于匹配请求 URI 并定义如何处理这些请求的指令块。它允许你根据 URL 路径的不同来应用不同的处理规则。

2. Location 语法结构

基本语法格式：

location [修饰符] 匹配模式 {
    # 配置指令
}

3. Location 匹配类型

3.1 精确匹配 (=)

location = /exact-path {
    # 仅匹配 /exact-path
}

3.2 前缀匹配 (无修饰符)

location /prefix {
    # 匹配以 /prefix 开头的所有路径
}

3.3 正则匹配 (~, ~*, !~, !~*)

location ~ \.php$ {
    # 区分大小写的正则匹配.php结尾的路径
}

location ~* \.(jpg|jpeg|png)$ {
    # 不区分大小写的正则匹配图片文件
}

3.4 最长前缀匹配 (^~)

location ^~ /images {
    # 匹配以/images开头的最长路径，不检查正则表达式
}

4. Location 匹配优先级

Nginx 按以下顺序评估 location 块： 1. 精确匹配 (=) 2. 最长非正则前缀匹配 (^~) 3. 正则匹配 (~, ~*) 4. 普通前缀匹配

5. 基本配置示例

5.1 静态文件服务

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

5.2 PHP 处理

location ~ \.php$ {
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_index index.php;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}

5.3 重定向配置

location /old-path {
    return 301 /new-path;
}

6. 高级配置技巧

6.1 嵌套 Location

location /user {
    # 用户相关通用配置

    location /user/profile {
        # 用户个人资料特定配置
    }
}

6.2 变量使用

location /download {
    if ($args ~* "file=(.*)") {
        set $filename $1;
        rewrite ^ /files/$filename? break;
    }
}

6.3 错误页面处理

location / {
    error_page 404 /custom_404.html;
    error_page 500 502 503 504 /custom_50x.html;
}

7. 调试与测试

7.1 测试配置语法

nginx -t

7.2 重载配置

nginx -s reload

7.3 调试日志

location /debug {
    access_log /var/log/nginx/debug.log debug;
    # 其他配置
}

8. 最佳实践

1. 将静态内容和动态内容分开处理
2. 为频繁访问的资源设置适当的缓存头
3. 使用精确匹配提高性能
4. 避免在 location 块中使用过多的 if 语句
5. 对敏感路径实施访问控制

通过以上步骤，你可以从零开始构建 Nginx 的 location 配置，根据实际需求灵活地处理各种 URL 请求。