一、nginx的配置文件：nginx.conf

  1、nginx配置文件的结构：

      main(全局配置段)

      events {...}

      http {

       ...

       server {

         location ... {...}

         location ... {...}

         ...

       }

       server {

         ...

       }

      }

  2、配置参数需要以分号结尾，语法格式：

      参数名  值1 [值2 ...];

  3、配置文件中还可使用变量：

      模块内置变量

      用户自定义变量：set var_name value

  4、配置文件检查：nginx -t

  5、nginx配置文件vim语法高亮

      vim对编译安装的nginx配置文件默认没有设置语法高亮，可执行以下步骤解决：

        #mkdir -pv ~/.vim/syntax

        #cd ~/.vim/syntax

        #wget http://www.vim.org/scripts/download_script.php?src_id=14376 -O nginx.vim

        #echo "au BufRead,BufNewFile /usr/local/nginx/* set ft=nginx" >> ~/.vim/filetype.vim


二、nginx的基本核心配置（main段、events{}段）

  1、正常运行的必备配置：

     ①user username [groupname];   #指定运行worker进程的用户和组

     ②pid /path/to/pidfile_name;   #指定nginx的pid文件

     ③worker_rlimit_nofile #;

          worker进程所能够打开的最大文件句柄数。该值不能小于worker_connections×worker_processes，如果nginx工作为反向代理服务器，则该值不能小于worker_connections×worker_processes×2，因为此时一个请求需要维持两个套接字文件。

     ④worker_rlimit_sigpending #;   设定每个用户能够发往worker进程的信号的数量；

  2、优化性能相关的配置：

     ①worker_processes #;   #worker进程的个数；通常其数值应该为CPU的核心数减1；

     ②worker_cpu_affinity cpumask ...;

        例如：

          worker_processes  3;
          worker_cpu_affinity 0001 0010 1000;

          表示将3个worker进程分别绑定在CPU0，CPU1，CPU3上

     ③ssl_engine device;   #在存在ssl硬件加速器的服务器上，指定所使用的ssl硬件加速设备；

     ④timer_resolution t;   #每次内核事件调用返回时，都会使用gettimeofday()来更新nginx缓存时钟；timer_resolution用于定义每隔多久才会由gettimeofday()更新一次缓存时钟；x86-64系统上，gettimeofday()代价已经很小，可以忽略此配置；

     ⑤worker_priority nice;   #-20,19之间的值；

  3、事件相关的配置

     ①accept_mutex [on|off]   #是否打开nginx的负载均衡锁；此锁能够让多个worker进程轮流地、序列化地与新的客户端建立连接；而通常当一个worker进程的负载达到其上限的7/8，master就尽可能不再将请求调度此worker；

     ②lock_file /path/to/lock_file;

     ③accept_mutex_delay #ms;   #accept锁模式中，一个worker进程为取得accept锁的等待时长；如果某worker进程在某次试图取得锁时失败了，至少要等待#ms才能再一次请求锁；

     ④multi_accept on|off;   #是否允许一次性地响应多个用户请求；默认为off; 

     ⑤use [epoll|rtsig|select|poll];   #定义使用的事件模型，建议让nginx自动选择；

     ⑥worker_connections #;   #每个worker进程能够并发响应的最大请求数；

  4、用于调试、定位问题: 只调试nginx时使用

     ①daemon on|off;  #是否让ningx运行于后台；默认为on，调试时可以设置为off，使得所有信息直接输出至控制台；

     ②master_process on|off   #是否以master/worker模式运行nginx；默认为on；调试时可设置off以方便追踪；

     ③error_log /path/to/error_log level;   #错误日志文件及其级别；默认为error级别；调试时可以使用debug级别，但要求在编译时必须使用--with-debug启用debug功能；


三、nginx的http web核心功能（http_core_module）

     nginx必须使用虚拟主机来配置站点，每个虚拟主机使用一个server {}段配置

     非虚拟主机的配置或公共配置，需要定义在server之外，http之内

  ◆虚拟主机相关的配置：

     ⑴server {...}

        定义一个虚拟主机；nginx支持使用基于主机名或IP的虚拟主机；

     ⑵listen address[:port] [default_server] [ssl]...;

      listen port [default_server] [ssl]...;

          default_server：定义此server为http中默认的server；如果所有的server中没有任何一个listen使用此参数，那么第一个server即为默认server

          rcvbuf=SIZE：接收缓冲大小

          sndbuf=SIZE：发送缓冲大小

          ssl：https server

     ⑶server_name [...];

        server_name可以跟多个主机名，名称中可以使用通配符和正则表达式(通常以~开头)；当nginx收到一个请求时，会取出其首部的server的值，而后跟众server_name进行比较；比较方式：

         ①先做精确匹配，如 www.magedu.com 

         ②左侧通配符匹配，如 *.magedu.com

         ③右侧通配符匹配，如 www.*

         ④正则表达式匹配，如 ~^.*\.magedu\.com$

     ⑷server_name_hash_bucket_size 32|64|128;

        为了实现快速主机查找，nginx使用hash表来保存主机名

     ⑸location [ = | ~ | ~* | ^~ ] uri { ... }    #location只能放在server和location中，location可出现多次

      location @name { ... }

        功能：允许根据用户请求的URI来匹配指定的各location以进行访问配置；匹配到时，将被location块中的配置所处理；比如：http://www.magedu.com/p_w_picpaths/logo.gif

        匹配规则：

          =：精确匹配；

          ~：正则表达式模式匹配，区分字符大小写

          ~*：正则表达式模式匹配，忽略字符大小写

          ^~：URI前缀匹配，不检查正则表达式

          @：用来定义“Named Location”这种“Named Location”不是用来处理外部的http请求，而是专门用来处理内部重定向的；此用法不常用

        匹配优先级：

           精确匹配、以^~开头的最长前缀匹配、正则表达式检索（由第一个匹配到所处理）、最长前缀匹配

        示例：

           ① location / {

                root /web/a;

             }

           ② location ^~ /documents/ {

                root /web/b;

             }

           ③ location /documents/media/ {

                root /web/c;

             }

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

                root /web/d;

             }        

           ⑤ location = /documents/media/test.jpg {

                root /web/e;

             }

           若请求的uri为/documents/media/test.jpg，则匹配的优先次序为⑤②④③①


  ◆文件路径定义：

     ⑴root path;   #指定web资源根目录，可用于http，server和location中

     ⑵alias path;   #定义指定路径的替换路径，只能用于location中

        区别root path和alias path：                

          例，用户请求www.magedu.com/p_w_picpaths/b.html

             ①location /i/ {

                 root /data/p_w_picpaths;
               }

               “/i/top.gif”将由/data/p_w_picpaths/i/top.gif文件来响应

          ②location /i/ {
                 alias /data/p_w_picpaths/;
               }

               “/i/top.gif”将由/data/p_w_picpaths/top.gif文件来响应

       说明：

          root和alias指定的path都可以包含除$document_root和$realpath_root以外的变量

          root文件路径的构造仅仅是将URI拼在root指令的值后面。如果需要修改URI，应该使用alias指令。

          如果在定义了正则表达式的路径中使用了alias，那么正则表达式中应该含有匹配组， 并且alias应该引用这些匹配组来组成一个完整的文件路径，比如：

             location ~ ^/users/(.+\.(?:gif|jpe?g|png))$ {
                alias /data/w3/p_w_picpaths/$1;
                }

     ⑶index file ...;   #定义默认页面，可跟多个值

     ⑷error_page code ... [=[response]] uri;

        当对于某个请求返回错误时，如果匹配上了error_page指令中设定的code，则重定向到新的uri，uri可以包含变量；还可以使用“=response”语法改变响应状态码。例如：

          error_page 404 =200 /empty.gif;

          error_page 403 http:/example.com/forbidden.html;  #还可对错误进行重定向 

        如果内部跳转时无需改变URI，可以将错误处理转到一个命名路径：

          location / {
            error_page 404 = @fallback;
          }

          location @fallback {
            proxy_pass http://backend;
          }

     ⑸try_files path1 [path2 ...] uri;

        自左至右尝试读取由path所指定路径，在第一次找到即停止并返回；如果所有path均不存在，则按最后一个uri进行内部跳转。最后一个参数也可以是code，还可以是命名路径，如@fallback；

        例如：

          location ~* ^/documents/(.*)$ {

             root /www/htdocs;

             try_files $uri /docu/$1 /temp.html @fallback;   #或前面的几个文件都找不到，则会以原始URI转到最后指定的命名location

          }

          location /text/ {

             alias /web/a/;

             try_files $uri /text/back.html =404;   #若去掉“=404”而以“/text/back.html”结尾，则“/text/back.html”不再表示一个文件的相对路径，而表示uri，它会重新寻找匹配的location

          }

          若请求/text/temp.html，则寻找的文件路径依次是/web/a/temp.html，/web/a/text/back.html，若这两个文件都找不到，则返回404


  ◆网络连接相关的设置：

     ⑴keepalive_timeout time;   #保持连接的超时时长；默认为75秒

     ⑵keepalive_requests n;   #在一次长连接上允许承载的最大请求数

     ⑶keepalive_disable [msie6 | safari | none ];   #对指定的浏览器禁止使用长连接

     ⑷tcp_nodelay on|off;   #对keepalive连接是否使用TCP_NODELAY选项

     ⑸client_header_timeout time;   #读取http请求首部的超时时长

     ⑹client_body_timeout time;   #读取http请求包体的超时时长

     ⑺send_timeout time;   #发送响应的超时时长


  ◆对客户端请求的限制：

     ⑴limit_except method ... { ... }

        指定对范围之外的其它方法的访问控制，只能用在location中

        例：

          limit_except GET {    #除get以外的其它方法只允许172.16.0.0访问

            allow 172.16.0.0/16;

            deny all;

          }

     ⑵client_max_body_size size;

        http请求包体的最大值；常用于限定客户所能够请求的最大包体；根据请求首部中的Content-Length来检测，以避免无用的传输；

     ⑶limit_rate speed;   #限制客户端每秒钟传输的字节数；默认为0，表示没有限制；

     ⑷limit_rate_after time;

        nginx向客户端发送响应报文时，如果时长超出了此处指定的时长，则后续的发送过程开始限速；


  ◆文件操作的优化：

     ⑴sendfile on|off;   #是否启用sendfile功能；

     ⑵aio on|off;   #是否启用aio功能；

     ⑶open_file_cache max=N [inactive=time]|off;   #是否打开文件缓存功能；

         max: 缓存条目的最大值；当满了以后将根据LRU算法进行置换；

         inactive: 某缓存条目在指定时长时没有被访问过时，将自动被删除；默认为60s

         缓存的信息包括：

           文件句柄、文件大小和上次修改时间；

           已经打开的目录结构；

           没有找到或没有访问权限的信息；

     ⑷open_file_cache_errors on|off;   #是否缓存文件找不到或没有权限访问等相关信息；

     ⑸open_file_cache_valid time;   #多长时间检查一次缓存中的条目是否超出非活动时长，默认为60s

     ⑹open_file_cache_min_use #;   #在inactive指定的时长内被访问超此处指定的次数地，才不会被删除；


  ◆对客户端请求的特殊处理：

     ⑴ignore_invalid_headers on|off;

        是否忽略不合法的http首部；默认为on，off意味着请求首部中出现不合规的首部将拒绝响应；只能用于server和http

     ⑵log_not_found on|off;   #是否将文件找不到的信息也记录进错误日志中；

     ⑶resolver address;   #指定nginx使用的dns服务器地址；

     ⑷resover_timeout time;   #指定DNS解析超时时长，默认为30s；

     ⑸server_tokens on|off;   #是否在错误页面中显示nginx的版本号；


  ◆内存及磁盘资源分配：

     ⑴client_body_in_file_only on|clean|off;

         HTTP的包体是否存储在磁盘文件中；非off表示存储，即使包体大小为0也会创建一个磁盘文件；on表示请求结束后包体文件不会被删除，clean表示会被删除；

     ⑵client_body_in_single_buffer on|off;

         HTTP的包体是否存储在内存buffer当中；默认为off；

     ⑶cleint_body_buffer_size size;

         nginx接收HTTP包体的内存缓冲区大小；若包体超出该值，则会写入磁盘文件中

     ⑷client_body_temp_path dir-path [level1 [level2 [level3]]];

         HTTP包体存放的临时目录；

         例如：client_body_temp_path /var/tmp/client/ 1 2;

            后面的数字表示十六制的位数；此语句表示在/var/tmp/client目录下创建16个一级子目录，然后在每个一级子目录下创建16*16个二级子目录

     ⑸client_header_buffer_size size;

         正常情况下接收用户请求的http报文header部分时分配的buffer大小；默认为1k

     ⑹large_client_header_buffers number size; 

         存储超大Http请求首部的内存buffer大小及个数；

     ⑺connection_pool_size size;

         nginx对于每个建立成功的tcp连接都会预先分配一个内存池，此处即用于设定此内存池的初始大小；默认为256

     ⑻request_pool_size size;

         nginx在处理每个http请求时会预先分配一个内存池，此处即用于设定此内存池的初始大小；默认为4k


  ◆http核心模块的内置变量：

     $uri: 当前请求的uri，不带参数；

     $request_uri: 请求的uri，带完整参数；

     $host: http请求报文中host首部；如果请求中没有host首部，则以处理此请求的虚拟主机的主机名代替；

     $hostname: nginx服务运行在的主机的主机名；

     $remote_addr: 客户端IP

     $remote_port: 客户端Port

     $remote_user: 使用用户认证时客户端用户输入的用户名；

     $request_filename: 用户请求中的URI经过本地root或alias转换后映射的本地的文件路径；

     $request_method: 请求方法

     $server_addr: 服务器地址

     $server_name: 服务器名称

     $server_port: 服务器端口

     $server_protocol: 服务器向客户端发送响应时的协议，如http/1.1, http/1.0

     $scheme: 在请求中使用scheme, 如https://www.magedu.com/中的https；

     $http_HEADER: 匹配请求报文中指定的HEADER，$http_host匹配请求报文中的host首部

     $sent_http_HEADER: 匹配响应报文中指定的HEADER，例如$http_content_type匹配响应报文中的content-type首部；

     $document_root：当前请求映射到的root配置；


四、nginx作为web server的其它功能

  1、访问控制（http_access_module）

      allow address | CIDR | unix: | all;

      deny address | CIDR | unix: | all;

      缺省是allow all

      示例：

         location / {
           deny   192.168.1.1;
           allow  192.168.1.0/24;
           allow  10.1.1.0/16;
           deny   all;6
         }

  2、用户认证（http_auth_basic_module)

      auth_basic string | off;

      auth_basic_user_file file;

      示例：

         location /admin/ {

           root /www/b.org;

           auth_basic "admin area";

           auth_basic_user_file /etc/nginx/.htpasswd;

         }

  3、当无默认主页时显示文件列表，常用于建立下载站点（http_autoindex_module）

      autoindex on | off;

  4、防盗链（http_referer_module）

    ⑴定义合规的引用

       valid_referers none | blocked | server_names | string ...;

       说明：

          none：缺少“Referer”请求头；

          blocked：“Referer” 请求头存在，但是它的值被防火墙或者代理服务器删除； 这些值都不以“http://” 或者 “https://”字符串作为开头；

          server_names：“Referer” 请求头包含某个虚拟主机名；

          string可以是：

            任意字符串：定义一个服务器名和可选的URI前缀。服务器名允许在开头或结尾使用“*”符号。 当nginx检查时，“Referer”请求头里的服务器端口将被忽略。

            正则表达式：必须以“~”符号作为开头。 需要注意的是表达式会从“http://”或者“https://”之后的文本开始匹配

        示例：

           valid_referers none blocked server_names
              *.example.com example.* www.example.org/galleries/
              ~\.google\.;

    ⑵拒绝不合规的引用

       if ($invalid_referer) {

         rewrite ^/.*$ http://www.b.org/403.html;

        }


  5、URL重写（http_rewrite_module）

    ⑴rewrite regex replacement [flag];

       如果URI能匹配指定的正则表达式，此URI将被replacement参数定义的字符串改写。如果replacement的字符串以“http://”或“https://”开头，nginx将结束执行过程，并返回给客户端一个重定向。

       flag参数可以是：

         ①last：一旦被当前规则匹配并重写后立即停止检查后续的其它rewrite的规则，而后通过重写后的规则重新发起请求

         ②break：一旦被当前规则匹配并重写后立即停止检查后续的其它rewrite的规则，而后继续由nginx进行后续操作；

         ③redirect：返回302临时重定向，浏览器会显示跳转后的URL地址

         ④permanent：返回301永久重定向，浏览器会显示跳转后的URL地址。

       注意：

         last和break只是实现URL重写，浏览器地址栏中的URL地址不变，这与重定向不同。

         一般将rewrite写在location中时都使用break标志，或者将rewrite写在if上下文中


         如果replacement字符串包括新的请求参数，以往的请求参数会添加到新参数后面。如果不希望这样，在replacement字符串末尾加一个问号“？”，就可以避免，例如：

           rewrite ^/users/(.*)$ /show?user=$1? last;

         如果正则表达式中包含字符“}”或者“;”，整个表达式应该被包含在单引号或双引号的引用中，因这两个符号在nginx配置文件中有特殊意义。 

        示例：

          location / {

            root /www/b.org;

            rewrite ^/p_w_picpaths/(.*)$ /imgs/$1 last; 

            rewirte ^/imgs/(.*)$ /p_w_picpaths/$1 last;

          }

        上述用法会造成nginx重复10轮循环，然后返回错误500，应将last换成break


    ⑵rewrite_log on|off;

        是否把重写过程记录在错误日志中，默认为off；若开启，默认为notice级别；

    ⑶return code [text];
      return code URL;
      return URL;

        用于结束rewrite规则，并且为客户返回状态码；可以使用的状态码有204, 400, 402-406, 500-504等；

    ⑷if (condition) { ... }

        示例：

          if ($http_user_agent ~ MSIE) {
             rewrite ^(.*)$ /msie/$1 break;
          }
          if ($invalid_referer) {
             return 403;
          }


  6、查看nginx基本状态信息（http_stub_status_module，非标准模块，需在编译安装nginx时指定）

       location /basic_status {

          stub_status on;

       }