Nginx 官方文档学习实录

Nginx 的学习资料很多，但我都不满意，遂自己扒 Nginx 的官方文档：Nginx Documentation 以及一些外文资料，本文是记录这些知识以供后期复习。内容包括：配置文件、静态资源服务、代理服务器等。

0. 综述

Nginx 运行起来后会出现一个 master process 和 k 个 worker processes。用 ps -aux |grep nginx 可以查看到，其中 k 是可以有我们自己设置的：

master process 和 worker processes

其中 master process 用来加载配置文件并维护 worker processes 的运行，而 worker processes 则是实际处理外部发来的请求request 的进程。

Nginx运行起来后能完成什么功能（例如，返回静态文件，作为代理服务器转发某个request，充当邮件服务器等）是由 Nginx.conf 文件决定的。nginx.conf 被放在Linux系统里的 /usr/local/nginx/conf 或者 /etc/nginx 或者 /usr/local/etc/nginx。
其实大家把 Nginx.conf 看作是一堆命令的集合就可以了，这些命令都是 Nginx 定义好的并且使用起来很简单，所以入门级别的学习我们主要关注 nginx.conf 里常见的命令书写方式及其含义功能就好了。

1. Nginx 的配置文件 nginx.conf

1.1 宏观认识 nginx.conf

官方文档用 directives 表示命令，例如下文出现的简单命令和块命令，其英文分别是 simple directives 和 block directives。

从其组成元素的角度认识 nginx.conf：前文讲到，nginx.conf 其实就是一堆命令的集合，nginx 里的命令可以分为简单命令和块命令。简单命令的格式是：命令名 + 空格 + 参数 + ;，块命令的格式是：命令名 + 空格 + 参数 + {instructions}，而如果某个块命令的大括号内不仅可以放 instructions ，还可以放 directives ，那么这种命令也被称为上下文( context )，即命令名 + 空格 + 参数 + {directives}。

从层次化角度认识 nginx.conf：更具上面解释，其实可以看出来 nginx.conf 是个层次化的文件，就是说命令里还可以包含命令。在 nginx.conf 中有一些命令是没有被其他命令包含的，独立地写在文件里，这些命令都被认为是放在了 main context 中。

接下来我们就实际去看看一个真正的 nginx.conf 文件并对照上文做个解释吧：

########   Nginx的main(全局配置)文件
user root;  # 该条命令可以看作是一个简单命令，而且没有被包含在任何其他命令里，就可以看作是包含在 main context 里，只不过这个 main 并没被显式写出来，下面的四个都可看做简单命令。该命令指定nginx运行的用户及用户组,默认为nginx.

worker_processes  1;  #开启的线程数，一般跟逻辑CPU核数一致

error_log logs/error.log notice; #定位全局错误日志文件，级别以notice显示，还有debug,info,warn,error,crit模式，debug输出最多，crir输出最少，根据实际环境而定

pid /run/nginx.pid;  #指定进程id的存储文件位置

worker_rlimit_nofile 65535  #指定一个nginx进程打开的最多文件描述符数目，受系统进程的最大打开文件数量限制

events {
    #use epoll;  #设置工作模式为epoll,除此之外还有select,poll,kqueue,rtsig和/dev/poll模式
    worker_connections  1024;  #定义每个进程的最大连接数,受系统进程的最大打开文件数量限制。
}  # 这是遇到的第一个块命令。

####### Nginx 的 HTTP 服务器配置,Gzip配置
http {
    include mime.types;  #主模块指令，实现对配置文件所包含的文件的设定，可以减少主配置文件的复杂度，DNS主配置文件中的zonerfc1912,acl基本上都是用include语句。
    default_type  application/octet-stream; #核心模块指令，指令默认设置为二进制流，也就是当文件类型未定义时使用这种方式

    #下面代码为日志格式的设定，main为日志格式的名称，可自行设置，后面引用
    #log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
    #                  '$status $body_bytes_sent "$http_referer" '
    #                  '"$http_user_agent" "$http_x_forwarded_for"';

    access_log  logs/access.log  main;  #引用日志main

    client_max_body_size 20M;  #设置允许客户端请求的最大的单个文件字节数

    client_header_buffer_size  32k;  #指定来自客户端请求头的headebuffer大小

    client_body_temp_path /dev/shm/client_body_temp;  #指定连接请求试图写入缓存文件的目录路径

    large client_header_buffers 4 32k;  #指定客户端请求中较大的消息头的缓存最大数量和大小，目前设置为4个32KB

    sendfile on;   #开启高效文件传输模式
   
    tcp_nopush on;   #开启防止网络阻塞
    
    tcp_nodelay on;  #开启防止网络阻塞

    keepalive_timeout  65;  #设置客户端连接保存活动的超时时间

    client_header_timeout 10;  #设置客户端请求读取超时时间
    
    client_body_timeout 10;  #设置客户端请求主体读取超时时间

    send_timeout 10;      #用于设置相应客户端的超时时间


    ####HttpGZip模块配置
    gzip  on;  #开启gzip压缩
    #gzip_min_length 1k;  #设置允许压缩的页面最小字节数
    #gzip_buffers 4 16k;  #申请4个单位为16K的内存作为压缩结果流缓存
    #gzip_http_version 1.1;  #设置识别http协议的版本，默认为1.1
    #gzip_comp_level 2;   #指定gzip压缩比，1-9数字越小，压缩比越小，速度越快
    #gzip_types text/plain application/x-javascript text/css application/xml;  #指定压缩的类型
    #gzip_vary on;   #让前端的缓存服务器进过gzip压缩的页面


    #########Nginx的server虚拟主机配置
    server {
        listen 80;  #监听端口为 80

        server_name  localhost;  #设置主机域名

        access_log  logs/host.access.log  main;  #设置虚拟主机访问日志的存放路径及日志的格式为main

        #设置虚拟主机的基本信息
        location / {
            root   html;              #设置虚拟主机的网站根目录
            index  index.html index.html;  #设置虚拟主机默认访问的网页
        }

        error_page  404 /404.html;

        # redirect server error pages to the static page /50x.html
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root html;
        }
    }
}