Nginx 之基础配置解释

作者：Gakki

---

配置文件结构

• nginx 的配置文件在 /nginx/conf/nginx.conf 下，打开文件可看到目录结构大致为：

...              #全局块

events {         #events块
   ...
}

http      #http块
{
    ...   #http全局块
    server        #server块
    { 
        ...       #server全局块
        location [PATTERN]   #location块
        {
            ...
        }
    }
    # 负载均衡配置
    upstream name {                    
        ....
    }
}

• 简化版：

main
events {...}
http {
    server {
        location{..}
    }
    upstream {...}
}   

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

通过配置文件解释模块

 #配置用户或者组，默认为nobody nobody。
user administrator administrators;
 
 #允许生成的进程数，默认为1
worker_processes 2; 

#指定nginx进程运行文件存放地址
pid /nginx/pid/nginx.pid;   

#制定日志路径，级别。这个设置可以放入全局块，http块，server块，级别以此为：debug|info|notice|warn|error|crit|alert|emerg
error_log log/error.log debug;  

# event 块：
events {
     # 设置网路连接序列化，防止惊群现象发生，默认为on
    accept_mutex on;  
  
    # 设置一个进程是否同时接受多个网络连接，默认为off
    multi_accept on; 

    # 事件驱动模型，select|poll|kqueue|epoll|resig|/dev/poll|eventport
    # use epoll;  
    
    # 最大连接数，默认为512
    worker_connections  1024;    
}

# http 块：
http {
    
    # 文件扩展名与文件类型映射表
    include       mime.types;   
    
    # 默认文件类型，默认为text/plain
    default_type  application/octet-stream; 
    
    # 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';
    
    # combined为日志格式的默认值
    access_log log/access.log myFormat;  
    
     # 允许sendfile方式传输文件，默认为off，可以在http块，server块，location块。
    sendfile on;  

    # 每个进程每次调用传输数量不能大于设定的值，默认为0，即不设上限。
    sendfile_max_chunk 100k;  

    # 连接超时时间，默认为75s，可以在http，server，location块。
    keepalive_timeout 65;  

    # 负载均衡配置
    upstream mysvr {   
      server 127.0.0.1:7878;
      server 192.168.10.121:3333 backup;  #热备
    }
    
    # 错误页
    error_page 404 https://www.baidu.com; 

    # server 块：
    server {

        # 单连接请求上限次数。
        keepalive_requests 120;

        # 监听端口
        listen       4545;  
        
        # 监听地址       
        server_name  127.0.0.1;    

        # location 块：
        # 请求的url过滤，正则匹配，~为区分大小写，~*为不区分大小  写。
        location  ~*^.+$ {       
           # 根目录
           # root path;  
          
           # 设置默认页
           #index index.htm index.html;  

          # 请求转向mysvr 定义的服务器列表
           proxy_pass  http://mysvr;  

           # 拒绝的ip
           deny 127.0.0.1; 

          # 允许的ip    
           allow 172.18.5.54;        
        } 
    }
}

• 注：
  1. 每个指令必须以 ; 结束，指令与参数间以空格符号分隔；
  2. 指令块用 {} 将多条指令集合在一起；
  3. 可以使用 include 语句引进其他配置文件；
  4. 使用 # 添加注释；
  5. 通过 $ 使用变量；
  6. 部分指令参数支持正则，例如 location 指令。