Lim's Page

# Nginx

# 配置Nginx服务器运行用户(组)

如果希望所有用户都可以启动Nginx进程，有两种办法，一是把指令注释掉：

# user [user] [group];

二是将用户（和用户组）设置成nobody：

# user nobody nobody;

此指令只能在全局块中配置。

# 配置允许生成的worker process数

worker_processes number | auto;

此指令只能在全局块中配置。

# 配置Nginx进程PID存放路径

pid file | filepath;

默认文件存放在Nginx安装目录下的logs中，名字为nginx.pid。path可以是绝对路径或者相对路径。指定path时一定要包括文件名。

此指令只能在全局块中配置。

# 配置错误日志的存放路径

error_log file | stderr [debug | info | notice | warn | error | crit | alert | emerg];

日志级别由低到高，设置某一级别后，比这一级别高的日志也会被记录。指定文件对于Nginx进程的用户需要由写权限，否则启动时会报permission deny的错误。

此指令可以在全局块、http块、server块以及location块中配置。

# 配置文件的引入

include file;

include /etc/nginx/conf.d/*.conf; # 引入某文件夹下所有配置文件

file支持相对路径。同样要求写权限。

此指令可以放在配置文件任意地方。

# 设置网络连接的序列化

accept_mutex on | off;

默认为on。该指令会对多个Nginx进程接受连接进行序列化，防止多个进程对连接进行争抢，引发惊群问题（某一时刻只有一个网络连接，但是多个睡眠进程被唤醒）。

此指令只能在events块中配置。

# 设置是否允许同时接受多个网络连接

multi_accpet on | off;

默认为off。on时每个worker process可以同时接受多个到达的网络连接。

此指令只能在events块中配置。

# 事件驱动模型的选择

use select | poll | kqueue | epoll | rtsig | /dev/poll | eventport;

此指令只能在events块中配置。

# 配置最大连接数

worker_connections number;

默认为512。设置允许每一个worker process同时开启的最大连接数。这里的number不仅仅包括和前端建立的连接数，而是所有可能的连接数。number的值不能大于操作系统支持打开的最大文件句柄数。

此指令只能在events块中配置。

# 定义MIME-Type

include mime.types;
default_type  application/octet-stream;

用于识别前端请求的资源类型。如果不指定default_type，默认值为text/plain。

此指令可以在http、server或者location中配置。

# 自定义服务日志

access_log path [format] [buffersize];
log_format name string ...;

# 关闭
access_log off;

# eg
access_log logs/access.log combined;
log_format combined '$remote_addr - [$time_local] "$request" ' 
										'$status $body_bytes_sent "$http_referer" '
 										'$http_user_agent';

# output
192.168.1.102 - [31/Oct/2011:20:41:39 +800] "GET /favicon.ico HTTP/1.1" 404 570 "-" "Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.2; Trident/6.0)"

path是日志存放路径和名称；format是在log_format中定义，指定日志输出格式；size指定存放日志的内存缓存区大小。

access_log指令可以在http、server、location中设置。log_format指令只能在http中设置。

# 配置允许sendfile方式传输文件

sendfile on | off;
sendfile_max_chunk size;

sendfile默认值为off；sendfile_max_chunk默认值为0，表示无限制，每个worker process每次调用sendfile()传输的数据量不能超过这个值。

此指令可以在http、server、location中配置。

关于sendfile零拷贝 (opens new window)

零拷贝原理 (opens new window)

# 配置连接超时时间

keepalive_timeout timeout [header_timeout];

timeout默认值为75s。如果指定了header_timeout，将会在应答报头文头部设置keep-alive时间，可被Mozilla或者Konqueror识别。

该指令可以在http、server、location块中设置。

# 单连接请求数上限

keepalive_requests number;

默认值为100。指定用户通过某一连接发送请求的次数。

此指令可以在server、location中配置。

# 配置网络监听

page 46。

# 基于名称的虚拟主机配置

server_name name ...;

// eg
server_name myserver.com www.myserver.com;
server_name *.myserver.com www.myserver.*; // 通配符只能在首段或尾段
server_name ~^www\d+\.myserver\.com$;
server_name ~^www\.(.+)\.com$; // 捕获内容记录到$1中

匹配顺序：

  1. 准确匹配server_name
  2. 通配符在开始时匹配server_name成功
  3. 通配符在结尾时匹配server_name成功
  4. 正则表达式匹配server_name成功

# 基于IP的虚拟主机配置

page 48。

# 配置location块

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

// eg
location = / { ... }
location ^~ /static/ { ... }
location ~ \.(gif|jpg|png|js|css)$ { ... }
location ~* \.png$ { ... }
  • = 用于标准uri前，要求请求字符串与uri严格匹配
  • ~ 用于表示uri包含正则表达式，并且区分大小写
  • ~* 用于表示uri包含正则表达式，并且不区分大小写
    • 如果uri包含正则表达式，必须包含 ~ 或 ~* 标识
  • ^~ 用于标准uri，要求Nginx找到uri和请求字符串匹配度最高的location
    • ^~ 会对uri进行编码处理，例如：/html/%20/data 可以匹配 ^~ /html/ /data

# 配置请求的根目录

root path;

// eg
location / {
  root /dist;
}

当location块接收到 /dist/index.html请求时，就会

← Nuxt容器化过程中引发的疑问 →