高性能Web服务器Nginx的配置与部署研究

及

，转载请注明出处。

英文原文：http://nginx.org/en/docs/http/request_processing.html

原文作者：Igor Sysoev

中文译者：Poechant

特别声明：

（1）本人提供意译，不提供咬文嚼字的逐句翻译。

（2）本文欢迎传播，但请注明出处。

（3）欢迎提各种宝贵建议。

本文为您解读，Nginx是如何处理请求的，让你从逻辑上有一个清晰的认识。

以下为正文：

1.处理什么样的请求

处理访问到Nginx所在IP地址的请求，并且这些请求的HTTP头信息中的Host为所要处理的域名（如下以80端口为例），如下几个server就对应响应的请求：

[plain] view plaincopyprint?

server {
listen 80;
server_name nginx.org www.nginx.org;
...
}
server {
listen 80;
server_name nginx.net www.nginx.net;
...
}
server {
listen 80;
server_name nginx.com www.nginx.com;
...
}

2.默认server

如果不主动设置默认server，那么第一个server就会被当做默认server。若要主动设置，应该如下配置：

[plain] view plaincopyprint?

server {
listen 80 default_server;
server_name nginx.net www.nginx.net;
...
}

此项的版本注意事项：

0.8.21版本之前，使用default关键词；

从0.8.21版本开始，使用default_server关键词。

另外注意，default_server是端口的一个属性，不是server_name的一个属性。

3.如何处理未定义host为server_name的请求

比如，如果不想处理HTTP请求中没有HOST字段的头信息的情况，那么可以如下：

[plain] view plaincopyprint?

server {
listen 80;
server_name "";
return 444;
}

此项的版本注意事项：

0.8.48之前的版本，如果没有设置server_name的话，那么会把server_name设置为本机的hostname。

0.8.48开始的版本，如果没有设置server_name的话，那么会把server_name设置为""，所以如果要达到上述代码的效果，在此版本开始可以不设置server_name。

4.Nginx的虚拟主机监听

请先看如下配置：

[plain] view plaincopyprint?

server {
listen 192.168.1.1:80;
server_name nginx.org www.nginx.org;
...
}
server {
listen 192.168.1.1:80;
server_name nginx.net www.nginx.net;
...
}
server {
listen 192.168.1.2:80;
server_name nginx.com www.nginx.com;
...
}

这个应该很好理解，如果listen的IP地址和端口号都吻合了，就看HTTP请求中的HOST头信息与某个server_name中的name是否吻合。如果server_name不吻合，就到该端口对应的default_server那里处理请求，如果default_server的server_name也没有与HOST头信息吻合，那么就放弃该请求。

特别再次强调，default_server是端口的属性，而非server_name的属性。所以可以有如下配置：

[plain] view plaincopyprint?

server {
listen 192.168.1.1:80;
server_name nginx.org www.nginx.org;
...
}
server {
listen 192.168.1.1:80 default_server;
server_name nginx.net www.nginx.net;
...
}
server {
listen 192.168.1.2:80 default_server;
server_name nginx.com www.nginx.com;
...
}

5.一个简单的PHP站点的Nginx配置

[plain] view plaincopyprint?

server {
listen 80;
server_name nginx.org www.nginx.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的时候，不是按照配置代码给出的顺序进行匹配的，而是先按照匹配表达式中的文字字符串（literal string）的明确程度，从最明确的开始匹配。这么说可能有点含混不清，简单说，没有正则规则的匹配表达式，是最明确的。比如如果这个匹配表达式就是一个“/”或者“/abc”，那么这就是最明确的。上例中的"/"就是这个最明确的蚊子字符串（the most specific literal string），其实也是该例中唯一的。所以先从这个location开始，然后再按照location的列出顺序，依次匹配，直到出现第一个匹配的location后停止。如果所有的location都不匹配，就用第一个找到的最明确的文字字符串来匹配（the most specific literal string）。

6.待查询的HTTP请求

Nginx只处理无查询的HTTP请求，因为查询请求的查询字段的顺序不确定，比如：

[plain] view plaincopyprint?

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

再比如：

[plain] view plaincopyprint?

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

7.几个location的例子

例1：

[plain] view plaincopyprint?

/logo.gif

“/”先被找到，然后匹配"\.(gif|jpg|png)$"，再根据redirective找到root是/data/www，然后这个请求就被映射到"/data/www/logo.gif"了，最后文件就被发送给到了客户端。

例2：

[java] view plaincopyprint?

/index.php

"/"先被找到，然后匹配"\.(php)$"，然后request就被传递给在9000端口上监听的FastCGI服务器，"fastcgi_param" directive设置FastCGI的参数SCRIPT_FILENAME为"/data/www/index.php"，然后FastCGI服务器就执行这个文件。（注意其中document_root是/data/www，fastcgi_script_name是/index.php。）

例3：

[plain] view plaincopyprint?

/about.html

"/"先被找到，且只有这一个匹配的。然后根据root值/data/www，就找到了文件/data/www/about.html，然后发送给客户端。

例4：

[plain] view plaincopyprint?

/

"/"是很复杂的，先找到"/"这个location，然后根据root值/data/www，看/data/www/index.php是否存在，如果存在directive就在内部重定向到/index.php，然后Nginx根据这个再次搜索location，重复上面第二个例子。

本文来自：CSDN博客专栏

及

高性能Web服务器Nginx的配置与部署研究（4）Nginx常用命令

，转载请注明出处。

winston · 发表于 2012-1-19 21:00:02

本文来自：CSDN博客专栏

及

，转载请注明出处。

此篇文章，为你详解所有你可能会用到命令，包括启动、停止、重启、重载配置、指定配置等等。

1. 启动Nginx

[plain] view plaincopyprint?

poechant@ubuntu:sudo ./sbin/nginx

2. 停止Nginx

[plain] view plaincopyprint?

poechant@ubuntu:sudo ./sbin/nginx -s stop
poechant@ubuntu:sudo ./sbin/nginx -s quit

-s 都是采用向Nginx发送信号的方式。

3. Nginx重载配置

[plain] view plaincopyprint?

poechant@ubuntu:sudo ./sbin/nginx -s reload

上述是采用向Nginx发送信号的方式，或者使用：

[plain] view plaincopyprint?

poechant@ubuntu:service nginx reload

4. 指定Nginx配置文件

[plain] view plaincopyprint?

poechant@ubuntu:sudo ./sbin/nginx -c /usr/local/nginx/conf/nginx.conf

-c表示configuration，指定配置文件。

5. 查看Nginx版本：

有两种可以查看Nginx的版本信息的参数。第一种如下：

[plain] view plaincopyprint?

poechant@ubuntu:/usr/local/nginx$ ./sbin/nginx -v
nginx: nginx version: nginx/1.0.0

另一种显示的是详细的版本信息：

[plain] view plaincopyprint?

poechant@ubuntu:/usr/local/nginx$ ./sbin/nginx -V
nginx: nginx version: nginx/1.0.0
nginx: built by gcc 4.3.3 (Ubuntu 4.3.3-5ubuntu4)
nginx: TLS SNI support enabled
nginx: configure arguments: --with-http_ssl_module --with-openssl=/home/luming/openssl-1.0.0d/

6. 检查配置文件正确性

[plain] view plaincopyprint?

poechant@ubuntu:/usr/local/nginx$ ./sbin/nginx -t
nginx: [alert] could not open error log file: open() "/usr/local/nginx/logs/error.log" failed (13: Permission denied)
nginx: the configuration file /usr/local/nginx/conf/nginx.conf syntax is ok
2012/01/09 16:45:09 [emerg] 23898#0: open() "/usr/local/nginx/logs/nginx.pid" failed (13: Permission denied)
nginx: configuration file /usr/local/nginx/conf/nginx.conf test failed

如果出现如上的提示信息，表示没有访问错误日志文件和进程，可以sudo（super user do）一下：

[plain] view plaincopyprint?

poerchant@ubuntu:/usr/local/nginx$ sudo ./sbin/nginx -t
nginx: the configuration file /usr/local/nginx/conf/nginx.conf syntax is ok
nginx: configuration file /usr/local/nginx/conf/nginx.conf test is successful

如果显示如上，则表示配置文件正确。否则，会有相关提示。

7. 显示帮助信息

[plain] view plaincopyprint?

poechant@ubuntu:/user/local/nginx$ ./sbin/nginx -h

或者：
[plain] view plaincopyprint?

poechant@ubuntu:/user/local/nginx$ ./sbin/nginx -?

以上这些涵盖了Nginx日常维护的所有基本操作，另外还有向master进程发送信号的相关命令，我们会在后续看到。

本文来自：CSDN博客专栏

及

高性能Web服务器Nginx的配置与部署研究（5）Nginx配置符号

，转载请注明出处。

winston · 发表于 2012-1-19 21:00:25

本文来自：CSDN博客专栏《Nginx高性能Web服务器》及Poechant技术博客，转载请注明出处。

1. 容量符号

k 千字节

K 千字节

m 兆字节

M 兆字节

2. 时间符号

ms 毫秒

s 秒

m 分

h 时

d 日

w 周

M 月（按照30天计算）

y 年（按照365天计算）

3. 示例

1h 30m 表示1小时30分钟

1y 6M 表示1年6个月

winston · 发表于 2012-1-19 21:00:45

高性能Web服务器Nginx的配置与部署研究（6）核心模块之主模块的测试常用指令

本文来自：CSDN博客专栏《Nginx高性能Web服务器》及Poechant技术博客，转载请注明出处。

本文欢迎转载，转载必须注明出处：

1. daemon

含义：设置是否以守护进程模式运行

语法：daemon on|off

缺省：on

示例：daemon off;

注意：生产环境（production mode）中不要使用daemon指令，这些选项仅用于开发测试（development mode）。

2. debug_points

含义：断点调试

语法：debug_points [stop|abort]

缺省：none

示例：debug_points stop;

注意：在Nginx内有一些assert断言，这些断言允许Nginx，配合调试器中断程序运行、停止或创建core文件。

3. master_process

含义：设置是否启用主进程

语法：master_process on|off

缺省：on

示例：master_process off;

注意：不要在生产环境（production mode）中使用master_process指令，这些选项仅用于开发测试（development mode）。

本文欢迎转载，转载必须注明出处：

4. error_log

含义：指定错误日志文件

缺省：${prefix}/logs/error.log

示例：error_log /data/nginx/logs/error.log debug

注意：该命令并非只有在测试（或称为开发）模式下才可以使用，而是在编译时添加了--with-debug参数时，则可以使用error_log指令的额外参数，即：

本文欢迎转载，转载必须注明出处：

高性能Web服务器Nginx的配置与部署研究（7）核心模块之主模块的非测试常用指令

winston · 发表于 2012-1-19 21:01:08

本文来自：CSDN博客专栏《Nginx高性能Web服务器》及Poechant技术博客，转载请注明出处。

本文欢迎转载，转载必须注明出处：http://blog.csdn.net/poechant

1. error_log

含义：指定存储错误日志的文件

缺省：${prefix}/logs/error_log

示例：error_log file debug;

注意：在编译Nginx使用--with-debug参数，则可以参考《高性能Web服务器Nginx的配置与部署研究——（6）Nginx核心模块的测试常用指令》中的error_log部分

2. include

含义：指定所要包含的Nginx配置文件

语法：include <file|*>

缺省：none

示例：include vhosts/*.conf 或 include /home/michael/nginx/conf/nginx-main.conf

注意：

（1）include命令可以指定包含一个文件，比如第二个示例。也可以指定包含一个目录下的所有文件，比如第一个示例。

（2）指定的文件路径的基路径，由编译选项--prefix决定，如果编译时没有指定，则默认的路径是/usr/local/nginx。

3. lock_file

含义：

语法：lock_file <file>

缺省：compile-time option

示例：lock_file /var/log/lock_file;

注意：Nginx使用accept mutex来序列化accept()系统调用（syscalls）。如果是在i386，sparc64，ppc64或amd64平台上用GCC，Intel C++，SunPro C++编译器编译的，则Nginx使用CPU原指令实现mutex。其他情况下，则使用lock_file。

4. pid

含义：指定存储进程ID（即PID）的文件。

语法：pid <file>

缺省：compile-time option Example

示例：pid /var/log/nginx.pid;

注意：可以使用命令kill -HUP cat /var/log/nginx.pid\ 对Nginx进行进程ID文件的重新加载。

本文欢迎转载，转载必须注明出处：

5. ssl_engine

含义：指定使用的openssl引擎。

语法：ssl_engine engine;

缺省：视系统而定

示例：

注意：你可以使用openssl engine -t命令来查看系统目前支持的openssl引擎。

6. timer_resolution

略

7. user

含义：指定可以使用Nginx的用户

语法：user <user> [group]

缺省：nobody nobody（第一个nobody是user，第二个nobody是group）

示例：user www users;

8. worker_processes

含义：指定worker进程数

语法：worker_processes <number>

缺省：1

示例：worker_processes 4;

注意：最大用户连接数=worker进程数×worker连接数，即max_clients=worker_processes*worker_connections。

9. worker_cpu_affinity

含义：为worker进程绑定CPU。

语法：worker_cpu_affinity cpumask [cpumask...]

缺省：none

示例：

（1）如果有4个CPU，并且指定4个worker进程，则：

worker_processes 4;

worker_cpu_affinity 0001 0010 0100 1000;

（2）如果有4个CPU，并且指定2个worker进程，则：

worker_processes 2;

worker_cpu_affinity 0101 1010;

注意：只有Linux平台上才可以使用该指令。

10. worker_priority

含义：指定各worker进程的优先级

语法：worker_priority [-] <number>;

缺省：on

示例：

注意：使用该指令可以给woker进程分配优先值。

11. worker_rlimit_core

含义：指定每个worker进程的core文件最大size。

语法：worker_rlimit_core <max_size>;

12. worker_rlimit_nofile

含义：worker进程的file descriptor可以打开的最大文件数。

语法：worker_rlimit_nofile <number>;

13. worker_rlimit_sigpending

略

本文欢迎转载，转载必须注明出处：