nginx location配置详解

小蓝 • 2024-12-12 12:56 • 编程

一、基本概念

nginx是一款高性能的Web服务器软件，其location指令是nginx的一个重要配置项。location指令用于匹配请求URI，从而决定由哪个代码块（指令块）处理该请求。nginx的location指令支持多种匹配方式，本节将详细介绍location指令的基本概念。

location [=|~|~*|^~] uri { ... }

上面是location指令的基本语法，其中uri是用来匹配请求URI的。location指令还可以使用修饰符来改变uri的匹配方式：

“=”完全匹配uri
“~”区分大小写的正则表达式匹配
“~*”不区分大小写的正则表达式匹配
“^~”普通字符匹配

二、基本使用方法

在nginx中，location指令通常和proxy_pass或fastcgi_pass等指令结合使用。下面是一个简单的location配置示例：

server {
    listen       80;
    server_name  localhost;

    location / {
        root   /usr/share/nginx/html;
        index  index.html;
    }
}

以上配置表示，当请求的URI以“/”开头时，nginx会先去查找/usr/share/nginx/html目录下是否存在对应的文件，如果存在则返回该文件，否则将请求转发给upstream服务器处理。

三、正则表达式匹配

nginx的location指令还支持正则表达式匹配。正则表达式匹配比普通字符匹配更加灵活，可以处理更为复杂的URL。

1. 区分大小写的正则表达式匹配

location ~ /user/(.*)\.html$ {
    root   /data/www;
    index  index.html;
    try_files $uri /index.html;
}

上面的示例表示，以/user/开头，以.html结尾的URI请求会被该配置块处理。例如，/user/123.html、/user/xiaoming.html等请求都会被该配置块处理。

2. 不区分大小写的正则表达式匹配

location ~* \.(jpg|jpeg|png|gif|ico)$ {
    root   /data/www;
    index  index.html;
    expires 30d;
}

该示例表示，以.jpg、.jpeg、.png、.gif或.ico结尾的URI请求都会被该配置块处理。并且在返回文件时设置了30天的过期时间。

四、修饰符

nginx的location指令还支持修饰符，可以改变uri的匹配方式。

1. = 完全匹配

location = /login.html {
    root   /usr/share/nginx/html;
    index  index.html;
}

以上配置表示，仅当请求URI为“/login.html”时，该配置块才会处理该请求。

2. ^~ 普通字符匹配

location ^~ /user/ {
    root   /data/www;
    index  index.html;
}

上述示例表示，当请求URI以“/user/”开头时，nginx不会再尝试使用正则匹配，而是直接选择该配置块来处理该请求。

五、高级用法

location指令还支持更高级的用法，如使用if指令、deny/allow指令等进行更为精细的控制。

1. if指令使用

location /user/ {
    if ($arg_id = 123) {
        rewrite ^/(.*)$ /index.html last;
        break;
    }

    if ($http_cookie ~* "userid=([^;]+)(?:;|$)") {
        set $userid $1;
    }

    root /data/www;
    index index.html;
}

在上述示例中，if指令用于根据请求参数和cookie信息等进行不同的处理操作。

2. deny/allow指令使用

location /admin/ {
    allow 192.168.1.0/24;
    allow 10.0.0.0/8;
    allow 172.16.0.0/12;
    deny all;

    root /data/secret;
    index index.html;
}

上述示例中，deny/allow指令用于控制仅允许特定IP地址访问该目录下的文件。

六、总结

本文对nginx的location指令进行了详细的阐述和解析，从基本概念、正则表达式匹配、修饰符、高级用法等多个方面进行了介绍。通过本文，读者可以更加深入地理解nginx的location指令，并在实际应用中灵活运用。

原创文章，作者：小蓝，如若转载，请注明出处：https://www.506064.com/n/243516.html