nginx核心配置文件及常用功能

配置文件说明

nginx官方帮助文档：http://nginx.org/en/docs/

nginx的配置文件的组成部分：

• 主配置文件：nginx.conf
• 子配置文件: include conf.d/*.conf
• fastcgi， uwsgi，cgi等协议相关的配置文件

配置文件格式说明

• 配置文件由指令与指令块构成
• 每条指令以;分号结尾，指令与值之间以空格符号分隔
• 可以将多条指令放在同一行，用分号分隔即可，但可读性差，不推荐
• 指令块以{}大括号将多条指令组织在一起，且可以嵌套指令块
• include语句允许组合多个配置文件以提升可维护性
• 使用#符号添加注释，提高可读性
• 使用$符号使用变量
• 部分指令的参数支持正则表达式

nginx配置文件中的变量

• 内置变量：由Nginx模块引入，可直接引用
• 自定义变量：由用户使用set命令定义，格式：set 变量名 值;
• 引用变量：$变量名

默认nginx.conf配置文件格式说明

# main配置段（全局配置）对全局生效，主要设置nginx的启动用户/组，启动的工作进程数量，工作模式，Nginx的PID路
user nginx nginx;  #运行的用户和用户组
worker_processes 1;  #worker进程数，根据硬件调整（通常设置为auto）
error_log   /var/log/nginx/error.log;  #错误日志存放目录
pid     /run/nginx.pid; #指定运行master主进程的pid文件存放路径
worker_priority 0; #工作进程优先级，-20~20(19)表示进程相对于其他进程的调度优先级。优先级值越低，进程的优先级越高，意味着它更有可能获得CPU时间，优先级范围通常是从 -20（最高优先级，也称为“最实时”优先级）到 19（最低优先级，也称为“最不实时”或“最空闲”优先级）
worker_rlimit_nofile  65536; #所有worker进程能打开的文件数量上限,包括:Nginx的所有连接（例如与代理服务器的连接等），而不仅仅是与客户端的连接。另一个考虑因素是实际的并发连接数不能超过系统级别的最大打开文件数的限制，最好与ulimit -n或者limits.conf的值保持一致
daemon off|on;    #用于控制Nginx是否应该以守护进程（daemon）的方式运行，off表示前台，on表示后台
master_process off|on;   #用于控制Nginx是否应该以主进程（master process）和工作进程（worker processes）的模型来运行，on设置告诉Nginx在启动时创建一个主进程和多个工作进程，off设置告诉Nginx不要创建主进程，而是直接以单个进程（即工作进程）的形式运行。这意味着Nginx将不会利用主进程和工作进程的模型include /usr/share/nginx/modules/*.conf;  #导入的外部文件位置#events配置段，主要影响nginx服务器与用户的网络连接，比如是否允许同时接受多个网络连接，使用哪种事件驱动模型处理请求，每个工作进程可以同时支持的最大连接数，是否开启对多工作进程下的网络连接进行序列化等
events {use epoll;   #使用epo11事件驱动模型，但不推荐配置它，让nginx自己选择。Nginx支持众多的事件驱动，比如:select、poll、epoll，只能设置在events模块中设置worker_connections 1024; #每个worker进程的最大连接数量(并发数)。作为web服务器的时候最大并发数为worker_connections*worker_processes；作为反向代理的时候为(worker_connections*worker_processes)/2accept_mutex on  #on为同一时刻一个请求轮流由work进程处理，为防止被同时唤醒所有worker，避免多个睡眠进程被唤醒的设置，默认为off。为on时新请求会唤醒所有worker进程,此过程也称为"惊群"。因此nginx刚安装完以后要进行适当的优化。建议设置为onmulti_accept on;  #on为Nginx服务器的每个工作进程可以同时接受多个新的网络连接，此指令默认为off，即默认为一个工作进程只能一次接受一个新的网络连接，打开后几个同接受多个。建议设置为on
}#http配置段，http块是nginx服务器配置中的重要部分，缓存、代理和日志格式定义等绝大多数功能和第三方模块都可以在这设置，http块可以包含多个server块，而一个server块中又可以包含多个location块，
http {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   /var/log/nginx/access.log    main; #访问日志存储位置error_log   /usr/local/nginx/logs/error.log   error;sendfile            on; #作为web服务器的时候打开sendfile加快静态文件传输，指定是否使用。sendfile系统调用在两个文件描述符之间直接传递数据(完全在内核中操作)，从而避免了数据在内核缓冲区和用户缓冲区之间的拷贝，操作效率很高，被称之为零拷贝tcp_nopush          on; #性能优化参数，数据是否立刻发送tcp_nodelay         on; #性能优化参数，小数据包是否延迟发送keepalive_timeout   65; #长连接超时时间，单位是秒types_hash_max_size 4096; #性能优化参数，影响散列表的冲率include             /etc/nginx/mime.types; #可解析的静态资源类型 default_type        application/octet-stream; #默认文件类型include   /etc/nginx/conf.d/*.conf;  #加载子配置项#server配置段，设置一个虚拟机主机，可以包含自己的全局快，同时也可以包含多个location模块server {listen       80;    #监听IPV4端口listen       [::]:80;   #监昕IPV6端口server_name  localhost;   #本server的名称，当访问此名称的时候，nginx会调用当前serevr内部的配置进行匹配root         /usr/share/nginx/html;   #网页默认目录include   /etc/nginx/default.d/*.conf;   #子配置文件存储路径#1ocation配置段，一般用来匹配不同的URI请求，location其实是server的一个指令，为nginx服务器提供比较多而且灵活的指令都是在location中体现的，主要是基于nginx接受到的请求字符串，对用户请求的URL进行匹配，并对特定的指令进行处理。另外很多第三方模块的配置也是在location模块中配置location / {root    /usr/share/nginx/html;  #相对路径网站根目录alias   /usr/share/nginx/html/; #绝对路径网站根目录index   index.html index.htm; #默认首页文件deny 172.168.22.11;   #禁止访问的ip地址，可以为a11allow 172.168.33.44;   #允许访问的ip地址，可以为a11autoindex on;   #开启目录文件列表autoindex_exact_size on;  #显示出文件的确切大小，单位是bytesautoindex_localtime on;   #显示的文件时间为文件的服务器时间charset utf-8,gbk;   #避免中文乱码auth_basic "xxxx";   #加密网页验证时的提示信息auth_basic_user_file   /路径/文件名;   #加密网页使用的密码验证文件}error_page 404 /404.html;  #状态码为404时返回给客户端的页面location = /404.html {}error_page 500 502 503 504 /50x.html; #50x错误返回给客户端的页面location = /50x.html {}}#和邮件相关的配置
#mail {
#         ...
# } mail 协议相关配置段#tcp代理配置，1.9版本以上支持
#stream {
#       ...
# } stream 服务器相关配置段
#导入其他路径的配置文件
#include /apps/nginx/conf.d/*.conf
}#https虚拟主机定义
# Settings for a TLS enabled server.
#
#    server {
#        listen       443 ssl http2;  #监听的IPV4端口
#        listen       [::]:443 ssl http2;
#        server_name  _;
#        root         /usr/share/nginx/html;   #网页默认目录
#
#        ssl_certificate "/etc/pki/nginx/server.crt";  #证书存储路径
#        ssl_certificate_key "/etc/pki/nginx/private/server.key";  #密钥存储
#        ssl_session_cache shared:SSL:1m;
#        ssl_session_timeout  10m;
#        ssl_ciphers PROFILE=SYSTEM;
#        ssl_prefer_server_ciphers on;
#
#        # Load configuration files for the default server block.
#        include /etc/nginx/default.d/*.conf;
#
#        error_page 404 /404.html;
#            location = /40x.html {
#        }
#
#        error_page 500 502 503 504 /50x.html;
#            location = /50x.html {
#        }
#    }
}

main全局配置

main 全局配置段常见的配置指令分类

• 正常运行必备的配置
• 优化性能相关的配置
• 用于调试及定位问题相关的配置
• 事件驱动相关的配置

user nginx nginx; #启动Nginx工作进程的用户和组
worker_processes [number | auto]; #启动Nginx工作进程的数量,一般设为和CPU核心数相同。为auto的话，有几个核，就有几个子进程
worker_cpu_affinity 00000001 00000010 00000100 00001000  #将Nginx工作进程绑定到指定的CPU核心，默认Nginx是不进行进程绑定的error_log   /var/log/nginx/error.log;  #错误日志存放目录
pid     /run/nginx.pid; #指定运行master主进程的pid文件存放路径worker_priority 0; #工作进程优先级，-20~20(19)表示进程相对于其他进程的调度优先级。优先级值越低，进程的优先级越高，意味着它更有可能获得CPU时间，优先级范围通常是从 -20（最高优先级，也称为“最实时”优先级）到 19（最低优先级，也称为“最不实时”或“最空闲”优先级）
worker_rlimit_nofile  65536; #所有worker进程能打开的文件数量上限,包括:Nginx的所有连接（例如与代理服务器的连接等），而不仅仅是与客户端的连接。另一个考虑因素是实际的并发连接数不能超过系统级别的最大打开文件数的限制，最好与ulimit -n或者limits.conf的值保持一致daemon off|on;    #用于控制Nginx是否应该以守护进程（daemon）的方式运行，off表示前台，on表示后台
master_process off|on;   #用于控制Nginx是否应该以主进程（master process）和工作进程（worker processes）的模型来运行，on设置告诉Nginx在启动时创建一个主进程和多个工作进程，off设置告诉Nginx不要创建主进程，而是直接以单个进程（即工作进程）的形式运行。这意味着Nginx将不会利用主进程和工作进程的模型

• worker_cpu_affinity 0001 0010 0100 1000; 4核心绑定
• worker_cpu_affinity 0001 0010; 2核心绑定

• 核心绑定并不是意味着当前nginx进程独占一核心CPU，但是可以保证此进程不运行在其他核心上，这就极大减少了nginx的工作进程在不同的cpu核心上的来回跳转，减少了CPU对进程的资源分配与回收以及内存管理等，因此可以有效的提升nginx服务器的性能

示例：

[root@nginx-node1 ~]# vim /usr/local/nginx/conf/nginx.conf

[root@nginx-node1 ~]# systemctl restart nginx[root@nginx-node1 ~]# ps -axf | grep nginx3608 pts/1    S+     0:00  |           \_ grep --color=auto nginx3602 ?        Ss     0:00 nginx: master process /usr/local/nginx/sbin/nginx3603 ?        S      0:00  \_ nginx: worker process3604 ?        S      0:00  \_ nginx: worker process

示例：

[root@nginx-node1 ~]# vim /etc/security/limits.conf

[root@nginx-node1 ~]# sudo -u nginx ulimit -n
1024

[root@nginx-node1 ~]# vim /etc/security/limits.conf

[root@nginx-node1 ~]# sudo -u nginx ulimit -n
2048

events配置段

#events配置段，主要影响nginx服务器与用户的网络连接，比如是否允许同时接受多个网络连接，使用哪种事件驱动模型处理请求，每个工作进程可以同时支持的最大连接数，是否开启对多工作进程下的网络连接进行序列化等
events {use epoll;   #使用epo11事件驱动模型，但不推荐配置它，让nginx自己选择。Nginx支持众多的事件驱动，比如:select、poll、epoll，只能设置在events模块中设置worker_connections 1024; #每个worker进程的最大连接数量(并发数)。作为web服务器的时候最大并发数为worker_connections*worker_processes；作为反向代理的时候为(worker_connections*worker_processes)/2accept_mutex on  #on为同一时刻一个请求轮流由work进程处理，为防止被同时唤醒所有worker，避免多个睡眠进程被唤醒的设置，默认为off。为on时新请求会唤醒所有worker进程,此过程也称为"惊群"。因此nginx刚安装完以后要进行适当的优化。建议设置为onmulti_accept on;  #on为Nginx服务器的每个工作进程可以同时接受多个新的网络连接，此指令默认为off，即默认为一个工作进程只能一次接受一个新的网络连接，打开后几个同接受多个。建议设置为on
}

• 对于运行Nginx的服务器，通常需要关注文件描述符的数量限制，因为Nginx需要打开大量的文件描述符来处理客户端连接

示例：

[root@nginx-node1 ~]# vim /etc/security/limits.conf

[root@nginx-node1 ~]# yum install httpd-tools -y

#测压
#-n表示请求量   -c表示并发量
[root@nginx-node1 ~]# ab -n 10000000 -c 10000 http://172.25.254.100/index.html

nginx配置中的root和alias

[root@nginx-node1 ~]# vim /usr/local/nginx/conf/nginx.conf

[root@nginx-node1 ~]# mkdir -p /usr/local/nginx/conf.d[root@nginx-node1 ~]# vim /usr/local/nginx/conf.d/vhost.conf

• 该配置是一个基于域名的虚拟主机配置，当访问不同域名时，访问不同网站

[root@nginx-node1 ~]# mkdir -p /data/web/html
[root@nginx-node1 ~]# echo hello world > /data/web/html/index.html

• 测试

[root@nginx-node1 ~]# vim /usr/local/nginx/conf.d/vhost.conf

[root@nginx-node1 ~]# mkdir -p /data/web/test1
[root@nginx-node1 ~]# echo hello world 1 > /data/web/test1/index.html[root@nginx-node1 ~]# systemctl restart nginx

• 测试

• 当匹配到location设置的/test1时，root会对/data/web/和网址上的/test1/进行拼接

[root@nginx-node1 ~]# vim /usr/local/nginx/conf.d/vhost.conf

• alias不会进行路径的叠加，当匹配到/test2后，直接访问alias设置的路径

[root@nginx-node1 ~]# systemctl restart nginx

• 测试

location用法详解

• 在一个server中location配置段可存在多个，用于实现从uri到文件系统的路径映射
• ngnix会根据用户请求的uri来检查定义的所有location，按一定的优先级找出一个最佳匹配
• 而后应用其配置在没有使用正则表达式的时候，nginx会先在server中的多个location中选取匹配度最高的一个uri
• uri是用户请求的字符串，即域名后面的web文件路径
• 然后使用该location模块中的正则url和字符串，如果匹配成功就结束搜索，并使用此location处理此请求

格式：

location [ ~ | ~* | ^~ | = ] uri {......
}#uri表示文件路径

• 匹配规则：

  • = 精确匹配

  • ~ 正则匹配，区分大小写

  • ~* 正则匹配，不区分大小写

  • ^~ 匹配以某个字符串开头，不是正则匹配

  • / 通用匹配，如果其他location都没有匹配，则该location会进行匹配

  • 匹配优先级：(~ | ~*) 只有文件路径的 ^~ =

• 匹配优先级：(~ | ~*) 只有文件路径的 ^~ =

• ~和~*的优先级相同，谁在前面先匹配谁
• 整个网址叫url，除域名外的叫uri

[root@nginx-node1 ~]# vim /usr/local/nginx/conf.d/vhost.conf

server {listen  80;server_name  www.nginx-test.com;#只用当访问www.nginx-test.com/match_all/ 时才会匹配到 /usr/share/nginx/html/match_all/index.htmllocation = /match_all/ {root  /usr/share/nginx/html;index index.html;}#当访问 www.nginx-test.com/1.jpg 等路径时会去 /usr/share/nginx/images/1.jpg 找对应的资源location ~ \.(jpeg|jpg|png|svg)$ {root  /usr/share/nginx/images;}#当访问www.nginx-test.com/bbs 时会匹配上 /usr/share/nginx/html/bbs/index.htmllocation ^~ /bbs/ {root  /usr/share/nginx/html;index index.html index.htm;}#注意:上述location都找不到的话都在这里找location / {root html;index index.html index.htm;}#其/不是根目录而是统统都匹配到指定路径，而指定路径为html，即nginx的默认网页目录/usr/share/nginx/html
}

虚拟主机配置

• 基于不同的IP、不同的端口以及不同的域名实现不同的虚拟主机，依赖于核心模块ngx_http_core_module实现

nginx账户认证功能

• 由ngx_http_auth_basic_module模块提供此功能

[root@nginx-node1 ~]# htpasswd -cm /usr/local/nginx/.htpasswd admin
New password:     #密码123456
Re-type new password:     #密码123456
Adding password for user admin

[root@nginx-node1 ~]# vim /usr/local/nginx/conf.d/vhost.conf

[root@nginx-node1 ~]# systemctl restart nginx

• 测试
  

nginx自定义错误页面

• 自定义错误页面，同时也可以用指定的响应状态码进行响应, 可用位置：http, server, location

[root@nginx-node1 ~]# vim /usr/local/nginx/conf.d/vhost.conf

• 状态码为404，405时返回给客户端的页面40x.html

[root@nginx-node1 ~]# mkdir -p /data/web/errorpage
[root@nginx-node1 ~]# echo error page > /data/web/errorpage/40x.html

[root@nginx-node1 ~]# systemctl restart nginx

• 测试

nginx自定义日志

[root@nginx-node1 ~]# mkdir /var/log/nginx/

[root@nginx-node1 ~]# vim /usr/local/nginx/conf.d/vhost.conf

[root@nginx-node1 ~]# systemctl restart nginx

• 测试

[root@nginx-node1 ~]# cat /var/log/nginx/access.log
172.25.254.1 - - [01/Jan/2025:05:32:07 -0500] "GET /gagsa HTTP/1.1" 404 11 "-" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36 Edg/127.0.0.0"

[root@nginx-node1 ~]# cat /var/log/nginx/error.log
2025/01/01 05:32:07 [error] 1948#0: *1 open() "/data/web/html/gagsa" failed (2: No such file or directory), client: 172.25.254.1, server: www.huazi.org, request: "GET /gagsa HTTP/1.1", host: "www.huazi.org"