23.3 nginx main 配置段

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

user username [groupname];
# 指定运行worker进程的用户和组

pid /path/to/pidfile_name;
# 指定nginx的pid文件

include file | mask;
# eg: include /etc/nginx/conf.d/*.conf;
# 指明包含进来的其它配置文件片断,mask 表示支持通配符；

load_module file;
# load_module "/usr/lib64/nginx/modules/ngx_stream_module.so";
# 指明要装载的动态模块；

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

worker_processes n;
# worker进程的个数；通常其数值应该小于或等于CPU的物理核心数；
worker_processes auto;
# nginx 将根据 cpu 数量自动选择 worker 进程数

worker_cpu_affinity cpumask ...;
# 作用: 对 worker 进程进行 CPU 绑定，用于提升缓存命中率
       只有在系统上不存在其他耗费资源的进程时才建议开启
# eg:
#    worker_processes 6;
#    worker_cpu_affinity 00000001 00000010 00000100 00001000 00010000 00100000;
worker_cpu_affinity  auto;  # nginx 将根据 cpu 数量自动绑定

worker_priority nice;
# 作用: 指明 work 进程的 nice 值,  -20,19之间的值

worker_rlimit_nofile n;
# 指定所有worker进程所能够打开的最大文件句柄数；

worker_rlimit_sigpending n;
# 设定每个用户能够发往worker进程的信号的数量；

ssl_engine device;  
# 在存在ssl硬件加速器的服务器上，指定所使用的ssl硬件加速设备；

timer_resolution t
# 作用:
#    每次内核事件调用返回时，都会使用gettimeofday()来更新nginx缓存时钟；
#    timer_resolution用于定义每隔多久才会由gettimeofday()更新一次缓存时钟；
#    x86-64系统上，gettimeofday()代价已经很小，可以忽略此配置；

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

work_connections  nums
# 设定单个 worker 进程能处理的最大并发连接数量, 尽可能大，以避免成为限制，eg: 51200

use [epoll|rtsig|select|poll]
# 作用: 指明使用的IO模型，建议让Nginx 自动选择

accept_mutex [on|off]
# 作用: 是否打开Ningx的负载均衡锁；
# 功能:
#      此锁能够让多个worker进轮流地、序列化地与新的客户端建立连接；
#      而通常当一个worker进程的负载达到其上限的7/8，master就尽可能不再将请求调度此worker；


accept_mutex_delay ms;
# 作用:
#    accept锁模式中，一个worker进程为取得accept锁的等待时长
#    如果某worker进程在某次试图取得锁时失败了，至少要等待ms才能再一次请求锁；

lock_file /path/to/lock_file;
# 作用: accept_mutex 用到的lock文件路径

multi_accept on|off;
# 作用: 是否允许一次性地响应多个用户请求；默认为Off;

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

daemon on|off;
# 作用:
#      是否以守护进程让ningx运行后台；默认为on，
#      调试时可以设置为off，使得所有信息去接输出控制台；

master_process on|off
# 作用:
#    是否以master/worker模式运行nginx；默认为on；
#    调试时可设置off以方便追踪；

error_log path level;
# 作用:
#    错误日志文件及其级别；默认为error级别；调试时可以使用debug级别，
#    但要求在编译时必须使用--with-debug启用debug功能；
# path: stderr | syslog:server=address[,paramter=value] | memory:size
# level: debug | info | notice|  warn|crit| alter| emreg