Table of Contents

1: Nginx 配置
2: Listen Port
3: Access Log
4: Domain Name
5: Static Asset
6: Redirect
7: Reverse Proxy
8: Nginx 解决跨域
8: Load Balance
9: SSL 协议
10: Nginx 加速
11: location 语法
12: nginx 高可用 keepalived

1: Nginx 配置

https://mp.weixin.qq.com/s/6LwDWI9z5wxbaeG33FEAGw
1: /etc/nginx/conf.d/xxx.conf
2: 在/etc/nginx/nginx.conf文件中有一行就是把刚刚配置的引进总的 nginx 配置中 include /etc/nginx/conf.d/*.conf;
3: 配置完成后重新启动 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

sbin/nginx -t -c conf/nginx.conf # 检测配置文件是否正常
sbin/nginx -s reload -c conf/nginx.conf # 修改配置后平滑重启
sbin/nginx -s quit # 优雅关闭Nginx，会在执行完当前的任务后再退出
sbin/nginx -s stop # 强制终止Nginx，不管当前是否有任务在执行

nginx -s reopen #重启Nginx

nginx -s reload #重新加载Nginx配置文件，然后以优雅的方式重启Nginx

nginx -s stop #强制停止Nginx服务

nginx -s quit #优雅地停止Nginx服务（即处理完所有请求后再停止服务）

nginx -?,-h #打开帮助信息

nginx -v #显示版本信息并退出

nginx -V #显示版本和配置选项信息，然后退出

nginx -t #检测配置文件是否有语法错误，然后退出

nginx -T #检测配置文件是否有语法错误，转储并退出

nginx -q #在检测配置文件期间屏蔽非错误信息

nginx -p prefix #设置前缀路径(默认是:/usr/share/nginx/)

nginx -c filename #设置配置文件(默认是:/etc/nginx/nginx.conf)

nginx -g directives #设置配置文件外的全局指令

killall nginx #杀死所有nginx进程

2: Listen Port

监听端口

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

server {
    # Standard HTTP Protocol
    listen 80;
    # Standard HTTPS Protocol
    listen 443 ssl;
    # For http2
    listen 443 ssl http2;
    # Listen on 80 using IPv6
    listen [::]:80;
    # Listen only on using IPv6
    listen [::]:80 ipv6only=on;
}

3: Access Log

访问日志

1
2
3
4
5
6

server {
    # Relative or full path to log file
    access_log /path/to/file.log;
    # Turn 'on' or 'off'
    access_log on;
}

4: Domain Name

域名

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

server {
    # Listen to yourdomain.com
    server_name yourdomain.com;
    # Listen to multiple domains  server_name yourdomain.com www.yourdomain.com;
    # Listen to all domains
    server_name *.yourdomain.com;
    # Listen to all top-level domains
    server_name yourdomain.*;
    # Listen to unspecified Hostnames (Listens to IP address itself)
    server_name "";
}

5: Static Asset

静态资源

1
2
3
4
5
6
7

server {
    listen 80;
    server_name yourdomain.com;
    location / {
    root /path/to/website;
    }
}

6: Redirect

重定向

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

server {
    listen 80;
    server_name www.yourdomain.com;
    return 301 http://yourdomain.com$request_uri;
}
server {
    listen 80;
    server_name www.yourdomain.com;
    location /redirect-url {
        return 301 http://otherdomain.com;
    }
}

7: Reverse Proxy

反向代理

1
2
3
4
5
6
7
8

server {
    listen 80;
    server_name yourdomain.com;
    location / {
        proxy_pass http://0.0.0.0:3000;
        # where 0.0.0.0:3000 is your application server (Ex: node.js) bound on 0.0.0.0 listening on port 3000
    }
}

8: 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

server {
    listen 80;
    server_name yourdomain.com;
    location / {
        proxy_pass http://0.0.0.0:3000;
        # where 0.0.0.0:3000 is your application server (Ex: node.js) bound on 0.0.0.0 listening on port 3000
    }

    location / {
    # 允许跨域的请求，可以自定义变量$http_origin，*表示所有
    add_header 'Access-Control-Allow-Origin' *;
    # 允许携带cookie请求
    add_header 'Access-Control-Allow-Credentials' 'true';
    # 允许跨域请求的方法：GET,POST,OPTIONS,PUT
    add_header 'Access-Control-Allow-Methods' 'GET,POST,OPTIONS,PUT';
    # 允许请求时携带的头部信息，*表示所有
    add_header 'Access-Control-Allow-Headers' *;
    # 允许发送按段获取资源的请求
    add_header 'Access-Control-Expose-Headers' 'Content-Length,Content-Range';
    # 一定要有！！！否则Post请求无法进行跨域！
    # 在发送Post跨域请求前，会以Options方式发送预检请求，服务器接受时才会正式请求
    if ($request_method = 'OPTIONS') {
        add_header 'Access-Control-Max-Age' 1728000;
        add_header 'Content-Type' 'text/plain; charset=utf-8';
        add_header 'Content-Length' 0;
        # 对于Options方式的请求返回204，表示接受跨域请求
        return 204;
    }
    }
}

8: Load Balance

1. 在 http 节点下，加入 upstream 节点
1. 将 server 节点下的 location 节点中的 proxy_pass 配置为：http:// + upstream 名称，即"http://backserver"

8.1 RoundRobin 轮询(default)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

upstream backserver {
    server 10.0.6.108:7080;
    server 10.0.0.85:8980;
}
server {
    listen 80;
    server_name yourdomain.com;
    location / {
        proxy_pass http://backserver;
    }
}

8.2 weight (权重)

1
2
3
4
5

# 指定轮询几率，weight和访问比率成正比，用于后端服务器性能不均的情况
upstream backserver{
      server 10.0.0.77 weight=5;
      server 10.0.0.88 weight=10;
}

8.3 ip_hash（IP 绑定 ip_hash ）

1
2
3
4
5
6

# 每个请求按访问ip的hash结果分配，这样每个访客固定访问一个后端服务器，可以解决session的问题。
upstream backserver {
ip_hash;
server 192.168.0.14:88;
server 192.168.0.15:80;
}

8.4 url_hash

1

# 按访问url的hash结果来分配请求，使每个url定向到同一个后端服务器，后端服务器为缓存时比较有效。

8.5 fair（第三方）

1
2
3
4
5
6

# 按后端服务器的响应时间来分配请求，响应时间短的优先分配。
upstream backserver {
fair;
server server1;
server server2;
}

9: SSL 协议

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

server {
    listen 443 ssl;
    server_name yourdomain.com;
    ssl on;
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/privatekey.pem;
    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /path/to/fullchain.pem;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_session_timeout 1h;
    ssl_session_cache shared:SSL:50m;
    add_header Strict-Transport-Security max-age=15768000;
}
# Permanent Redirect for HTTP to HTTPS
server
{
    listen 80;
    server_name yourdomain.com;
    return 301 https://$host$request_uri;
}

10: Nginx 加速

10.1 启用 Gzip 压缩

1
2
3
4
5
6
7
8
9

gzip on;
gzip_types application/xml
    application/json
    text/css
    text/javascript
    application/javascript;
gzip_vary on;
gzip_comp_level 6; //压缩比
gzip_min_length 500; //设置压缩最小单位，小于不压缩

10.2 设置缓存头

Setting Cache Headers 浏览器检索网页文件时，会将副本保留在本地磁盘缓存中。这样，当你再次访问该页面时，浏览器就不必从服务器重新获取文件。每个浏览器都有自己的使用逻辑，来决定何时使用该文件对应的本地副本，以及何时在服务器更改了该文件时再次获取它。但是，作为网站所有者，你可以在发送的 HTTP 响应中设置缓存控制和过期标头，以提高浏览器的缓存行为的效率，从而减少很多不必要的 HTTP 请求。

首先，可以为字体和图像设置较长的缓存过期时间，这些字体和图像可能不会经常更改。在下面的示例中，设置客户端浏览器将字体和图像在本地缓存中保留一个月。

1
2
3
4

location ~* \.(?:jpg|jpeg|gif|png|ico|woff2)$ {
    expires 1M;
    add_header Cache-Control "public";
}

10.3 启用 HTTP2 协议

1

listen 443 ssl http2;

10.4 优化日志 Optimizing Logging

我们在管理网站的时候，即使是有对应的监控服务，但是对应日志分析还是不够到位。你也可能只关注错误(400 和 500 个状态码等等)，而不是成功的请求。通过减少不必要的日志记录，可以节省服务器上的磁盘存储、CPU 和 I/O 操作。这不仅可以让我们服务器更快一些，而且释放的资源可以用来运行其他服务。

有几种不同的方法可以减少和优化日志记录，但是在这里，我们重点介绍三个。

10.4.1 禁用页面资源请求的日志记录

1
2
3
4
5

# 如果我们不需要记录检索普通页面资源的请求，比如图像文件、JavaScript 文件和 CSS 文件等等，
# 那么这是一个快速而简单的解决方案。你所需要做的就是创建一个与这些文件类型匹配的 location 块，并配置禁用其中的日志记录。
location ~* \.(?:jpg|jpeg|gif|png|ico|woff2|js|css)$ {
    access_log off;
}

10.4.2 禁用成功请求的日志记录

这是一种更好的方法，因为它会丢弃带有 2xx 或 3xx 的响应查询，仅记录错误请求。它比方法 1 稍微复杂一点，因为它取决于您的 Nginx 日志记录的配置方式。

使用 Nginx 官方文档中的示例，让我们打开条件日志记录。创建一个 $loggable 的变量并将其设置为 0，用于带有 2xx 和 3xx 响应代码的日志请求，否则设置为 1，即可。然后在 access_log 指令中，将该变量作为条件引用。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# /etc/nginx/nginx.conf
access_log /var/log/nginx/access.log;

# access_log directive
map $status $loggable {
    ~^[23] 0;
    default 1;
}

access_log /var/log/nginx/access.log combined if=$loggable;

10.4.3 最小化 I/O 操作

即使你要记录所有请求，也可以通过打开访问日志缓冲来最大程度地减少 I/O 操作。使用此指令，Nginx 将等待将日志数据写入磁盘，直到填满 512KB 缓冲区或自上次刷新以来已过了 1 分钟（以先发生者为准）

1

access_log /var/log/nginx/access.log combined buffer=512k flush=1m;

10.5 限制带宽

Limiting Bandwidth for Particular URLs

使用 limit_rate 指令来限制特定 URL 的带宽。在这里，我们将 /download 下每个文件的传输速率限制为每秒 50KB 的速度。

1
2
3

location /download/ {
    limit_rate 50k;
}

你可能还希望仅对较大的文件进行速率限制，这可以通过 limit_rate_after 指令进行。在此示例中，每个文件(来自任何目录)的前 500KB 都不受速度限制地进行传输，之后的所有内容均以 50KB/s 的速度为上限。这样可以加快网站关键部分的交付速度，同时降低其他部分的速度。

1
2
3
4

location / {
    limit_rate_after 500k;
    limit_rate 50k;
}

请注意，速率限制仅适用于浏览器和 Nginx 之间的单个 HTTP 连接

11: location 语法

location 指令用来 match url
语法如下:

1
2
3
4
5
6
7
8
9

location[ = | ~ | ~* | ^~] url{

}

=:用于不含正则表达式的url前，要求字符串与url严格匹配，匹配成功就停止向下搜索并处理请求
~：用于表示url包含正则表达式，并且区分大小写。
~*：用于表示url包含正则表达式，并且不区分大瞎写
^~：用于不含正则表达式的url前，要求ngin服务器找到表示url和字符串匹配度最高的location后，立即使用此location处理请求，而不再匹配
如果有url包含正则表达式，不需要有~开头标识

12: nginx 高可用 keepalived

准备 2 台 Nginx 服务器
安装 keepalived
虚拟 IP
https://mp.weixin.qq.com/s/6LwDWI9z5wxbaeG33FEAGw

13: nginx 性能优化

13.1 开启长链接配置

通常 Nginx 作为代理服务，负责分发客户端的请求，那么建议开启 HTTP 长连接，用户减少握手的次数，降低服务器损耗，具体如下：

1
2
3
4
5
6
7
8

upstream xxx {
    # 长连接数
    keepalive 32;
    # 每个长连接提供的最大请求数
    keepalived_requests 100;
    # 每个长连接没有新的请求时，保持的最长时间
    keepalive_timeout 60s;
}

13.2 开启零拷贝技术

零拷贝这个概念，在大多数性能较为不错的中间件中都有出现，例如 Kafka、Netty 等，而 Nginx 中也可以配置数据零拷贝技术，如下：sendfile on; # 开启零拷贝机制
零拷贝读取机制与传统资源读取机制的区别：传统方式：「硬件–>内核–>用户空间–>程序空间–>程序内核空间–>网络套接字」零拷贝方式：「硬件–>内核–>程序内核空间–>网络套接字」从上述这个过程对比，很轻易就能看出两者之间的性能区别。

13.3 开启无延迟或多包共发机制

在 Nginx 中有两个较为关键的性能参数，即 tcp_nodelay、tcp_nopush，开启方式如下：

1
2

tcp_nodelay on;
tcp_nopush on;

TCP/IP 协议中默认是采用了 Nagle 算法 的，即在网络数据传输过程中，每个数据报文并不会立马发送出去，而是会等待一段时间，将后面的几个数据包一起组合成一个数据报文发送，但这个算法虽然提高了网络吞吐量，但是实时性却降低了.因此你的项目属于交互性很强的应用，那么可以手动开启 tcp_nodelay 配置，让应用程序向内核递交的每个数据包都会立即发送出去。但这样会产生大量的 TCP 报文头，增加很大的网络开销。
相反，有些项目的业务对数据的实时性要求并不高，追求的则是更高的吞吐，那么则可以开启 tcp_nopush 配置项，这个配置就类似于“塞子”的意思，首先将连接塞住，使得数据先不发出去，等到拔去塞子后再发出去。设置该选项后，内核会尽量把小数据包拼接成一个大的数据包（一个 MTU）再发送出去.当然若一定时间后（一般为 200ms），内核仍然没有积累到一个 MTU 的量时，也必须发送现有的数据，否则会一直阻塞。
tcp_nodelay、tcp_nopush 两个参数是“互斥”的，如果追求响应速度的应用推荐开启 tcp_nodelay 参数，如 IM、金融等类型的项目。如果追求吞吐量的应用则建议开启 tcp_nopush 参数，如调度系统、报表系统等。
注意：①tcp_nodelay 一般要建立在开启了长连接模式的情况下使用。②tcp_nopush 参数是必须要开启 sendfile 参数才可使用的。

13.4 调整 worker 工作进程

Nginx 启动后默认只会开启一个 Worker 工作进程处理客户端请求，而我们可以根据机器的 CPU 核数开启对应数量的工作进程，以此来提升整体的并发量支持，如下：

1
2
3
4
5
6

# 自动根据CPU核心数调整Worker进程数量
worker_processes auto;

# 同时也可以稍微调整一下每个工作进程能够打开的文件句柄数：
# 每个Worker能打开的文件描述符，最少调整至1W以上，负荷较高建议2-3W
worker_rlimit_nofile 20000;

操作系统内核（kernel）都是利用文件描述符来访问文件，无论是打开、新建、读取、写入文件时，都需要使用文件描述符来指定待操作的文件，因此该值越大，代表一个进程能够操作的文件越多（但不能超出内核限制，最多建议 3.8W 左右为上限）

13.5 开启 CPU 亲和机制

对于并发编程较为熟悉的伙伴都知道，因为进程/线程数往往都会远超出系统 CPU 的核心数，因为操作系统执行的原理本质上是采用时间片切换机制，也就是一个 CPU 核心会在多个进程之间不断频繁切换，造成很大的性能损耗。而 CPU 亲和机制则是指将每个 Nginx 的工作进程，绑定在固定的 CPU 核心上，从而减小 CPU 切换带来的时间开销和资源损耗，开启方式如下：worker_cpu_affinity auto;

13.6 开启 epoll 模型以及调整并发连接数

在最开始就提到过：Nginx、Redis 都是基于多路复用模型去实现的程序，但最初版的多路复用模型 select/poll 最大只能监听 1024 个连接，而 epoll 则属于 select/poll 接口的增强版，因此采用该模型能够大程度上提升单个 Worker 的性能，如下：

1
2
3
4
5
6

events {
    # 使用epoll网络模型
    use epoll;
    # 调整每个Worker能够处理的连接数上限
    worker_connections  10240;
}

01-Nginx 常用配置清单.md

文章目录