目录

一、location 块的基本概念

二、location 块的语法

三、location 块的匹配方式

四、location 块的优先级

五、location 块的应用场景

六、location 块的嵌套

七、location 块的指令

八、示例配置

Nginx 是一个高性能的 Web 服务器和反向代理服务器，它广泛用于托管网站、服务 API 和负载均衡。在 Nginx 的配置中，<code>location 块是一个非常重要的概念，它允许你根据请求的 URI（统一资源标识符）来匹配和处理客户端请求。

一、location 块的基本概念

location 块用于在 Nginx 配置文件中定义一个位置匹配规则。当客户端发送请求时，Nginx 会根据请求的 URI 来匹配 location 块，并执行相应的处理指令。location 块可以嵌套在 server 块中，也可以嵌套在其他 location 块中。

二、location 块的语法

location 块的基本语法如下：

location [修饰符] <匹配模式> {

# 处理指令

}

修饰符：可选的修饰符，用于指定匹配方式，如 =（精确匹配）、~（区分大小写的正则表达式匹配）、~*（不区分大小写的正则表达式匹配）等。匹配模式：用于匹配请求 URI 的字符串或正则表达式。

三、location 块的匹配方式

Nginx 支持多种 URI 匹配方式：

前缀匹配：默认的匹配方式，不带修饰符，匹配 URI 的前缀。

location /api {

# 处理 /api 及其子路径的请求

}

精确匹配：使用 = 修饰符，仅当请求 URI 与指定字符串完全相等时匹配。

location = / {

# 仅处理根路径 / 的请求

}

正则表达式匹配：使用 ~ 或 ~* 修饰符，分别表示区分大小写和不区分大小写的正则表达式匹配。

location ~* \.(jpg|png|gif)$ {

# 处理所有以 .jpg、.png 或 .gif 结尾的请求

}

目录匹配：以斜杠 / 结尾的匹配模式，用于匹配特定的目录。

location /images/ {

# 处理 /images/ 目录下的请求

}

四、location 块的优先级

当有多个 location 块匹配同一个请求时，Nginx 会根据以下规则来确定使用哪个 location 块：

首先检查是否有精确匹配 (=)。如果没有，检查是否有带有正则表达式的匹配 (~ 或 ~*)，并使用第一个匹配的规则。如果没有正则表达式匹配，则使用最长的前缀匹配。

五、location 块的应用场景

location 块可以用于多种场景，以下是一些例子：

静态资源服务：

location /static/ {

alias /usr/share/nginx/html/static/;

}

这个 location 块用于服务 /usr/share/nginx/html/static/ 目录下的静态文件。

代理转发：

location /api/ {

proxy_pass http://backend_server;

}

所有以 /api/ 开头的请求都会被代理到后端服务器。

错误页面重定向：

error_page 404 /404.html;

location = /404.html {

root /usr/share/nginx/html;

internal;

}

当发生 404 错误时，Nginx 会重定向到 /404.html 页面。

基于请求方法的处理：

location /api {

if ($request_method = POST) {

rewrite ^ /api/post last;

}

}

location /api/post {

# 处理 POST 请求

}

根据请求方法的不同，将请求重写到不同的 location 块进行处理。

限制访问：

location /restricted/ {

allow 192.168.1.0/24;

deny all;

}

这个 location 块限制只有来自特定 IP 范围的请求才能访问 /restricted/ 路径。

六、location 块的嵌套

location 块可以嵌套，这意味着你可以在一个 location 块内部定义另一个 location 块。这通常用于对特定的路径进行更细粒度的控制。

location / {

# 默认处理

location /admin {

# 对 /admin 路径的特殊处理

location ~ \.php$ {

# 对 /admin 路径下 PHP 文件的处理

}

}

}

在这个例子中，/admin 路径下的请求首先匹配外层的 location /，然后进一步匹配内层的 location /admin，如果请求的文件以 .php 结尾，则还会匹配最内层的 location ~ \.php$。

七、location 块的指令

在 location 块内部，你可以使用各种指令来控制请求的处理方式，例如：

proxy_pass：将请求代理到后端服务器。rewrite：重写请求的 URI。try_files：尝试不同的文件或路径，直到找到一个存在的。root 和 alias：设置请求文件的基本目录。index：指定目录索引文件。autoindex：启用或禁用目录列表。error_page：定义错误页面。auth_basic 和 auth_basic_user_file：设置 HTTP 基本认证。

八、示例配置

下面是一个完整的 Nginx 配置示例，展示了如何使用 location 块：

server {

listen 80;

server_name example.com;

# 网站根目录

root /var/www/html;

# 处理根路径

location = / {

index index.html;

}

# 处理静态资源

location /static/ {

alias /var/www/static/;

}

# 代理到后端应用服务器

location /api/ {

proxy_pass http://backend_server;

proxy_set_header Host $host;

proxy_set_header X-Real-IP $remote_addr;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_set_header X-Forwarded-Proto $scheme;

}

# 处理 PHP 文件

location ~ \.php$ {

include snippets/fastcgi-php.conf;

fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;

}

# 自定义错误页面

error_page 404 /404.html;

location = /404.html {

root /var/www/html;

internal;

}

}

在提供的示例配置中，我们定义了一个 server 块，它包含了多个 location 块，每个 location 块都有特定的用途和配置指令。下面详细讲解每个部分的作用：

server {

listen 80;

server_name example.com;

# 网站根目录

root /var/www/html;

# 处理根路径

location = / {

index index.html;

}

listen 80;：指定 Nginx 监听 HTTP 请求的端口号，这里是 80 端口，即标准的 HTTP 端口。server_name example.com;：定义服务器名，当客户端请求的 Host 头部与这个名称匹配时，就会使用这个 server 块的配置。root /var/www/html;：设置网站的根目录，所有未命名的 location 块（即默认的 location /）都会从这个目录下寻找资源。location = / { ... }：这个 location 块精确匹配根路径 /，并且配置了 index index.html;，这意味着当访问根路径时，Nginx 会自动寻找 /var/www/html 目录下的 index.html 文件来响应请求。

# 处理静态资源

location /static/ {

alias /var/www/static/;

}

location /static/ { ... }：这个 location 块用于处理所有以 /static/ 开头的请求。alias /var/www/static/;：将请求的 URI 替换为指定的路径，也就是说，所有对 /static/ 的请求都会映射到实际的目录 /var/www/static/。

# 代理到后端应用服务器

location /api/ {

proxy_pass http://backend_server;

proxy_set_header Host $host;

proxy_set_header X-Real-IP $remote_addr;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_set_header X-Forwarded-Proto $scheme;

}

location /api/ { ... }：这个 location 块用于处理所有以 /api/ 开头的请求。proxy_pass http://backend_server;：将所有匹配的请求代理到名为 backend_server 的后端服务器。通常，backend_server 需要在 http 或 upstream 块中定义。proxy_set_header Host $host;：设置代理请求的 Host 头部为客户端的原始请求中的 Host 值。proxy_set_header X-Real-IP $remote_addr;：设置 X-Real-IP 头部为客户端的 IP 地址。proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;：设置 X-Forwarded-For 头部，这是一个用于标识请求来源的链式头部，可以追踪请求穿过多个代理的路径。proxy_set_header X-Forwarded-Proto $scheme;：设置 X-Forwarded-Proto 头部为请求使用的协议（http 或 https）。

# 处理 PHP 文件

location ~ \.php$ {

include snippets/fastcgi-php.conf;

fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;

}

location ~ \.php$ { ... }：这个 location 块使用正则表达式匹配所有以 .php 结尾的文件。include snippets/fastcgi-php.conf;：包含一个外部配置文件，通常这个文件包含了处理 PHP 文件所需的 FastCGI 参数。fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;：指定 FastCGI 传递的目标，这里是 PHP-FPM 监听的 Unix Socket 文件。

# 自定义错误页面

error_page 404 /404.html;

location = /404.html {

root /var/www/html;

internal;

}

}

error_page 404 /404.html;：定义当发生 404 错误时，Nginx 应该返回哪个页面。location = /404.html { ... }：这个 location 块精确匹配 /404.html 路径。root /var/www/html;：设置 /404.html 文件的根目录，因为这是一个内部重定向，所以需要明确指定根目录。internal;：标记这个 location 块只能从内部重定向访问，而不能直接通过外部请求访问。

通过这样的配置，Nginx 可以根据请求的不同部分（如 URI、文件扩展名等）来决定如何处理请求，无论是返回静态文件、代理到后端应用服务器，还是处理脚本文件，都能得到妥善的处理。

通过 location 块的灵活配置，Nginx 可以高效地处理各种类型的请求，无论是静态资源、动态内容还是代理转发，都能轻松应对。