Nginx官方文档(十)【核心功能】

最新推荐文章于 2024-10-11 16:45:49 发布
最新推荐文章于 2024-10-11 16:45:49 发布
阅读量867 收藏 2
点赞数
分类专栏： (Nginx|Haproxy)【IIS】
原文链接：https://blog.csdn.net/WuLex
版权

核心功能

示例配置

user www www;
worker_processes 2;

error_log /var/log/nginx-error.log info;

events {
    use kqueue;
    worker_connections 2048;
}

...

指令

accept_mutex

-说明
语法accept_mutex on | off;
默认accept_mutex off;
上下文events

如果启用了 accept_mutex，则工作进程将轮流接受新连接。否则，将新连接通知给所有工作进程，如果新连接数量较少，某些工作进程可能会浪费系统资源。

在支持 EPOLLEXCLUSIVE 标志（1.11.3）或使用 reuseport 的系统上，不需要启用 accept_mutex。

在版本 1.11.3 之前，默认值为 on。

accept_mutex_delay

-说明
语法accept_mutex_delay time;
默认accept_mutex_delay 500ms;
上下文events

如果启用了 accept_mutex，则指定如果另一个工作进程正在接受新连接，则工作进程将尝试重新启动以接受新连接的最长时间。

daemon

-说明
语法daemon on | off;
默认daemon on;
上下文main

决定 nginx 是否应该成为守护进程。主要用于开发。

debug_connection

-说明
语法debug_connection address | CIDR | unix:;
默认——
上下文events

启用所选客户端连接的调试日志。其他连接将使用由 error_log 指令设置的日志级别。调试连接由 IPv4 或 IPv6 （1.3.0，1.2.1）地址或网络指定。也可以使用主机名指定连接。对于使用 UNIX 域套接字（1.3.0，1.2.1）的连接，调试日志由 unix: 参数启用。

events {
    debug_connection 127.0.0.1;
    debug_connection localhost;
    debug_connection 192.0.2.0/24;
    debug_connection ::1;
    debug_connection 2001:0db8::/32;
    debug_connection unix:;
    ...
}

为了使该指令正常工作，需要使用 --with-debug 来构建nginx，请参见调试日志。

debug_points

-说明
语法debug_points abort | stop;
默认——
上下文main

该指令用于调试。

当检测到内部错误时，例如，在重新启动工作流程时，发生套接字泄漏，启用 debug_points 会导致核心文件创建（abort）或停止（stop）进程以使用系统调试器进行进一步分析。

error_log

-说明
语法error_log file [level];
默认error_log logs/error.log error;
上下文main、http、mail、stream、server、location

配置日志。可以在同一级别指定几个日志（1.5.2）。如果在 main 配置级别将日志写入一个未明确定义文件，则将使用默认文件。

第一个参数定义了一个将存储日志的 file。特殊值 stderr 选择标准错误文件。可以通过指定 syslog: 前缀来配置记录日志到 syslog。可以通过指定 memory: 前缀和缓冲区 size 来配置记录日志到循环内存缓冲区，此通常用于调试（1.7.11）。

第二个参数确定日志记录的 level，可以是以下之一：debug、info、notice、warn、error、crit、alert 或emerg。上述日志级别按严重性递增排列。设置某个日志级别将造成所有指定的消息和更严重的日志级别被记录。例如，默认级别 error 将导致 error、crit、alert和 emerg 消息被记录。如果省略此参数，则使用 error。

为了使 debug 日志记录工作，需要使用 --with-debug 来构建nginx，请参见调试日志。

从 1.7.11 版本开始，该指令可以指定 stream 级别，从 1.9.0 版本开始可以指定 mail 级别。

env

-说明
语法env variable[=value];
默认env TZ;
上下文main

默认情况下，nginx 除去 TZ 变量之外的所有继承自父进程的环境变量。该指令允许保留一些继承的变量、更改其值或创建新的环境变量。 这些变量是：

  • 在可执行文件实时升级期间继承
  • 被 ngx_http_perl_module 模块使用
  • 被工作进程使用。应该要记住，以这种方式来控制系统库并不总是可行的，因为只有在初始化期间这些库才能检查变量。一种例外情况是可执行文件执行实时升级。

除非明确配置，否则 TZ 变量始终会继承并对 ngx_http_perl_module 模块可用。

用法示例：

env MALLOC_OPTIONS;
env PERL5LIB=/data/site/modules;
env OPENSSL_ALLOW_PROXY_CERTS=1;

NGINX 环境变量由 nginx 内部使用，不应由用户直接设置。

events

-说明
语法events { ... }
默认——
上下文main

提供指定影响连接处理指令的配置文件上下文。

include

-说明
语法include file | mask;
默认——
上下文any

包含另一个 file 或匹配指定 mask 的文件到配置中。包含的文件应该由语法正确的指令和块组成。

使用示例：

include mime.types;
include vhosts/*.conf;

load_module

-说明
语法load_module file;
默认——
上下文main
提示该指令在 1.9.11 版本中出现

加载一个动态模块

使用示例：

load_module modules/ngx_mail_module.so;
-说明
语法lock_file file;
默认lock_file logs/nginx.lock;
上下文main

nginx 使用锁机制来实现 accept_mutex 并序列化对共享内存的访问。大多数系统是使用原子操作实现锁，并忽略此指令。在其他系统上是使用“锁文件”机制。此指令用于指定一个锁文件名称的前缀。

master_process

-说明
语法master_process on | off;
默认master_process on;
上下文main

用于决定是否启动工作进程。该指令适用于 nginx 开发人员。

multi_accept

-说明
语法multi_accept on | off;
默认multi_accept off;
上下文events

如果 multi_accept 被禁用，工作进程将一次接受一个新连接。否则，工作进程将一次接受所有新连接。

如果使用了 kqueue 连接处理方式，则会忽略该指令，因为它报告了等待接受的新连接的数量。

pcre_jit

-说明
语法pcre_jit on | off;
默认pcre_jit off;
上下文main
提示该指令在 1.1.12 版本中出现

启用或禁用对在配置解析时已知的正则表达式使用“即时编译”（PCRE JIT）。

PCRE JIT 可以明显地加快正则表达式的处理。

从 8.20 版本开始，可以使用 -enable-jit 配置参数构建 PCRE 库启用 JIT。当使用 nginx（--with-pcre=）构建 PCRE 库时，可以通过 --with-pcre-jit 配置参数启用 JIT 支持。

pid

-说明
语法pid file;
默认——
上下文main

定义一个 file 用于存储主进程的进程 ID 。

ssl_engine

-说明
语法ssl_engine device;
默认——
上下文main

定义硬件 SSL 加速器的名称。

thread_pool

-说明
语法thread_pool name threads=number [max_queue=number];
默认thread_pool default threads=32 max_queue=65536;
上下文main
提示该指令在 1.7.11 版本中出现

定义命名的线程池用于多线程读取和发送文件，而无需阻塞工作进程。

threads 参数定义池中的线程数量。

如果池中的所有线程都处于繁忙状态，则新任务将在队列中等待。max_queue 参数限制队列中允许等待的任务数。缺省情况下，队列中最多可以等待 65536 个任务。当队列溢出时，任务完成并出现错误。

timer_resolution

-说明
语法timer_resolution interval;
默认——
上下文main

减少工作进程中的计时器分辨率，从而减少 gettimeofday() 的系统调用次数。默认情况下，每次接收到内核事件时都会调用 gettimeofday()。随着分辨率的降低，gettimeofday() 仅在指定的时间间隔内被调用一次。

示例：

timer_resolution 100ms;

间隔的内部实现取决于使用的方法：

  • 如果使用 kqueue，就使用 EVFILT_TIMER 过滤器
  • 如果使用 eventport，就使用 timer_create()
  • 否则使用 setitimer()

use

-说明
语法use method;
默认——
上下文events

指定要使用的连接处理方式。通常不需要明确指定它，因为 nginx 将默认使用最有效的方式。

user

-说明
语法user user [group];
默认——
上下文events

定义工作进程使用的 user 和 group 凭据。如果省略 group，则使用其名称与 user 相等的组。

worker_aio_requests

-说明
语法worker_aio_requests number;
默认worker_aio_requests 32;
上下文events
提示该指令在 1.1.4 和 1.0.7 版本中出现

当使用有 epoll 连接处理方式的 aio 时，为单个工作进程设置未完成异步 I/O 操作的最大 number（数量）。

worker_connections

-说明
语法worker_connections number;
默认worker_connections 512;
上下文events

设置工作进程可以打开的同时连接的最大数量。

应该记住的是，这个数字包括了所有连接（例如与代理服务器的连接等），而不仅仅是客户端的连接。另一个要考虑因素是实际的并发连接数不能超过最大打开文件数的限制，可以通过 worker_rlimit_nofile 来修改。

worker_cpu_affinity

-说明
语法worker_cpu_affinity cpumask ...;
worker_cpu_affinity auto [cpumask];
默认——
上下文main

将工作进程绑定到一组 CPU。每个 CPU 组由允许的 CPU 的位掩码表示。应为每个工作进程定义一个单独的组。默认情况下，工作进程没有绑定任何特定的 CPU。

示例：

worker_processes    4;
worker_cpu_affinity 0001 0010 0100 1000;

将每个工作进程绑定到单独的 CPU

worker_processes    2;
worker_cpu_affinity 0101 1010;

将第一个工作进程绑定到 CPU0/CPU2，将第二个工作进程绑定到 CPU1/CPU3。第二个例子适用于超线程。

特殊值 auto（1.9.10）允许自动绑定工作进程到可用的 CPU：

worker_processes auto;
worker_cpu_affinity auto;

可选的掩码参数可用于限制自动绑定的可用 CPU：

worker_cpu_affinity auto 01010101;

该指令仅适用于 FreeBSD 和 Linux。

worker_priority

-说明
语法worker_priority number;
默认worker_priority 0;
上下文main

定义工作进程的调度优先级，与使用 nice 命令完成类似：负数意味着更高的优先级。允许范围通常在 -20 到 20 之间。

示例：

worker_priority -10;

worker_processes

-说明
语法worker_processes number | auto;
默认worker_processes 1;
上下文main

定义工作进程的数量。

最优值取决于许多因素，包括（但不限于）CPU 核心数、存储数据的硬盘驱动器数量以及加载模式。当您不确定时，将其设置为可用 CPU 核心的数量是一个不错的做法（值 auto 将尝试自动检测）。

auto 参数从 1.3.8 和 1.2.5 版本开始得到支持。

worker_rlimit_core

-说明
语法worker_rlimit_core size;
默认——
上下文main

更改工作进程核心文件（RLIMIT_CORE）最大大小限制。用于增加限制而无需重新启动主进程。

worker_rlimit_nofile

-说明
语法worker_rlimit_nofile number;
默认——
上下文main

更改工作进程最大打开文件数（RLIMIT_NOFILE）的限制。用于增加限制而无需重新启动主进程。

worker_shutdown_timeout

-说明
语法worker_shutdown_timeout time;
默认——
上下文main
提示该指令在 1.11.11 版本中出现

为正常关闭工作进程配置超时。当时间到期时，nginx 将尝试关闭当前打开的所有连接以便于关闭工作进程。

working_directory

-说明
语法working_directory directory;
默认——
上下文main

定义工作进程的当前工作目录。它主要用于编写核心文件时，在这种情况下，工作进程应有指定目录的写入权限。

原文档

http://nginx.org/en/docs/ngx_core_module.html

.NET跨平台
关注
专栏目录
Nginx官方文档
04-29
全面的nginx官方文档,选择它没错的
nginx官方文档中文版
06-13
Nginx 核心功能 * ngx_http_core_module * ngx_http_access_module * ngx_http_addition_module * ngx_http_api_module * ngx_http_auth_basic_module * ngx_http_auth_jwt_module * ngx_http_auth_request_module ...
nginx 官方文档翻译
a919149282的博客
03-05 307
nginx（发音为“engine x”）是一个由俄罗斯软件工程师Igor Sysoev编写的免费开源Web服务器。自2004年公开发布以来，nginx专注于高性能，高并发性和低内存使用。Web服务器功能之外的其他功能（如负载平衡，缓存，访问和带宽控制）以及与各种应用程序高效集成的功能，使nginx成为现代网站架构的理想选择。目前nginx是互联网上第二个最受欢迎的开源Web服务器。 1...
Nginx+中文文档：从安装到配置优化的全面指南
最新发布
weixin_35749440的博客
10-11 718
本文还有配套的精品资源，点击获取 简介：本文深入介绍Nginx的核心概念和安装配置过程，包括事件模型、反向代理、负载均衡、静态文件处理和缓存功能。同时，详细阐述中文文档对于非英语环境开发者的重要性，以及Nginx的使用技巧。最后，提供一个完整的Nginx教程，涵盖基础概念、安装步骤、配置详解、实战案例和故障排查。 1. Nginx基础概念和特性 1.1 Ng...
Nginx入门
qq_29663299的博客
01-14 189
本指南会对nginx进行基本的介绍并描述一些它可以完成的简单任务。如果你还没有安装nginx，请参阅nginx的安装。本指南不仅描述了怎么启动和停止nginx，怎么重新加载nginx的配置，还解释了nginx配置文件的结构以及如何设置nginx提供静态资源，还会教你如何将nginx配置为一个代理服务器，以及如何将它和FastCGI应用连接。 nginx有一个主进程和其它的工作进程。主进程的主要作...
nginx 官方文档
bijiarong8928的博客
09-07 494
https://nginx.org/en/docs/
Nginx官方文档（文档链接整理）
我有一个魔盒的博客
07-20 1002
Nginx文档
nginx官方文档-中文版.rar
03-26
1. **模块化结构**：Nginx采用模块化的架构，核心功能与其他功能模块分离，这使得Nginx能够根据需求灵活配置，支持HTTP、HTTPS、FTP、SMTP等多种协议。 2. **事件驱动模型**：Nginx使用异步非阻塞的事件处理模型，...
Nginx 中文官方文档
07-03
- **Nginx主模块**：涵盖了Nginx的核心功能和配置选项，如worker_processes指令用于设置工作进程的数量，直接影响服务器的并发处理能力。 - **Nginx事件模块**：负责处理客户端连接请求，提供了一系列高级事件处理...
nginx文档.zip
06-05
**Nginx**，全名是“Engine X”，是一款高性能的HTTP和反向代理服务器，同时也是一款邮件代理服务器。...通过深入理解和实践这些教程，你可以掌握Nginx的核心功能和高级用法，提升你的Web服务管理能力。
nginx文档说明
03-19
1. **worker_processes**：定义 Nginx 的工作进程数量，一般建议设置为系统 CPU 核心数相同。 ```nginx worker_processes 1; ``` 2. **worker_connections**：定义每个 worker 进程的最大并发连接数。 ```...
Nginx 中文官方文档.pdf
06-19
Nginx 中文官方文档.pdf 个人收集电子书，仅用学习使用，不可用于商业用途，如有版权问题，请联系删除！
nginx官方中文文档
weixin_43110289的博客
10-26 3189
https://blog.redis.com.cn/doc/index.html
nginx 官方中文文档
weixin_33724059的博客
07-02 313
nginx 官方文档有简体中文了,有taobao提供 Simplified Chinese translation of the site by the Server Platforms Team at Taobao.com 文档链接是 http://nginx.org/cn/ Nginx（发音同 engine x）是一款轻量级的Web 服务器／反向代理服务器及电...
Nginx官方文档(四十五)【ngx_stream_core_module】
极客神殿
09-24 2165
ngx_stream_core_module 示例配置 指令 listen preread_buffer_size preread_timeout proxy_protocol_timeout resolver resolver_timeout server stream tcp_nodelay variables_hash_bucket_size variables_hash_max_size 内嵌变量 ngx_stream_core_module 模块自版本 1.9.0 起可用。默认构建情况下
nginx for windows 官方文档
huxyc的博客
10-05 235
nginx for Windows Version of nginx for Windows uses the native Win32 API (not the Cygwin emulation layer). Only theselect()andpoll()(1.15.9) connection processing methods are currently used, so high performance and scalability should not be expected. ...
nginx documentation | Development guide
RToax
10-11 436
Table of Contents nginx documentation Development guide Nginx distributions ▪️OpenResty ▪️The Tengine Web Server Comparison reviews ▪️NGINX vs. Apache (Pro/Con Review, Uses, & Hosting for Each) ▪️Web cache server performance benchm...
Nginx官方文档(二十九)【ngx_http_rewrite_module】
极客神殿
09-23 324
ngx_http_rewrite_module 指令 break if return rewrite rewrite_log set uninitialized_variable_warn 内部实现 ngx_http_rewrite_module 模块使用 PCRE 正则表达式更改请求 URI、返回重定向和有条件地选择配置。 break、if、return、rewrite 和 set 指令将按以下顺序处理： 在 server 级别下，该模块的指令按顺序执行 重复执行： 基于请求 URI 搜索
Nginx模块官方文档
m0_49672766的博客
12-20 116
ngx_http_upstream_module
深入解析NGINX代理服务器的核心功能与应用
文件名称列表中的 "nginx-1.22.0" 表示这是NGINX的一个特定版本，用户需要查看对应版本的官方文档以了解具体的特性和改进。 在IT行业中，掌握NGINX对于开发和运维人员来说是一项重要的技能。由于NGINX广泛应用于CDN...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值