nginx 官网 nginx官网操作手册

Nginx使用手册

一、简介

  Nginx是一个使用C语言开发的高性能的服务器，其内核微小，功能简洁，主要是通过扩展各种模块来完成一些额外的功能。通常我们可以把Nginx用作页面静态服务器、反向代理服务器、负载均衡服务器等。

二、windows下安装运行

1.下载安装

2. 官网：http://nginx.org/en/download.html



4. 下载后加压到一个自定义目录即可。此时，双击文件夹内的nginx.exe，即可启动nginx。启动后在本机任务管理器看到nginx的一个主进程和生成了一个工作进程。



5. 打开浏览器，在地址栏输入http://localhost，可以看到nginx的默认欢迎页面

2.加入开机运行服务

1. 下载Windows Service Wrapper工具
   地址：https://github.com/winsw/winsw/releases/tag/v2.11.0
2. 下载后将该工具放入Nginx的安装目录下，并且将其重命名为： nginx-service.exe ；
3. 在nginx安装目录下新建服务日志文件夹server-logs文件夹,用来存放nginx服务相关日志。
4. 在nginx安装目录下新建 nginx-service.xml 文件，写入配置信息，配置好了之后就可以通过这个将Nginx注册为Windows服务了。

<service>
<id>nginx</id>
<name>nginx</name>
<description>nginx</description>
<logpath>D:\tools\nginx-1.22.0\server-logs</logpath>
<logmode>roll</logmode>
<depend></depend>
<executable>D:\tools\nginx-1.22.0\nginx.exe</executable>
<stopexecutable>D:\tools\nginx-1.22.0\nginx.exe -s stop</stopexecutable>
</service>

5. 把nginx加入到windows服务中
   以上内容配置好了之后，在nginx安装目录下以管理员运行命令：.\nginx-service.exe install 就成功将其注册为Windows服务了。这时我们就可以在Windows任务管理器的服务中查看到nginx服务了。

2.常规重启

如果配置或者部署的页面代码有了修改后，可以在cmd下安全地（处理完当前所有请求后）重启服务，使用nginx -s reload

三、基本配置

1. nginx配置文件

  nginx通过配置文件来灵活定制用户需要的功能，配置文件默认在安装目录下的conf文件夹下的nginx.conf。其它配置文件都是引入到nginx.conf中起作用的。

2. nginx配置文件结构

...              #全局块

events {         #events块
   ...
}

http      #http块
{
    ...   #http全局块
    server        #server块
    { 
        ...       #server全局块
        location [PATTERN]   #location块
        {
            ...
        }
        location [PATTERN] 
        {
            ...
        }
    }
    server
    {
      ...
    }
    ...     #http全局块
}

1. 全局块：配置影响nginx全局的指令。一般有运行nginx服务器的用户组，nginx进程pid存放路径，日志存放路径，配置文件引入，允许生成worker process数等。
2. events块：配置影响nginx服务器或与用户的网络连接。有每个进程的最大连接数，选取哪种事件驱动模型处理连接请求，是否允许同时接受多个网路连接，开启多个网络连接序列化等。
3. http块：可以嵌套多个server，配置代理，缓存，日志定义等绝大多数功能和第三方模块的配置。如文件引入，mime-type定义，日志自定义，是否使用sendfile传输文件，连接超时时间，单连接请求数等。
4. server块：配置虚拟主机的相关参数，一个http中可以有多个server。
5. location块：配置请求的路由，以及各种页面的处理情况。

3. 配置案例

########### 每个指令必须有分号结束。#################
#user administrator administrators;  #配置用户或者组，默认为nobody nobody。
#worker_processes 2;  #允许生成的进程数，默认为1
#pid /nginx/pid/nginx.pid;   #指定nginx进程运行文件存放地址
error_log log/error.log debug;  #制定日志路径，级别。这个设置可以放入全局块，http块，server块，级别以此为：debug|info|notice|warn|error|crit|alert|emerg
events {
    accept_mutex on;   #设置网路连接序列化，防止惊群现象发生，默认为on
    multi_accept on;  #设置一个进程是否同时接受多个网络连接，默认为off
    #use epoll;      #事件驱动模型，select|poll|kqueue|epoll|resig|/dev/poll|eventport
    worker_connections  1024;    #最大连接数，默认为512
}
http {
    include       mime.types;   #文件扩展名与文件类型映射表
    default_type  application/octet-stream; #默认文件类型，默认为text/plain
    #access_log off; #取消服务日志    
    log_format myFormat '$remote_addr–$remote_user [$time_local] $request $status $body_bytes_sent $http_referer $http_user_agent $http_x_forwarded_for'; #自定义格式
    access_log log/access.log myFormat;  #combined为日志格式的默认值
    sendfile on;   #允许sendfile方式传输文件，默认为off，可以在http块，server块，location块。
    sendfile_max_chunk 100k;  #每个进程每次调用传输数量不能大于设定的值，默认为0，即不设上限。
    keepalive_timeout 65;  #连接超时时间，默认为75s，可以在http，server，location块。

    upstream mysvr {   
      server 127.0.0.1:7878;
      server 192.168.10.121:3333 backup;  #热备
    }
    error_page 404 https://www.baidu.com; #错误页
    #负载均衡&反向代理案例
    server {
        keepalive_requests 120; #单连接请求上限次数。
        listen       4545;   #监听端口
        server_name  127.0.0.1;   #监听地址       
        location  ~*^.+$ {       #请求的url过滤，正则匹配，~为区分大小写，~*为不区分大小写。
           #root path;  #根目录
           #index vv.txt;  #设置默认页
           proxy_pass  http://mysvr;  #请求转向mysvr 定义的服务器列表
           deny 127.0.0.1;  #拒绝的ip
           allow 172.18.5.54; #允许的ip           
        } 
    }
    #静态页面服务器案例
    server {
        listen 80; #监听80端口
        server_name localhost; #监听请求地址
        location /pcs { #请求url过滤，只有/pcs开头的才能进入
            root packge/pcs; #页面的入口路径在nginx安装目录下的packge
            index index.html; #入口页面
        }
    }
}

四、常用命令

nginx -s reopen #重启Nginx
nginx -s reload #重新加载Nginx配置文件，然后以优雅的方式重启Nginx
nginx -s stop #强制停止Nginx服务
nginx -s quit #优雅地停止Nginx服务（即处理完所有请求后再停止服务）
nginx -t #检测配置文件是否有语法错误，然后退出
nginx -?,-h #打开帮助信息
nginx -v #显示版本信息并退出
nginx -q #在检测配置文件期间屏蔽非错误信息
nginx -c filename #设置配置文件

五、nginx的主要事件驱动模型介绍

1. select

  支持windows和linux

1. 创建所关注事件的描述符集合，对于一个描述符，可以关注其上面的读(Read)事件、写(Write)事件以及异常发生(Exception)事件。
   在select模型中，要创建这3类事件描述符集合。
2. 调用底层提供的select()函数，等待事件发生。
3. 轮询所有事件描述符集合中的每一个事件描述符，检查是否有相应的事件发生，如果有就进行处理。

2. poll

  Linux平台上的事件驱动模型,不支持Windows,在Linux2.1.23中引入,和select模型工作方式基本相同，区别在于，select模型创建了3个描述符集合，而poll模型只创建一个描述符集合,每个描述符中包含了读、写和异常发生事件

3. epoll

  poll模型的变种，在Linux2.5.44中引入。epoll比poll更加高效，原因在于它不需要轮询整个描述符集合，而是将要关注的事件写入Linux内核，当有变动时，内核会发来通知。

六、upstream模块负载均衡算法配置介绍

1. 基本参数

  这些基本参数可以和负载均衡算法结合使用

1. down
   表示当前server暂时不参与负载均衡。

upstream test.cn {
    server  192.0.2.1;
    server  192.0.2.2 down;
}
server {
    location / {
        proxy_pass http://test.cn;
    }

2. backup
   预留的备份机器。当其他所有的非backup机器出现故障或者忙的时候，才会请求backup机器，因此这台机器的压力最轻。

upstream test.cn {
    server  192.0.2.1;
    server  192.0.2.2 backup;
}
server {
    location / {
        proxy_pass http://test.cn;
    }

3. max_fails
   允许请求失败的次数，默认为1。当超过最大次数时，返回错误。

upstream test.cn {
    server  192.0.2.1;
    server  192.0.2.2 max_fails=2;
}
server {
    location / {
        proxy_pass http://test.cn;
    }

4. fail_timeout
   在经历了max_fails次失败后，暂停服务的时间单位秒。max_fails可以和fail_timeout一起使用。

upstream test.cn {
    server  192.0.2.1;
    server  192.0.2.2 max_fails=2 fail_timeout=2;
}
server {
    location / {
        proxy_pass http://test.cn;
    }

2. 负载均衡算法–轮询

  这是upstream默认使用的算法，不加额外配置即可。它将客户端请求依次顺序地分配给服务器。

upstream test.cn {
    server  192.0.2.1;
    server  192.0.2.2;
}
server {
    location / {
        proxy_pass http://test.cn;
    }

3. 负载均衡算法–最少连接数

  对那些连接数少的服务器(正在处理的请求数少), 分配更多的请求。

upstream test.cn {
    least_conn;
    server  192.0.2.1;
    server  192.0.2.2;
}
server {
    location / {
        proxy_pass http://test.cn;
    }

4. 负载均衡算法–权重算法

  给服务器分配权重值, 权重值越大, 分配更多的请求。

upstream test.cn {
    server  192.0.2.1 weight=30;
    server  192.0.2.2 weight=70;
}
server {
    location / {
        proxy_pass http://test.cn;
    }

5. 负载均衡算法–ip哈希散列算法

  包含映射关系, 将一组客户端的ip映射到某个指定服务器，即对于同一个ip过来的请求，会固定访问对应的服务器

upstream test.cn {
    ip_hash;
    server  192.0.2.1;
    server  192.0.2.2;
}
server {
    location / {
        proxy_pass http://test.cn;
    }