Nginx文档-Nginx如何处理请求

基于名称的虚拟服务器

nginx 首先决定哪个 server 应该处理请求,让我们从一个简单的配置开始,三个虚拟服务器都监听了 *:80 端口:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
server {
listen 80;
server_name example.org www.example.org;
...
}

server {
listen 80;
server_name example.net www.example.net;
...
}

server {
listen 80;
server_name example.com www.example.com;
...
}

在此配置中,nginx 仅检验请求的 header 域中的 “Host”,以确定请求应该被路由到哪一个 server。如果其值与任何的 server 名称不匹配,或者该请求根本不包含此 header 域,nginx 将将请求路由到该端口的默认 server。在上面的配置中,默认 server 是第一个——这是 nginx 的标准默认行为。它可以明确地设置哪一个 server 应该是默认的,在 listen 指令中使用 default_server 参数:

1
2
3
4
5
server {
listen 80 default_server;
server_name example.net www.example.net;
...
}

default_server 参数自 0.8.21 版本起可用。在早期版本中,应该使用 default 参数代替。

请注意,默认 server 是 listen port 的属性,而不是 server_name 的。之后会有更多关于这方面的内容。

如何使用未定义的 server 名称来阻止处理请求

如果不允许没有“Host” header 字段的请求,可以定义一个丢弃请求的 server:

1
2
3
4
5
server {
listen 80;
server_name "";
return 444;
}

这里的 server 名称设置为一个空字符串,匹配不带“Host” header 域的请求,返回一个表示表示关闭连接的 nginx 非标准代码 444。

自 0.8.48 版本开始,这是 server 名称的默认设置,因此可以省略 server name ""。在早期版本中,机器的主机名被作为 server 的默认名称。

基于名称和 IP 混合的虚拟服务器

让我们看看更加复杂的配置,其中一些虚拟服务器在不同的地址上监听:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
server {
listen 192.168.1.1:80;
server_name example.org www.example.org;
...
}

server {
listen 192.168.1.1:80;
server_name example.net www.example.net;
...
}

server {
listen 192.168.1.2:80;
server_name example.com www.example.com;
...
}

此配置中,nginx 首先根据 server 块的 listen 指令检验请求的 IP 和 端口。之后,根据与 IP 和 端口相匹配的 server 块的 server_name 项对请求的“Host” header 域进行检验。如果找不到服务器的名称(server_name),请求将由 default_server 处理。例如,在 192.168.1.1:80 上收到的对 www.example.com 的请求将由 192.168.1.1:80 端口的 default_server (即第一个 server)处理,因为没有 www.example.com 没有在此端口上定义。

如上所述,默认 serverlisten port 的属性,可以为不同的端口定义不同的 default_server

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
server {
listen 192.168.1.1:80;
server_name example.org www.example.org;
...
}

server {
listen 192.168.1.1:80 default_server;
server_name example.net www.example.net;
...
}

server {
listen 192.168.1.2:80 default_server;
server_name example.com www.example.com;
...
}

一个简单的 PHP 站点配置

现在让我们来看看 nginx 是如何选择一个 location 来处理典型的简单 PHP 站点的请求:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
server {
listen 80;
server_name example.org www.example.org;
root /data/www;

location / {
index index.html index.php;
}

location ~* \.(gif|jpg|png)$ {
expires 30d;
}

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

nginx 首先忽略排序搜索具有最明确字符串的前缀 location。在上面的配置中,唯一有符合的是前缀 location/,因为它匹配任何请求,它将被用作最后的手段。之后,nginx 按照配置文件中列出的顺序检查由 location 的正则表达式。第一个匹配表达式停止搜索,nginx 将使用此 location。如果没有正则表达式匹配请求,那么 nginx 将使用前面找到的最明确的前缀 location

请注意,所有类型的 location 仅仅是检验请求的 URI 部分,不带参数。这样做是因为查询字符串中的参数可以有多种形式,例如:

1
2
/index.php?user=john&page=1
/index.php?page=1&user=john

此外,任何人都可以在查询字符串中请求任何内容:

1
/index.php?page=1&something+else&user=john

现在来看看在上面的配置中是如何请求的:

  • 请求 /logo.gif 首先与 前缀 location/ 相匹配,然后由正则表达式 \.(gif|jpg|png)$ 匹配,因此由后一个 location 处理。使用指令 root /data/www 将请求映射到 /data/www/logo.gif 文件,并将文件发送给客户端。
  • 一个 /index.php 的请求也是首先与前缀 location/ 相匹配,然后是正则表达式 \.(php)$。因此,它由后一个 location 处理,请求将被传递给在 localhost:9000 上监听的 FastCGI 服务器。fastcgi_param 指令将 FastCGI 参数 SCRPT_FILENAME 设置为 /data/www/index.php,FastCGI 服务器执行该文件。变量 $document_rootroot 指令的值是一样的,变量 $fastcgi_script_name 的值为请求URI,即 /index.php
  • /about.html 请求仅与前缀 location/ 相匹配,因此由此 location 处理。使用指令 root /data/www 将请求映射到 /data/www/about.html 文件,并将文件发送给客户端。
  • 处理请求 / 更复杂。它与前缀 location/ 相匹配。因此由该 location 处理。然后,index 指令根据其参数和 root /data/www 指令检验索引文件是否存在。如果文件 /data/www/index.html 不存在,并且文件 /data/www/index.php 存在,则该指令执行内部重定向到 /index.php,如果请求是由客户端发起的,nginx 将再次搜索 location。如之前所述,重定向请求最终由 FastCGI 服务器处理。

由 Igor Sysoev 撰写
由 Brian Mercer 编辑

文档译本归档仓库

原文