Tianyi's Blog
tianyi
2023-10-28
目录

nginx配置-基本配置

# Configuration位置

首先，Nginx 的配置系统由一个主配置文件nginx.conf和其他一些辅助配置文件构成。这些配置文件均是纯文本文件，全部位于Nginx 安装目录下的 conf 目录下。

# 从一个简单结构开始

main                                # 1、全局配置
events {                            # 2、工作模式配置
}
http {                              # 3、http设置
    server {                        # 服务器主机配置（虚拟主机、反向代理等）
        location {                  # 路由配置（虚拟目录等）
        }
        location path {
        }
    }
    upstream name {                  # 负载均衡配置
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
  1. 全局块：配置影响nginx全局的指令。一般有运行nginx服务器的用户组，nginx进程pid存放路径，日志存放路径，配置文件引入，允许生成worker process数等。
  2. events块：配置影响nginx服务器或与用户的网络连接。有每个进程的最大连接数，选取哪种事件驱动模型处理连接请求，是否允许同时接受多个网路连接，开启多个网络连接序列化等。
  3. http块：可以嵌套多个server，配置代理，缓存，日志定义等绝大多数功能和第三方模块的配置。如文件引入，mime-type定义，日志自定义，是否使用sendfile传输文件，连接超时时间，单连接请求数等。
  4. server块：配置虚拟主机的相关参数，一个http中可以有多个server。
  5. location块：配置请求的路由，以及各种页面的处理情况。

# 全局配置

  • user 用来指定nginx worker进程运行用户以及用户组，默认nobody账号运行
  • worker_processes 指定nginx要开启的子进程数量，运行过程中监控每个进程消耗内存(一般几M~几十M不等)根据实际情况进行调整，通常数量是CPU内核数量的整数倍
  • error_log 定义错误日志文件的位置及输出级别【debug / info / notice / warn / error / crit】
  • pid 用来指定进程id的存储文件的位置
  • worker_rlimit_nofile 用于指定一个进程可以打开最多文件数量的描述

# event模块

  • worker_connections 指定最大可以同时接收的连接数量，这里一定要注意，最大连接数量是和worker processes共同决定的 a*b。
  • multi_accept 配置指定nginx在收到一个新连接通知后尽可能多的接受更多的连接
  • use epoll 配置指定了线程轮询的方法，如果是linux2.6+，使用epoll，如果是BSD如Mac请使用Kqueue

# http模块

1）基础配置
sendfile on：配置on让sendfile发挥作用，将文件的回写过程交给数据缓冲去去完成，而不是放在应用中完成，这样的话在性能提升有有好处
tcp_nopush on：让nginx在一个数据包中发送所有的头文件，而不是一个一个单独发
tcp_nodelay on：让nginx不要缓存数据，而是一段一段发送，如果数据的传输有实时性的要求的话可以配置它，发送完一小段数据就立刻能得到返回值，但是不要滥用哦

keepalive_timeout 10：给客户端分配连接超时时间，服务器会在这个时间过后关闭连接。一般设置时间较短，可以让nginx工作持续性更好
client_header_timeout 10：设置请求头的超时时间
client_body_timeout 10:设置请求体的超时时间
send_timeout 10：指定客户端响应超时时间，如果客户端两次操作间隔超过这个时间，服务器就会关闭这个链接

limit_conn_zone $binary_remote_addr zone=addr:5m ：设置用于保存各种key的共享内存的参数，
limit_conn addr 100: 给定的key设置最大连接数

server_tokens：虽然不会让nginx执行速度更快，但是可以在错误页面关闭nginx版本提示，对于网站安全性的提升有好处哦
include /etc/nginx/mime.types：指定在当前文件中包含另一个文件的指令
default_type application/octet-stream：指定默认处理的文件类型可以是二进制
type_hash_max_size 2048：混淆数据，影响三列冲突率，值越大消耗内存越多，散列key冲突率会降低，检索速度更快；值越小key，占用内存较少，冲突率越高，检索速度变慢

2）日志配置
access_log logs/access.log：设置存储访问记录的日志
error_log logs/error.log：设置存储记录错误发生的日志

3）SSL证书配置
ssl_protocols：指令用于启动特定的加密协议，nginx在1.1.13和1.0.12版本后默认是ssl_protocols SSLv3 TLSv1 TLSv1.1 TLSv1.2，TLSv1.1与TLSv1.2要确保OpenSSL >= 1.0.1 ，SSLv3 现在还有很多地方在用但有不少被攻击的漏洞。
ssl prefer server ciphers：设置协商加密算法时，优先使用我们服务端的加密套件，而不是客户端浏览器的加密套件


4）压缩配置
gzip 是告诉nginx采用gzip压缩的形式发送数据。这将会减少我们发送的数据量。
gzip_disable 为指定的客户端禁用gzip功能。我们设置成IE6或者更低版本以使我们的方案能够广泛兼容。
gzip_static 告诉nginx在压缩资源之前，先查找是否有预先gzip处理过的资源。这要求你预先压缩你的文件（在这个例子中被注释掉了），从而允许你使用最高压缩比，这样nginx就不用再压缩这些文件了（想要更详尽的gzip_static的信息，请点击这里）。
gzip_proxied 允许或者禁止压缩基于请求和响应的响应流。我们设置为any，意味着将会压缩所有的请求。
gzip_min_length 设置对数据启用压缩的最少字节数。如果一个请求小于1000字节，我们最好不要压缩它，因为压缩这些小的数据会降低处理此请求的所有进程的速度。
gzip_comp_level 设置数据的压缩等级。这个等级可以是1-9之间的任意数值，9是最慢但是压缩比最大的。我们设置为4，这是一个比较折中的设置。
gzip_type 设置需要压缩的数据格式。上面例子中已经有一些了，你也可以再添加更多的格式。


5）文件缓存配置
open_file_cache 打开缓存的同时也指定了缓存最大数目，以及缓存的时间。我们可以设置一个相对高的最大时间，这样我们可以在它们不活动超过20秒后清除掉。
open_file_cache_valid 在open_file_cache中指定检测正确信息的间隔时间。
open_file_cache_min_uses 定义了open_file_cache中指令参数不活动时间期间里最小的文件数。
open_file_cache_errors 指定了当搜索一个文件时是否缓存错误信息，也包括再次给配置中添加文件。我们也包括了服务器模块，这些是在不同文件中定义的。如果你的服务器模块不在这些位置，你就得修改这一行来指定正确的位置。
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

# server配置

server {
    listen         80;
    server_name    localhost  192.168.1.100;
    charset        utf-8;
    access_log     logs/access.log;
    error_log      logs/error.log;
    ......
}
1
2
3
4
5
6
7
8
  • server：一个虚拟主机的配置，一个http中可以配置多个server
  • server_name：用来指定ip地址或者域名，多个配置之间用空格分隔
  • charset：用于设置www/路径中配置的网页的默认编码格式
  • access_log：用于指定该虚拟主机服务器中的访问记录日志存放路径
  • error_log：用于指定该虚拟主机服务器中访问错误日志的存放路径

# location配置

location模块是Nginx配置中出现最多的一个配置，主要用于配置路由访问信息。

在路由访问信息配置中关联到反向代理、负载均衡等等各项功能，所以location模块也是一个非常重要的配置模块。

  • uwsgi配置和python程序相关，这里跳过介绍
# 简单静态页面：
location / {
    # 这个指令告诉Nginx在处理根目录请求时，将文件从/nginx/www目录中提供。这是你的网站文件的根目录。
    root    /nginx/www;     
    #这里指定了索引文件的顺序。当用户访问一个目录时，Nginx会尝试查找这些文件，并返回第一个找到的文件。在这种情况下，Nginx会先查找index.php，然后是index.html，最后是index.htm。
    index    index.php index.html index.htm; 
}
1
2
3
4
5
6
# 反代配置：
location / {
    proxy_pass http://localhost:8888;
    proxy_set_header X-real-ip $remote_addr;
    proxy_set_header Host $http_host;
}
1
2
3
4
5

  1. location / {：这是一个位置块的开始，表示它将处理所有路径("/")的请求。

  2. proxy_pass http://localhost:8888;：这个指令告诉Nginx将请求代理到位于本地主机（localhost）的端口8888的后端服务器。这意味着所有来自Nginx的请求将被转发到该后端服务器进行处理。

  3. 注意一点：如果你不需要传递真实的对端服务器的信息，只需在Nginx配置中省略这些proxy_set_header指令即可。也就是配一条到这里就够了

    location / {
    proxy_pass http://localhost:8888;
}
    1
    2
    3

  4. proxy_set_header X-real-ip $remote_addr;：这个指令设置HTTP请求头，将客户端的真实IP地址传递给后端服务器，这对于后端服务器获取请求的客户端IP地址是有用的。

  5. proxy_set_header Host $http_host;：这个指令设置HTTP请求头，将请求中的Host头部传递给后端服务器。这通常是为了确保后端服务器知道原始请求的主机名。

# upstream-负载均衡

upstream模块主要负责负载均衡的配置，通过默认的轮询调度方式来分发请求到后端服务器。

参数 值类型 描述
weight number 设置服务器的权重，默认为1。权重越大，分配几率越高
max_conns number 限制与代理服务器的最大并发活动连接数。默认值为零，表示没有限制
max_fails number 设置在fail_timeout参数设置的持续时间内发生的与服务器通信的不成功尝试次数，以考虑服务器在一段时间内不可用，该持续时间也由fail_timeout参数设置
fail_timeout time 指定数量的不成功尝试与服务器通信的时间应该考虑服务器不可用;以及服务器被视为不可用的时间段。默认情况下，参数设置为10秒。
backup 无 将服务器标记为备份服务器。当主服务器不可用时，它将被传递请求。
down 无 将服务器标记为永久不可用
resolve ip地址 监视与服务器域名对应的IP地址的更改，并自动修改上游配置，而无需重新启动nginx（1.5.12）。服务器组必须驻留在共享内存中。
route string 设置服务器路由名称。
service name 能够解析DNS SRV记录并设置服务名称（1.9.13）。要使此参数起作用，必须为服务器指定resolve参数并指定不带端口号的主机名。
slow_start time 设置服务器将其权重从零恢复到标称值的时间，当不健康的服务器变得健康时，或者服务器在一段时间被认为不可用后变得可用时。默认值为零，即禁用慢启动。

简单的配置方式如下。

upstream my-lb {
    ip_hash;
    server 192.168.1.100:8000 weight=9;
    server 192.168.1.100:8001 down;
    server 192.168.1.100:8002 max_fails=3;
    server 192.168.1.100:8003 fail_timeout=20s;
    server 192.168.1.100:8004 max_fails=3 fail_timeout=20s;
}
1
2
3
4
5
6
7
8
  1. server 192.168.1.100:8000 weight=9;：
    • 权重为9，表示它将接收更多的请求。
    • 默认情况下，正常运行，处理请求。
  2. server 192.168.1.100:8001 down;：
    • 标记为 down，表示它被标记为不可用，不会处理请求。
    • 不会接收到任何请求，因为被明确标记为不可用。
  3. server 192.168.1.100:8002 max_fails=3;：
    • 设置 max_fails 为3，表示如果它连续失败3次，将被标记为不可用。
    • 默认情况下，正常运行，处理请求。
  4. server 192.168.1.100:8003 fail_timeout=20s;：
    • 设置 fail_timeout 为20秒，表示如果它失败，Nginx会等待20秒后再尝试将请求发送到该服务器。
    • 如果失败后，Nginx会等待20秒，然后尝试重新发送请求。如果服务器在20秒内恢复正常，请求将继续发送到该服务器。
  5. server 192.168.1.100:8004 max_fails=3 fail_timeout=20s;：
    • 设置 max_fails 为3，表示如果它连续失败3次，将被标记为不可用。
    • 设置 fail_timeout 为20秒，如果它失败，Nginx会等待20秒后再尝试将请求发送到该服务器。

# 负载均衡策略

如果你有一个备用（backup）服务器和一个处于空闲状态的服务器，那么第一次访问 192.168.1.100:8000 服务器失败后，Nginx会采取以下行为：

  1. 首先，请求会尝试发送到 192.168.1.100:8000。
  2. 如果 192.168.1.100:8000 服务器失败（例如，由于应用程序崩溃或不可用），Nginx将等待 fail_timeout 时间（20秒）。
  3. 如果在 fail_timeout 时间内，192.168.1.100:8000 服务器恢复正常，Nginx将继续将请求发送到 192.168.1.100:8000。
  4. 如果在 fail_timeout 时间内，192.168.1.100:8000 服务器仍然失败，Nginx将在此时考虑备用（backup）服务器和处于空闲状态的服务器。
  5. 如果你的配置中设置了备用服务器，Nginx将将请求发送到备用服务器。
  6. 如果你的配置中还有其他处于空闲状态的服务器，Nginx可能将请求发送到其中之一，这取决于你的负载均衡配置。

总之，Nginx将等待 fail_timeout 时间后才会考虑备用服务器和其他服务器。如果备用服务器可用，它将被优先考虑。如果备用服务器也不可用，Nginx可能会将请求发送到其他空闲服务器，但具体行为取决于负载均衡策略。

完善页面 (opens new window)
nginx安装的三种方式
nginx配置-请求定位

← nginx配置-请求定位→

最近更新
01
JDK
02-23
02
BadTasteCode && 优化
09-11
03
Gradle 实践操作指南及最佳实践
09-11
更多文章>
Theme by Vdoing | Copyright © 2021-2025 Tandy | 粤ICP备2023113440号