当前位置： 首页 > news >正文

Nginx的主要配置文件nginx.conf详细解读——及其不间断重启nginx服务等操作

news 2025/8/30 8:06:53

一、Nginx的配置文件nginx.conf解析

1.1、查看现有已安装的Nginx版本及其编译配置参数等信息

查看现在已有使用的Nginx版本及其编译配置参数等信息
序号安装编译Nginx的方式查看现在已有的Nginx版本及其编译配置参数信息方法
1使用【yum install nginx -y】命令安装的Nginx 
#查看yum命令安装的Nginx对应版本及其配置参数信息#0-查看当前运行的nginx二进制文件所在路径
ps -ef | grep nginx
#0.0-查看包含nginx的所有路径命令
whereis nginx#1-查看当前运行的nginx版本积极配置参数等信息命令
nginx -V
2手动到Nginx官网下载源码编译安装的Nginx 
#查看手动到官网下载源码安装的Nginx对应版本及其配置参数等信息#0-查看当前运行的nginx二进制文件所在路径命令
ps -ef | grep nginx
#0.0-查看包含nginx的所有路径命令
whereis nginx#1-进入Nginx的安装目录（比如：/usr/local/nginx/sbin）命令
cd /usr/local/nginx/sbin#2-使用nginx的二进制文件查看命令
./nginx -V

 1.2、Nginx的主要配置文件解析

        Nginx在安装完成后，默认的安装路径是【/usr/local/nginx】其中【/usr/local/nginx/conf】是配置文件路径，该路径下的【nginx.conf】是Nginx的主要配置文件：

Nginx的主要配置文件nginx.conf解析
序号nginx主要配置文件组成说明
1mainmain设置的指令会影响其他所有设置，相当于全局设置。
2eventsevents模块用来配置影响nginx服务器或与用户的网络连接。
3httphttp模块可以嵌套多个server，主要用来配置代理、缓存、自定义日志格式等绝大多数功能和第三方模块的配置。
4serverserver模块用于配置虚拟主机的相关参数内容。
5locationlocation模块用于配置请求的处理规则，以及各种页面的处理情况。

该表格中这五个模块之间的关系是：

《1》main与events平级；

《2》一个http中可以有多个server；

《3》server继承main，location继承server。

user  www;
worker_processes  2;
worker_cpu_affinity 01 10;
worker_rlimit_nofile 131070;
pid        logs/nginx.pid;
error_log  logs/error.log  notice;#error_log  logs/error.log;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;#pid        logs/nginx.pid;events {use epoll;worker_connections  65535;
}http {include       mime.types;default_type  application/octet-stream;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;sendfile        on;tcp_nopush     on;tcp_nodelay    on;#keepalive_timeout  0;keepalive_timeout  65;server_names_hash_bucket_size 128;client_max_body_size 20m;client_header_buffer_size 32k;large_client_header_buffers 4 32k;gzip  on;gzip_min_length 1k;gzip_buffers    4    16k;gzip_http_version 1.1;gzip_comp_level 2;gzip_types text/plain application/x-javascript text/css application/xml;gzip_vary on;server {listen       80;server_name  localhost 192.168.1.11;#charset koi8-r;access_log  logs/host.access.log  main;location / {root   html;index  index.html index.htm;}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;}# proxy the PHP scripts to Apache listening on 127.0.0.1:80##location ~ \.php$ {#    proxy_pass   http://127.0.0.1;#}# pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000##location ~ \.php$ {#    root           html;#    fastcgi_pass   127.0.0.1:9000;#    fastcgi_index  index.php;#    fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;#    include        fastcgi_params;#}# deny access to .htaccess files, if Apache's document root# concurs with nginx's one##location ~ /\.ht {#    deny  all;#}}# another virtual host using mix of IP-, name-, and port-based configuration##server {#    listen       8000;#    listen       somename:8080;#    server_name  somename  alias  another.alias;#    location / {#        root   html;#        index  index.html index.htm;#    }#}# HTTPS server##server {#    listen       443 ssl;#    server_name  localhost;#    ssl_certificate      cert.pem;#    ssl_certificate_key  cert.key;#    ssl_session_cache    shared:SSL:1m;#    ssl_session_timeout  5m;#    ssl_ciphers  HIGH:!aNULL:!MD5;#    ssl_prefer_server_ciphers  on;#    location / {#        root   html;#        index  index.html index.htm;#    }#}}

 1.3、Nginx的全局配置项解析

Nginx的全局配置项解析
序号nginx的全局配置项说明
1user

指定Nginx Worker进程运行用户以及用户组。

默认由nobody账号运行，一般指定用www用户和组运行。

2worker_processes

设置nginx工作的进程数，一般来说，设置成CPU核的数量即可，这样可以充分利用CPU资源。

#查看cpu的详细信息命令：
lscpu#快速查看可用的逻辑 CPU 核心数量
nproc#统计逻辑核心总数
grep ^processor /proc/cpuinfo | wc -l
cat /proc/cpuinfo | grep "processor" | wc -l

注意：在nginx1.10版本后，worker_processes指令新增了一个配置值auto，它表示nginx会自动检测CPU核数并打开相同数量的worker进程。

3worker_cpu_affinity

此指令可将Nginx工作进程与指定CPU核绑定，降低由于多核CPU切换造成的性能损耗。

worker_cpu_affinity使用方法是通过1、0来表示的，CPU有多少个核？就有几位数，1代表内核开启，0代表内核关闭。

#有一个4核的服务器，那么nginx配置中worker_processes、worker_cpu_affinity的写法如下：
worker_processes  4;
worker_cpu_affinity 0001 0010 0100 1000;

示例配置表示：4核CPU，开启4个进程，每个进程都与CPU的每个核进行绑定。其中，0001表示开启第一个cpu内核，0010表示开启第二个cpu内核，其它含义依次类推。如果是8核CPU，绑定第一个CPU核，可以写成00000001，绑定第二个CPU核，可以写成00000010，依次类推。
worker_cpu_affinity指令一般与worker_processes配合使用，以充分发挥nginx的性能优势。

4error_log

用来定义全局错误日志文件。

        日志输出级别有debug、info、notice、warn、error、crit可供选择，其中，debug输出日志最为最详细，而crit输出日志最少。 

5pid用来指定nginx进程id的存储文件位置。
6worker_rlimit_nofile

用于指定一个Nginx进程可以打开的最多文件描述符数目。

设置为65535，需要使用命令“ulimit -n 65535”来设置。

7events

设定Nginx的工作模式及连接数上限。

       《1》参数【use】用来指定Nginx的工作模式，Nginx支持的工作模式有select、poll、kqueue、epoll、rtsig和/dev/poll。其中select和poll都是标准的工作模式，kqueue和epoll是高效的工作模式，对于Linux系统，epoll工作模式是首选。

       《2》参数【worker_connections】用于定义Nginx每个进程的最大连接数，默认是1024。在一个纯Nginx（无反向代理应用）应用中，最大客户端连接数由worker_processes和worker_connections决定，即为：max_client=worker_processes*worker_connections。
    进程的最大连接数受Linux系统进程的最大打开文件数限制，在执行操作系统命令“ulimit -n 65536”后worker_connections的设置才能生效。

 1.4、HTTP服务器配置解析

HTTP服务器配置解析
序号HTTP的配置项说明
1include是个主模块指令，实现对配置文件所包含的文件的设定，可以减少主配置文件的复杂度。类似于Apache中的include方法。
2default_type

属于HTTP核心模块指令，这里设定默认类型为二进制流，也就是当文件类型未定义时使用这种方式。

        （如：在没有配置PHP环境时，Nginx是不予解析的，此时，用浏览器访问PHP文件就会出现下载窗口）。

3log_format

用于指定Nginx日志的输出格式。

        main为此日志输出格式的名称，可以在下面的access_log指令中引用。

4sendfile

用于开启高效文件传输模式【on表示开启】。

        将tcp_nopush和tcp_nodelay两个指令设置为on用于防止网络阻塞

5keepalive_timeout设置客户端连接保持活动的超时时间。在超过这个时间之后，服务器会关闭该连接。时间单位是秒。
6server_names_hash_bucket_size

为了提高快速寻找到相应server name的能力，Nginx使用散列表来存储server name，而server_names_hash_bucket_size就是设置每个散列桶占用的内存大小。

        server_names_hash_bucket_size 128

7client_max_body_size用来设置允许客户端请求的最大的单个文件字节数（如：设置为30m）
8client_header_buffer_size

用于指定来自客户端请求头的header  buffer大小。

        对于大多数请求，1K的缓冲区大小已经足够，如果自定义了消息头或有更大的Cookie，可以增加缓冲区大小；如设置为32K。

9large_client_header_buffers 

用来指定客户端请求中较大的消息头的缓存最大数量和大小。

        large_client_header_buffers 4 128k;表示“4”为个数，“128K”为大小，最大缓存量为4个128K。

 1.5、HttpGzip模块配置解析

HttpGzip模块配置解析
序号HttpGzip模块配置项说明
1gzip on用于设置开启或者关闭gzip模块，“gzip on”表示开启GZIP压缩，实时压缩输出数据流。
2gzip_min_length 1k

设置允许压缩的页面最小字节数，页面字节数从header头的Content-Length中获取。默认值是0，不管页面多大都进行压缩。

        建议设置成大于1k的字节数，小于1k可能会越压越大。

3gzip_buffers 4 16k表示申请4个单位为16K的内存作为压缩结果流缓存，默认是申请与原始数据大小相同的内存空间来存储gzip压缩结果。
4gzip_http_version  1.1用于设置识别HTTP协议版本，默认是1.1，目前大部分浏览器已经支持GZIP解压，使用默认即可。
5gzip_comp_level  2用来指定GZIP压缩比，1表示压缩比最小，处理速度最快；9表示压缩比最大，传输速度快，但处理最慢，也比较消耗CPU资源。
6gzip_typestext/plain application/x-javascript text/css application/xml：用来指定压缩的类型，无论是否指定，“text/html”类型总是会被压缩的。

 1.6、server虚拟主机配置解析

server虚拟主机配置解析
序号server虚拟主机配置项说明
1server定义虚拟主机开始的关键字。
2listen用于指定虚拟主机的服务端口。
3server_name用来指定IP地址或域名，多个域名之间用空格分开。
4index用于设定访问的默认首页地址。
5root用于指定虚拟主机的网页根目录，这个目录可以是相对路径，也可以是绝对路径。
6access_log用来指定此虚拟主机的访问日志存放路径，最后的main用于指定访问日志的输出格式。
7error_page

指令可以定制各种错误信息的返回页面。在默认情况下，Nginx会在主目录的html目录中查找指定的返回页面。

        特别需要注意的是，这些错误信息的返回页面的大小一定要超过512K，否者会被IE浏览器替换为IE默认的错误页面。

二、Nginx的管理与维护

 2.1、检查Nginx配置文件的正确性

#检查Nginx配置文件的正确性的方法一
/usr/local/nginx/sbin/nginx -t#检查Nginx配置文件的正确性的方法二（“-t”参数用于检查配置文件是否正确，但并不执行。“-c”参数用于指定配置文件路径，如果不指定配置文件路径，Nginx默认会在安装时指定的安装目录下查找conf/nginx.conf文件）
/usr/local/nginx/sbin/nginx -t -c /usr/local/nginx/conf/nginx.conf

注意：如果在验证nginx.conf配置文件提示“

nginx: [emerg] getpwnam("www") failed in /usr/local/nginx/conf/nginx.conf:2
nginx: configuration file /usr/local/nginx/conf/nginx.conf test failed”错误时，意味着名为【www】的用户找不到，导致验证这个nginx.conf配置文件失败。解决方法是创建www用户和组：

#1-创建【www】用户和组
useradd www#2-查看【www】用户的uid、gid和组信息
id www

解决报错问题后再次验证【/usr/local/nginx/conf/nginx.conf】配置文件是否正确，如下图验证后显示“

nginx: the configuration file /usr/local/nginx/conf/nginx.conf syntax is ok
nginx: configuration file /usr/local/nginx/conf/nginx.conf test is successful

”信息表示配置文件的内容没有问题。

 2.2、Nginx服务的优雅启动、关闭和重启

控制Nginx服务的优雅的启动、关闭与重启的信号
序号控制nginx服务的信号说明
1QUIT表处理完当前请求后，关闭进程。
2HUP

表示重新加载配置，也就是关闭原有的进程，并开启新的工作进程。

此操作不会中断用户的访问请求，因此可以通过此信号平滑的重启Nginx。

3USR1

用于Nginx的日志切换，也就是重新打开一个日志文件。

（如：每天要生成一个新的日志文件时，可以使用这个信号来控制）。 

4USR2用于平滑升级可执行程序。
5WINCH从容关闭工作进程，与QUIT类似。
#0-查看正在运行的nginx服务，并获取到nginx服务的父进程PID编号
ps -ef | grep nginx#1-不间断服务地重新启动Nginx（kill -HUP Nginx的父进程PID编号）
kill -HUP 13561#2-处理完请求后再关闭nginx服务（kill -QUIT Nginx的父进程PID编号）
kill -QUIT 13561#3-启动nginx服务
/usr/local/nginx/sbin/nginx
#3.1-重启nginx服务
systemctl start nginx


#也可以强制杀死nginx服务然后在重启#1-强制杀死nginx服务，不管该nginx有没有在处理业务请求
killall -9 nginx#2-查看当前nginx服务的进程信息
ps -ef | grep nginx#3-新启动nginx服务
systemctl start nginx

三、其他相关资料

使用源码安装配置Linux上的Web服务器——Nginxhttps://coffeemilk.blog.csdn.net/article/details/150780215Linux系统必学的基础操作命令——快速上手Linux（下）https://coffeemilk.blog.csdn.net/article/details/149037758

http://www.dtcms.com/a/356991.html

相关文章：

  • 从Cloudflare到EdgeOne：我的个人站点加速之旅与性能对比实测
  • LeetCode Hot 100 Python (11~20)
  • 微服务入门指南（一）：从单体架构到服务注册发现
  • 将自己的jar包发布到maven中央仓库(2025-08-29)
  • 【Web安全】文件上传下载安全测试的全面剖析与实践指南
  • 如何在实际应用中选择Blaze或Apache Gluten？
  • 深入解析PCIe 6.0拓扑架构：从根复合体到端点的完整连接体系
  • 【国内电子数据取证厂商龙信科技】ES 数据库重建
  • shell命令扩展
  • Qt类-扩充_xiaozuo
  • ArcGIS Pro中 Nodata和nan 黑边的处理
  • 沃尔玛AI系统Wally深度拆解：零售业库存周转提速18%，动态定价争议与员工转型成热议点
  • 【lua】Lua 入门教程：从环境搭建到基础编程
  • Java深拷贝与浅拷贝核心解析
  • C primer plus (第六版）第十一章 编程练习第1，2，3，4题
  • typescript postgres@3.x jsonb数据插入绕过类型检测错误问题
  • Linux驱动学习-spi接口
  • 手写一个Spring框架
  • 【树论】树上启发式合并
  • ansible的playbook练习题
  • 短剧小程序系统开发：助力影视行业数字化转型
  • 算法---字符串
  • Speculation Rules API
  • PDF转图片工具实现
  • 天气查询系统
  • 2025_WSL2_Ubuntu20.04_C++20_concept 环境配置
  • el-select多选下拉框出现了e611
  • MySQL 中ORDER BY排序规则
  • 物联网平台中的Swagger（二）安全认证与生产实践
  • Socket编程核心API与结构解析