找到配置文件

如果已配置好环境变量,可以检查Nginx配置文件是否存在语法错误:

1
nginx -t

输出中就包含了Nginx配置文件的路径[Nginx根目录]/conf/nginx.conf

配置文件

Nginx配置文件模板(来自知乎专栏):

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
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
# 全局参数
user nginx; # 可以允运行Nginx服务的用户或用户组,此配置在windows上无效
worker_processes auto; # Nginx工作进程数,通常设置为CPU核数
error_log /var/log/nginx/error.log warn; # 错误日志路径和日志级别
pid /run/nginx.pid; # 进程PID保存路径

# 定义事件模块
events {
worker_connections 1024; # 每个工作进程最大并发连接数
use epoll; # 使用epoll网络模型,提高性能
multi_accept on; # 开启支持多个连接同时建立
}

# 定义HTTP服务器模块
http {
# 缓存文件目录
client_body_temp_path /var/cache/nginx/client_temp;
proxy_temp_path /var/cache/nginx/proxy_temp;
fastcgi_temp_path /var/cache/nginx/fastcgi_temp;

# 定义日志格式,main是默认的日志格式
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;

# 定义MIME类型
include /etc/nginx/mime.types;
default_type application/octet-stream;

# 代理参数
proxy_connect_timeout 6s; # 连接超时时间
proxy_send_timeout 10s; # 发送超时时间
proxy_read_timeout 10s; # 接收超时时间
proxy_buffer_size 16k; # 缓冲区大小
proxy_buffers 4 32k; # 缓冲区个数和大小
proxy_busy_buffers_size 64k; # 忙碌缓冲区大小
proxy_temp_file_write_size 64k; # 代理临时文件写入大小

# 启用压缩,可以提高网站访问速度
gzip on;
gzip_min_length 1k; # 最小压缩文件大小
gzip_types text/plain text/css application/json application/javascript application/xml;

# 定义HTTP服务器
server {
listen 80; # 监听端口

server_name example.com; # 域名

# 重定向到HTTPS,强制使用HTTPS访问
if ($scheme != "https") {
return 301 https://$server_name$request_uri;
}

# HTTPS服务器配置
ssl_certificate /etc/nginx/ssl/server.crt; # SSL证书路径
ssl_certificate_key /etc/nginx/ssl/server.key; # SSL私钥路径

# SSL会话缓存参数
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 10m;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_prefer_server_ciphers on;
ssl_ciphers ECDH+AESGCM:ECDH+AES256:ECDH+AES128:DH+3DES:!ADH:!AECDH:!MD5;

# 配置代理路径
location / {
proxy_pass http://localhost:8080; # 转发请求的目标地址
proxy_set_header Host $host; # 设置请求头中的Host字段
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
# 设置HTTP头中的X-Forwarded-For字段,表示客户端真实IP,多个IP用逗号隔开
proxy_set_header X-Real-IP $remote_addr; # 设置请求头中的X-Real-IP字段,表示客户端真实IP
}

# 配置静态文件访问路径
location /static/ {
alias /path/to/static/files/; # 静态文件的目录
expires 7d; # 静态文件缓存时间
add_header Pragma public; # 添加HTTP响应头
add_header Cache-Control "public, must-revalidate, proxy-revalidate";
}

# 配置错误页面
error_page 404 /404.html; # 404错误页
location = /404.html {
internal; # 不接受外部访问
root /usr/share/nginx/html; # 404错误页文件所在目录
}

# 配置重定向
location /old/ {
rewrite ^/old/([^/]+) /new/$1 permanent; # 将/old/xxx路径重定向为/new/xxx,返回301状态码
}
}

# 其他服务配置
# server {
# ...
# }

# 配置TCP负载均衡
upstream backends {
server backend1.example.com:8080 weight=5; # 后端服务器地址和权重
server backend2.example.com:8080;
server backend3.example.com:8080 backup; # 备用服务器
keepalive 16; # 连接池大小
}

server {
listen 80;
server_name example.com;

location / {
proxy_pass http://backends; # 负载均衡转发请求的目标地址
proxy_set_header Host $host; # 设置请求头中的Host字段
proxy_set_header X-Real-IP $remote_addr; # 设置请求头中的X-Real-IP字段,表示客户端真实IP
}
}
}

配置文件一共由三部分组成,分别为全局块、events块和http块

在http块中,又包含http全局块和多个server块

每个server块中,可以包含server全局块和多个location块

在同一配置块中嵌套的配置块,各个之间不存在次序关系

全局块

全局块是默认配置文件从开始到events块之间的一部分内容,主要设置一些影响Nginx服务器整体运行的配置指令,因此,这些指令的作用域是Nginx服务器全局

  • user [user] [group]
    • 指定可以运行Nginx服务的用户和用户组
    • 只能在全局块配置user指令
    • 在Windows上不生效,会报错
  • worker_processes [number|auto]:Nginx进程数量worker_processes,如果设置为2,Nginx将会开启一个master进程和两个worker进程
  • pid [path]:存放pid文件
  • error_log [path] [level];
    • 全局错误日志类型
    • 日志分为debug、info、warn、error四个级别

events块

events块主要影响Nginx服务器与用户的网络连接

常用到的设置包括是否开启对多worker process下的网络连接进行序列化,是否允许同时接收多个网络连接,选取哪种事件驱动模型处理连接请求,每个worker process可以同时支持的最大连接数等

  • accept_mutex [on|off]
    • 默认开启,开启后,Nginx的多个worker将会以串行的方式来处理,只会有一个worker将会被唤起,其他的worker继续睡眠
    • 如果不开启,将会造成惊群效应,多个worker会全部被唤起,但只有一个worker能获取新连接,其它的worker会重新进入休眠状态
  • worker_connections [number] :单个进程最大连接数(最大连接数=连接数+进程数)

http块

http块是Nginx服务器配置中的重要部分,包含代理、缓存和日志定义等绝大多数功能甚至第三方模块的配置

  • include [path]:引入其他的配置文件
  • default_type [path]:如果没设置Web程序,Nginx也没对应文件的扩展名,就用Nginx里默认的 default_type定义的处理方式
  • log_format [format] [content] :定义日志格式,只能在http块中进行配置
  • sendfile
    • 启用sendfile()系统调用替换read()和write()调用,减少系统上下文切换,提高性能
    • 当Nginx是静态文件服务器时,能极大提高Nginx的性能表现
  • keepalive_timeout
    • KeepAlive的超时时间
    • HTTP有一个KeepAlive模式,它告诉webserver,在处理完一个请求后,保持这个TCP连接的打开状态
    • 若接收到来自客户端的其它请求,服务端会利用这个未被关闭的连接,而不需要再建立一个新连接
  • gzip [on|off]
    • 开启Gzip压缩功能
    • 使网站的CSS、JS、XML、HTML文件在传输时进行压缩,提高访问速度,优化Nginx性能

server块

每一个http块都可以包含多个server块,而每个server块就相当于一台虚拟主机,它内部可有多台主机联合提供服务,一起对外提供在逻辑上关系密切的一组服务

  • listen [url|port]:监听端口,可以单独制定ip,单独指定端口或者同时指定ip和端口

    1
    2
    3
    4
    5
    listen 127.0.0.1:8000;  #只监听来自127.0.0.1这个IP,请求8000端口的请求
    listen 127.0.0.1; #只监听来自127.0.0.1这个IP,请求80端口的请求(不指定端口,默认80)
    listen 9999; #监听来自所有IP,请求9999端口的请求
    listen *:9999; #和上面效果一样
    listen localhost:8000; #和第一种效果一致
  • server_name [name]

    1
    server_name  localhost;
    • 服务名
    • Nginx允许一个虚拟主机有一个或多个名字,也可以使用通配符*设置虚拟主机的名字
    • 支持ip、域名、通配符、正则等

location块

每个server块中可以包含多个location块,Nginx服务器在许多功能上的灵活性往往体现在location指令的配置中

location指令

可分为以下3类:

  • 前缀字符串匹配
    • 精确匹配 =
    • 前缀匹配 ^~(立刻停止后续的正则搜索)
    • 按文件中顺序的正则匹配 ~~*
    • 匹配不带任何修饰的前缀匹配
  • 正则表达式匹配
  • 用于内部跳转的命名location

location root

root指定目录的上级目录,并且该上级目录要含有location指定名称的同名目录

1
2
3
4
location /img/ {
# 访问/img/目录下的文件时,nginx会去/var/www/image/img/目录下找文件
root /var/www/image;
}