# nginx config配置记录

9 min read
old_website
Table of Contents

config文件结构

...              #全局块


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块：配置请求的路由，以及各种页面的处理情况。

💬 回复: Jun (2021-10-19)

示例：

########### 每个指令必须有分号结束。#################
#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
        }
    }
}

💬 回复: Jun (2021-10-19)

https://www.cnblogs.com/knowledgesea/p/5175711.html

💬 回复: Jun (2021-10-19)

server：用于进行服务器访问信息的配置.

srever模块配置是http模块中的一个子模块，用来定义一个虚拟访问主机，也就是一个虚拟服务器的配置信息
server {
　　listen 80;
　　server_name localhost 192.168.1.100;
　　root /nginx/www;
　　index index.php index.html index.html;
　　charset utf-8;
　　access_log logs/access.log;
　　error_log logs/error.log;
　　......
}


server：一个虚拟主机的配置，一个http中可以配置多个server


server_name：用力啊指定ip地址或者域名，多个配置之间用空格分隔


root：表示整个server虚拟主机内的根目录，所有当前主机中web项目的根目录


index：用户访问web网站时的全局首页


charset：用于设置www/路径中配置的网页的默认编码格式


access_log：用于指定该虚拟主机服务器中的访问记录日志存放路径


error_log：用于指定该虚拟主机服务器中访问错误日志的存放路径

location：用于进行访问路由的配置

1 复制代码
 2 location模块是nginx配置中出现最多的一个配置，主要用于配置路由访问信息在路由访问信息配置中关联到反向代理、负载均衡等等各项功能，所以location模块也是一个非常重要的配置模块
 3
 4 location / {
 5 　　root /nginx/www;
 6 　　index index.php index.html index.htm;
 7 }
 8
 9 location /：表示匹配访问根目录
10
11 root：用于指定访问根目录时，访问虚拟主机的web目录
12
13 index：在不指定访问具体资源时，默认展示的资源文件列表
14
19 location /api {
20             proxy_pass http://www.baidu.com;
21             #以下是一些反向代理的配置可删除
22             proxy_redirect     off;
23             #后端的Web服务器可以通过X-Forwarded-For获取用户真实IP
24             proxy_set_header   Host $host;
25             proxy_set_header   X-Real-IP $remote_addr;
26             proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
27             client_max_body_size       10m; #允许客户端请求的最大单文件字节数
28             client_body_buffer_size    128k; #缓冲区代理缓冲用户端请求的最大字节数
29             proxy_connect_timeout      300; #nginx跟后端服务器连接超时时间(代理连接超时)
30             proxy_send_timeout         300; #后端服务器数据回传时间(代理发送超时)
31             proxy_read_timeout         300; #连接成功后，后端服务器响应时间(代理接收超时)
32             proxy_buffer_size          4k; #设置代理服务器（nginx）保存用户头信息的缓冲区大小
33             proxy_buffers              4 32k; #proxy_buffers缓冲区，网页平均在32k以下的话，这样设置
34             proxy_busy_buffers_size    64k; #高负荷下缓冲大小（proxy_buffers*2）
35             proxy_temp_file_write_size 64k; #设定缓存文件夹大小，大于这个值，将从upstream服务器传
36     }

upstream：用于进行负载均衡的配置.

upstream模块主要负责负载均衡的配置，通过默认的轮询调度方式来分发请求到后端服务器


　　upstream name {
　　　　ip_hash;
　　　　server 192.168.1.100:8000;
　　　　server 192.168.1.100:8001 down;
　　　　server 192.168.1.100:8002 max_fails=3;
　　　　server 192.168.1.100:8003 fail_timeout=20s;
　　　　server 192.168.1.100:8004 max_fails=3 fail_timeout=20s;
　　}






ip_hash：指定请求调度算法，默认是weight权重轮询调度，可以指定
server host:port：分发服务器的列表配置
-- down：表示该主机暂停服务
-- max_fails：表示失败最大次数，超过失败最大次数暂停服务
-- fail_timeout：表示如果请求受理失败，暂停指定的时间之后重新发起请求

nginx基本命令

强制停止nginx服务器，如果有未处理的数据，丢弃
nginx -s stop


停止nginx服务器，如果有未处理的数据，等待处理完成之后停止
nginx -s quit


重启nginx服务器
nginx -s reload
Comments