nginx配置文件详解

一、安装Nginx

在安装Nginx之前，需确保系统已经安装了gcc、 openssl-devel、 pcre-devel和zlib-devel软件库。

其中， _with-http_stub_status_module 可以用来启用 Nginx 的 NginxStatus 功能，以监控 Nginx 的运行状态。

二、Nginx的配置文件结构

Nginx的配置文件nginx.conf位于其安装目录的conf目录下。

nginx.conf由多个块组成，最外面的块是main，main包含Events和HTTP，HTTP包含upstream和多个Server，Server又包含多个location。

main（全局设置）、server（主机设置）、upstream（负载均衡服务器设置）和 location（URL匹配特定位置的设置）。

1、main块设置的指令将影响其他所有设置。

2、server块的指令主要用于指定主机和端口。

3、upstream指令主要用于负载均衡，设置一系列的后端服务器。

4、location块用于匹配网页位置。

这四者之间的关系式：server继承main，location继承server，upstream既不会继承其他设置也不会被继承。

在这四个部分当中，每个部分都包含若干指令，这些指令主要包含Nginx的主模块指令、事件模块指令、HTTP核心模块指令，同时每个部分还可以使用其他HTTP模块指令，例如Http SSL模块、HttpGzip Static模块和Http Addition模块等。

三、Nginx的全局配置

events事件指令是设定Nginx的工作模式及连接数上限：

use是个事件模块指令，用来指定Nginx的工作模式。Nginx支持的工作模式有select、poll、kqueue、epoll、rtsig和/dev/poll。

其中select和poll都是标准的工作模式，kqueue和epoll是高效的工作模式，不同的是epoll用在Linux平台上，而kqueue用在BSD系统中。对于Linux系统，epoll工作模式是首选worker_connections也是个事件模块指令，用于定义Nginx每个进程的最大连接数，默认是1024。

最大客户端连接数由worker_processes和worker_connections决定，即Max_client=worker_processes*worker_connections。

在作为反向代理时，max_clients变为：max_clients = worker_processes * worker_connections/4。

进程的最大连接数受Linux系统进程的最大打开文件数限制，在执行 *** 作系统命令“ulimit -n 65536”后worker_connections的设置才能生效。

四、下面配置Nginx的HttpGzip模块。这个模块支持在线实时压缩输出数据流。

通过/opt/nginx/sbin/nginx -V命令可以查看安装Nginx时的编译选项，由输出可知，已经安装了HttpGzip模块。

五、负载均衡配置

下面设定负载均衡的服务器列表：

upstream是Nginx的HTTP Upstream模块，这个模块通过一个简单的调度算法来实现客户端IP到后端服务器的负载均衡。

在上面的设定中，通过upstream指令指定了一个负载均衡器的名称cszhi.com。这个名称可以任意指定，在后面需要的地方直接调用即可，Nginx的负载均衡模块目前支持4种调度算法。

六、server虚拟主机配置

下面介绍对虚拟主机的配置。

建议将对虚拟主机进行配置的内容写进另外一个文件，然后通过include指令包含进来，这样更便于维护和管理。

server标志定义虚拟主机开始，listen用于指定虚拟主机的服务端口，server_name用来指定IP地址或者域名，多个域名之间用空格分 开。index用于设定访问的默认首页地址，root指令用于指定虚拟主机的网页根目录，这个目录可以是相对路径，也可以是绝对路径。

Charset用于 设置网页的默认编码格式。access_log用来指定此虚拟主机的访问日志存放路径，最后的main用于指定访问日志的输出格式。

七、location URL匹配配置

URL地址匹配是进行Nginx配置中最灵活的部分。 location支持正则表达式匹配，也支持条件判断匹配，用户可以通过location指令实现Nginx对动、静态网页进行过滤处理。使用location URL匹配配置还可以实现反向代理，用于实现PHP动态解析或者负载负载均衡。

以下这段设置是通过location指令来对网页URL进行分析处理，所有扩展名以.gif、.jpg、.jpeg、.png、.bmp、.swf结尾的静态文件都交给nginx处理，而expires用来指定静态文件的过期时间，这里是30天。

八、StubStatus模块配置

StubStatus模块能够获取Nginx自上次启动以来的工作状态，此模块非核心模块，需要在Nginx编译安装时手工指定才能使用此功能。

stub_status设置为“on”表示启用StubStatus的工作状态统计功能。access_log 用来指定StubStatus模块的访问日志文件。auth_basic是Nginx的一种认证机制。

auth_basic_user_file用来指定认证的密码文件，由于Nginx的auth_basic认证采用的是与Apache兼容的密码文件，因此需要用Apache的htpasswd命令来生成密码文件。

然后输入两次密码后确认之后添加用户成功。

要查看Nginx的运行状态，可以输入http://ip/NginxStatus，输入创建的用户名和密码就可以看到Nginx的运行状态。

Active connections表示当前活跃的连接数，第三行的三个数字表示 Nginx当前总共处理了34561个连接， 成功创建次握手， 总共处理了354399个请求。

最后一行的Reading表示Nginx读取到客户端Header信息数， Writing表示Nginx返回给客户端的Header信息数，“Waiting”表示Nginx已经处理完，正在等候下一次请求指令时的驻留连接数。

在最后这段设置中，设置了虚拟主机的错误信息返回页面，通过error_page指令可以定制各种错误信息的返回页面。在默认情况下，Nginx会在主目录的html目录中查找指定的返回页面。

特别需要注意的是，这些错误信息的返回页面大小一定要超过512K，否者会被ie浏览器替换为ie默认的错误页面。

参考资料1

参考资料2

参考资料3

主配置文件 /etc/nginx/nginx.conf 。

配置文件中的 path，既可以是绝对路径也可以是相对路径，相对路径相对 /usr/share/nginx 目录。

通过 default_server 参数，指定当前 server 为对应 IP:PORT 对的默认服务器。当一个请求匹配到 IP:PORT，但是 Host 字段不匹配任何一个 server_name，则应用默认服务器 server。假设 http://www.lishiqing.com 请求的 IP:PORT 为 192.168.100.104:80，但是没有对应的 server_name 匹配 www.lishiqing.com ，则应用默认服务器。

如果没有一个 listen 指令具有 default_server 参数，则具有 IP:PORT 对的第一个 server 将是该 IP:PORT 对的默认服务器。

以下配置忽略 server_name，所有指向 192.168.100.105 的域名都能应用该 server

以下配置访问 lishiqing.com 应用默认 server，也就是第一个 server

参考资料

location 指令可以跟字符串，也可以跟正则表达式

location string_path {} 区分大小写的字符串

location = string_path {} 严格匹配字符串

location ~ reg_path {} 区分大小写的正则表达式

location ~* reg_path {} 不区分大小写的正则表达式

http://lishiqing.com/shop/images/1.png 这个请求的 query 为 /shop/images/1.png 。

当 location 后面是字符串的时候，如果某个请求的 query 以该字符串开头，则匹配该 location，比如 /shop/images/1.png 的请求匹配 location /shop {} ，也匹配 location / {} ，但是不匹配 location /blog 。

当 location 后面是正则表达式的时候，如果某个请求的 query 匹配该正则表达式，则匹配该 location，比如 /shop/images/1.png 的请求匹配 location ~ \.(jpg|jpeg|png)$ {} 。

如果某个 query 匹配多个字符串的 location，那么应用匹配度最高的一个 location，与 location 的顺序无关。比如 /shop/images/1.png 的请求匹配 location / {} 和 location /shop {} ，但是应用 location /shop {} 。

如果某个 query 匹配多个正则表达式的 location，那么按照 location 的顺序应用第一个匹配的 location。比如 /shop/images/1.png 的请求匹配 location ~ \.(jpg|jpeg|png)$ {} 和 location ~ .*/images/.* {} ，但是应用第一个匹配的 location ~ \.(jpg|jpeg|png)$ {} 。因为在 query 在检查正则表达式的时候，遇见第一匹配的 location 就停止继续查找了。

如果某个 query 既匹配某个字符串的 location，又匹配某个正则表达式的 location，那么应用正则表达式的 location，与顺序无关。比如 /shop/images/1.png 的请求匹配 location /shop {} 和 location ~ \.(jpg|jpeg|png)$ {} ，但是会应用 location ~ \.(jpg|jpeg|png)$ {} 。这是因为某个请求会先检查跟着字符串的 location，不管是否找到匹配的字符串 location，都会继续按照顺序查找跟着正则表达式 location，因此正则表达式的优先级高于字符串。如果找到了匹配的正则表达式，则立即停止查找，应用该 location，如果没找到匹配的正则表达式，则应用刚才找到的匹配度最高的字符串 location。

location = string_path {} 为严格匹配，query 必须与 string_path 完全一致才能匹配。如果 query 与某个 = string_path 匹配，则立即停止查找，应用该 location。意味着不会去查找正则表达式 location。比如 /shop/images/1.png 匹配 location = /shop/images/1.png {} ，不匹配 location = /shop {} 和 location = /shop/images 。一般用来设置 location = / {} 来匹配 / 的 query，因为 / 的 query 会很频繁，因此将 location = / {} 放在第一条 location 可以提高匹配查询的效率。

location ^~ string_path {} 这种字符串匹配的优先级高于正则表达式，当某个 query 匹配该 location 的时候，不会继续查找正则表达式的 location 了。比如 /shop/images/1.png 的 query 满足 location ^~ /shop {} 和 location ~ \.(jpg|jpeg|png)$ {} ，但是会应用 location ^~ /shop {} 。

总结：

---