Nginx 简介、安装与配置文件详解

// 进入 opt 目录，暂存安装包
cd /opt
// 下载 nginx 包，示例下载版本为 1.24.0 可根据实际修改
wget http://nginx.org/download/nginx-1.24.0.tar.gz
// 创建目录，用于存放 nginx 文件
mkdir /usr/local/nginxtest
// 解压安装包内容
// -zxvf：解压详细配置，略
// -C：解压到指定目录，后边跟的是目标目录
tar -zxvf nginx-1.24.0.tar.gz -C /usr/local/nginxtest

// 进入解压后文件存放的文件夹
cd /usr/local/nginxtest/nginx-1.24.0
// 配置 nginx 编辑环境
./configure
// 编译并安装
make && make install

// 进入 sbin 目录
cd /usr/local/nginx/sbin/
// 启动 Nginx 服务
./nginx

[root@localhost nginx-1.24.0]# ./configure
checking for OS
 + Linux 3.10.0-1160.83.1.el7.x86_64 x86_64
checking for C compiler ... not found
./configure: error: C compiler cc is not found

yum -y install gcc

yum -y install openssl openssl-devel

// windows
nginx -t // 小写 t：检查配置文件并显示文件路径；大写 T：还额外显示全部配置项和支持的文件类型
.\nginx -t
nginx -c filename // 设置配置文件（默认是:/nginx/conf/nginx.conf）
// Linux
./nginx -t
./nginx -c filename // 设置配置文件（默认是:/nginx/conf/nginx.conf）

// Windows
nginx // 命令行运行（当前窗口关掉，不影响运行）
.\nginx // 命令行运行（当前窗口关掉，不影响运行）
start nginx // 后台运行
// Linux
./nginx // 后台运行

// windows
nginx -s quit // 等待任务完成后停止
.\nginx -s quit
nginx -s stop // 强制停止
.\nginx -s stop
// linux
./nginx -s quit // 等待任务完成后停止
./nginx -s stop // 强制停止

// windows
nginx -s reload
.\nginx -s reload
// linux
./nginx -s reload

// 小写 v：仅显示版本；大写 V：除了版本信息还显示配置信息
// windows
nginx -v
.\nginx -v
// linux
./nginx -v

// windows
tasklist /fi "imagename eq nginx.exe" // 查看进程，包含 PID // fi：Filter 过滤器/筛选器
tskill PID数值 // 关闭指定进程
taskkill /im nginx.exe /f  // 根据映像名称关闭同名的全部进程 // im：映像名称 f：强制 t：一起结束进程树
taskkill /f /t /fi "imagename eq nginx.exe" // 根据映像名称关闭同名的全部进程
// linux
pgrep nginx // 根据进程名查询 PID
ps -ef | grep nginx // 根据进程名查询详细信息 // e：全部进程 f：显示完整格式
kill PID数值 // 关闭指定 PID 的进程，以及子进程
pkill nginx // 根据进程名关闭
killall nginx // 关闭根据进程名得到的全部匹配项

// windows
ren access.log access_20240410.log // 进入 logs 文件夹 ren 重命名日志文件
nginx -s reopen // 返回 nginx 目录后，重新生成新的日志文件
.\nginx -s reopen
// linux
mv /usr/local/nginx/logs/access.log /usr/local/nginx/logs/access20240410.log // 通过绝对路径重命名
./nginx -s reopen // 重新生成新的日志文件
cd .. // 进入 logs 文件夹查看日志文件
cd logs
ls // 结果：access20240410.log  access.log  error.log  nginx.pid

# 指定可以运行 nginx 服务的用户和用户组
# user [user] [group]
# 将user指令注释掉，或者配置成 nobody 的话所有用户都可以运行
# user nobody nobody;
# user 指令在 Windows 上不生效，如果指定具体用户和用户组会报警告
# nginx: [warn] "user" is not supported, ignored in D:\software\nginx-1.18.0/conf/nginx.conf:2
user root;
# 指定并发工作的进程数，可以配置具体数字，也可使用自动模式
# worker_processes number | auto；
# 如下配置：指定 4 个工作进程，此时会生成一个 master 进程和 4 个工作进程，总共五个
#  因此，可以配置工作进程数为本机 CPU 核心数 n -1
worker_processes 4;
# 指定包含 nginx 主进程的 PID 数值的文件路径
# 用途：进程管理、监控与诊断、方便进行自动化脚本控制
pid logs/nginx.pid;
# 指定错误日志的路径和日志级别
# error_log [path] [debug | info | notice | warn | error | crit | alert | emerg] 
# 其中debug级别的日志需要编译时使用--with-debug开启debug开关
error_log  logs/error.log  info;
# 此指令可以在（全局块 < http 块 < server 块 < location 块）中配置，下面简单介绍下区别：
# 首先就是，配置在越低级的块中优先级越高；
# 各个级别的配置块中设置的日志指令，将应用于各自所有下级；
# server 块的配置，目的是不同的服务器配置不同的日志文件或日志级别；
# location 块是最具体的配置级别，它可为特定的 URI 路径或模式设置专门的日志指令。

# 当某一时刻只有一个网络连接到来时，【多个睡眠进程】会被同时唤醒，但只有【一个进程】可获得连接
# 如果【每次唤醒的进程数目太多】，会影响一部分系统性能
# 开启的时候，将会对多个 Nginx 进程接收连接进行序列化，【防止多个进程对连接的争抢】
# 有两个枚举值，默认是开启状态，因此可以不进行专门配置
# accept_mutex on | off;
accept_mutex on;
# multi_accept 配置，决定了当有多个工作进程监听同一个端口时，这些进程如何处理到来的新请求，语法：
# multi_accept on | off;
# off 时：当有新连接到来时，【所有等待的工作进程都会被唤醒】来接受连接，这样可以【提高处理效率】，尤其是在高并发的场景下
# on 时：当有新连接到来时，【只有一个工作进程数会被唤醒】，其他仍处于休眠状态 ，目的是【控制资源的使用】，避免在高并发情况下系统资源的过度消耗
# 如果在支持 kqueue 高效多路复用机制的操作系统（FreeBSD、macOS 等）上运行 Nginx，那么这条指令会被忽略
# 【默认是 off 状态】
multi_accept off;
# 指定使用哪种网络 IO 模型，影响到 Nginx 处理并发连接的能力，语法：
# use method
# 其中 method 可选择的内容有：
# 【Windows 默认 select】【Linux 默认 epoll】【FreeBSD 默认 kqueue】
# select：这是最基本的网络 IO 模型，适用于低并发场景，它在处理大量连接时可能会变得效率低下
# poll：相比 select，poll 能够处理更多的文件描述符，但在某些系统上性能提升有限
# kqueue：这是 FreeBSD 系统特有的高效网络 IO 模型，适用于高并发环境
# epoll：这是Linux 系统下的高效网络 IO 模型，同样适合处理大量并发连。
# rtsig：这是一种实时信号驱动的网络 IO 模型，它可以在不使用线程的情况下处理事件
# dev/poll：这是 Solaris 操作系统特有的网络 IO 模型，类似于 poll
# eventport：这是 NetBSD 和 GNU/Hurd 系统上的事件端口模型，用于处理网络事件
# /dev/poll：这是 macOS 系统上的网络 IO 模型，类似于 poll
use epoll
# 设置允许每一个 worker process 同时开启的最大连接数
# 当每个工作进程接受的连接数超过这个值时将不再接收连接，当所有的工作进程都接收满时，连接进入 logback，logback 满后连接被拒绝
worker_connections  1024;
# 注意：worker_connections * worker_process <= 系统的最大打开文件数
#       worker_connections <= 单个进程支持打开的最大文件数
# 下文继续详解...

# 【全局限制】
# Linux 下执行：cat /proc/sys/fs/file-nr
# 打印出结果：960     0       3228075
# 第三个数字 3228075 就是当前系统的全局最大打开文件数（Max Open Files）
# 也可以自行修改这个数值，用 root 权限修改 /etc/sysctl.conf 文件
#     fs.file-max = 3228075
#     net.ipv4.ip_conntrack_max = 3228075
#     net.ipv4.netfilter.ip_conntrack_max = 3228075
# 【进程限制】
# Linux 下执行：ulimit -n
# 打印出结果：655350
# 临时修改（需 root 用户）：ulimit -n 3228075
# 永久修改：
# 打开文件 /etc/security/limits.conf，加入如下行：
#     work         hard    nofile      3228075
#     work         soft    nofile      3228075
# 详情参考：https://cloud.tencent.com/developer/article/1114773

# include 指令，用于包含其他的配置文件，提高配置可读性，避免单个配置文件过大，但必须符合配置规范
# 下面的指令将 mime.types 包含进来，mime.types 和 nginx.conf 同级目录，不同级的话需要指定具体路径
include  mime.types;
# 浏览器可以显示的内容有 HTML、XML、GIF 及 Flash 等种类繁多的文本、媒体等资源，浏览器为区分这些资源，需要使用MIME Type
# 换言之，MIME Type 是网络资源的媒体类型。Nginx 服务器作为 Web 服务器，必须能够识别前端请求的资源类型
# default_type 指令默认类型，如果不加此指令【默认值为 text/plain】
# 当 Web 程序无法识别对应文件 MIME 类型时，Nginx 会使用 default_type 指定的类型来告诉浏览器如何处理这个文件
# application/octet-stream，这是一种通用的二进制流数据类型，通常用于未知或未指定类型的文件，浏览器不会直接打开未知文件，而是提示下载
# 这样可以确保在没有明确指定 MIME 类型的情况下，用户不会被误导直接在浏览器中打开可能是执行代码的文件，更加安全
# 此指令还可以在 http 块、server 块或者 location 块中进行配置
default_type  application/octet-stream;
# log_format 指令，用于定义日志格式，变量意义见后文表格
# main 为定义的格式名称，这样 access_log 就可以直接使用这个变量了
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 指令
# 在全局块中，我们介绍过 errer_log 指令，其用于配置 Nginx 进程运行时的日志存放和级别
# 此处所指的日志与常规的不同，它是指记录 Nginx 服务器【提供服务过程应答前端请求的日志】
# buffer=size：设置内存缓存区的大小，不实时写入日志文件，可以减少磁盘 I/O 操作的次数
# access_log path [format [buffer=size]]
# 如果你要关闭 access_log，你可以使用下面的命令：access_log off;
# 此指令可以在 http 块、server 块或者 location 块中进行设置
access_log  logs/access.log  main;
# sendfile 指令用于配置，是否使用 sendfile()系统调用来高效的传输文件数据，【特别适合于提供静态内容的场景】，语法：
# sendfile  on | off;
# 【默认值是 off】但在大多数提供静态内容的 Nginx 服务器上，建议将其设置为 on 以利用其带来的性能优势
# sendfile()系统调用模式，允许内核直接将文件数据从磁盘传输到网络 socket，而非先将数据读取到用户空间缓冲区，再写入到 socket 的内核缓冲区
# 这样可以减少数据在用户空间和内核空间之间的拷贝次数，从而显著提高静态文件传输的效率
# 此指令可以在 http 块、server 块或者 location 块中进行配置
sendfile  on;
# sendfile_max_chunk 指令用于限制每个 sendfile()调用传输数据的最大块大小，语法：
# sendfile_max_chunk size;
# 此指令的最优值取决于具体的系统环境和网络条件
# 在高速网络环境中，较大的块大小可能更有利于提高传输效率；而在低速网络或高延迟的环境中，较小的块大小可能更合适
# 此外，还需要考虑到服务器的硬件资源，如 CPU 和内存的限制
# size 值如果大于 0，Nginx 进程的每个 worker process 每次调用 sendfile()传输的数据量最大不能超过这个值
# 如果设置为0，则无限制【默认值为 0】
# 此指令可以在 http 块、server 块或 location 块中配置
sendfile_max_chunk 128k;
# 配置连接超时时间，与用户建立会话连接后，Nginx 服务器可以保持这些连接打开一段时间，语法：
# keepalive_timeout timeout [header_timeout]
# timeout：服务器端对连接的保持时间【默认值为 75s】针对的是整个 TCP 连接的生命周期
# header_timeout：为可选项，是 timeout 的一个子集，在应答报文头部的 Keep-Alive 域设置超时时间，仅控制发送响应头之后的保持时间
# 此指令可以在 http 块、server 块或 location 块中配置
# 下面配置的含义是，在服务器端保持连接的时间设置为 120s，发给用户端的应答报文头部中 Keep-Alive 域的超时时间设置为 100s
keepalive_timeout 120s 100s;
# keepalive_requests 指令配置【单连接请求数上限】达到上限后自动关闭
# 【默认值为100】这意味着在默认配置下，Nginx 会在处理了100个请求后关闭长连接
# 此指令可以在 http 块、server 块或 location 块中配置
keepalive_requests 100;
# error_page 指令用于定义在出现特定错误时 Nginx 应该如何响应
# 当发生错误时，如请求的资源不存在（404错误）或服务器内部错误（500错误），Nginx 可以使用 error_page 指令来定制错误响应
# error_page <HTTP_Error> <value1> <value2>;
# <HTTP_Error>：表示要处理的 HTTP 错误状态码，如 404、500 等
# <value1>：表示当出现 <HTTP_Error> 错误时，Nginx 返回的错误页面的 uri
# <value2>：可选参数，表示是否允许重新定义该错误页面。默认为“=”，即允许重新定义。如果设置为“=@”，则表示不允许重新定义
error_page 404 /404.html;
# http 块中的 error_page 允许你指定一个特定的页面作为错误响应，而 location快中的 return 则只能返回标准的错误响应代码和消息

# 【三种格式】
# 第一种
# listen address[:port] [default_server] [ssl] [http2 | spdy] [proxy_protocol] [setfib=number] [fastopen=number] [backlog=number] [rcvbuf=size] [sndbuf=size] [accept_filter=filter] [deferred] [bind] [ipv6only=on|off] [reuseport] [so_keepalive=on|off|[keepidle]:[keepintvl]:[keepcnt]];
# 第二种
# listen port [default_server] [ssl] [http2 | spdy] [proxy_protocol] [setfib=number] [fastopen=number] [backlog=number] [rcvbuf=size] [sndbuf=size] [accept_filter=filter] [deferred] [bind] [ipv6only=on|off] [reuseport] [so_keepalive=on|off|[keepidle]:[keepintvl]:[keepcnt]];
# 第三种（可以不用重点关注）
# listen unix:path [default_server] [ssl] [http2 | spdy] [proxy_protocol] [backlog=number] [rcvbuf=size] [sndbuf=size] [accept_filter=filter] [deferred] [bind] [so_keepalive=on|off|[keepidle]:[keepintvl]:[keepcnt]];

# 只监听来自 127.0.0.1 这个 IP，请求 8000 端口的请求
listen 127.0.0.1:8000;
listen localhost:8000;
# 只监听来自 127.0.0.1 这个 IP，请求 80 端口的请求（不指定端口，默认 80）
listen 127.0.0.1;
# 监听来自所有 IP，请求 8000 端口的请求
listen 8000;
listen *:8000;

# 【基本使用】
# 配置一个或多个具体的域名，以空格分隔，表示 Nginx 可接受指向这些域名的请求
# server_name name1 name2 ...;
server_name example.com www.example.com;
# 【通配符匹配】
# 使用通配符 * 只能用来匹配域名的【开头或结尾】部分，如下配置会匹配所有以 .example.com 结尾的域名
server_name *.example.com;
# 【正则表达式匹配】
# 支持使用正则表达式进行更复杂的匹配，如下配置可以捕获并使用正则表达式中的部分内容
server_name ~^www\.(?<domain>.+\.com)$;
# 对于字符串 "www.example.com"，它将匹配成功，并提取出 "example" 作为 "domain" 的值

http {
	server {
		listen:  80;
		server_name:  192.168.1.31;
		...
	}
	server {
		listen:  80;
		server_name:  192.168.1.32;
		...
	}
}

location [ = | ~ | ~* | ^~ ] uri { ... }

root path;

location /flv/ {
	root /data/web;
}