项目中经常使用nginx做负载均衡,接口路由、文件、文档的上传及下载、视频的代理播放等等,都离不开nginx的支持,今天我们分享一下其个使用场景。
1、配置文件 nd-nginx.conf
全局配置
#全局配置端,对全局生效,主要设置nginx的启动用户/组,启动的工作进程数量,工作模式,Nginx的PID路径,日志路径等。
#user nobody;
#user nginx nginx;#启动Nginx工作进程的用户和组
worker_processes 1; #启动工作进程数数量
#worker_processes [number | auto]; #启动Nginx工作进程的数量,一般设为和CPU核心数相同
#worker_cpu_affinity 00000001 00000010 00000100 00001000 | auto ;
#将Nginx工作进程绑定到指定的CPU核心,默认Nginx是不进行进程绑定的,绑定并不是意味着当前nginx进程独占以一核心CPU,
#但是可以保证此进程不会运行在其他核心上,这就极大减少了nginx的工作进程在不同的cpu核心上的来回跳转,
#减少了CPU对进程的资源分配与回收以及内存管理等,因此可以有效的提升nginx服务器的性能。
#error_log logs/error.log;
#error_log logs/error.log notice;
#error_log logs/error.log info;
#pid logs/nginx.pid;
#events设置快,主要影响nginx服务器与用户的网络连接,比如是否允许同时接受多个网络连接,
#使用哪种事件驱动模型处理请求,每个工作进程可以同时支持的最大连接数,是否开启对多工作进程下的网络连接进行序列化等。
events {
#设置单个nginx工作进程可以接受的最大并发,作为web服务器的时候最大并发数为worker_connections * worker_processes,
#作为反向代理的时候为(worker_connections * worker_processes)/2
worker_connections 1024;
}
文件上面全局配置
2、http 模块详解
#http块是Nginx服务器配置中的重要部分,缓存、代理和日志格式定义等绝大多数功能和第三方模块都可以在这设置,
#http块可以包含多个server块,而一个server块中又可以包含多个location块,
#server块可以配置文件引入、MIME-Type定义、日志自定义、是否启用sendfile、连接超时时间和单个链接的请求上限等。
http {
#通用配置....
# N个server 模块虚拟服务器
}
3、http模块里面通用的配置
include mime.types; #导入支持的文件类型,是相对于/apps/nginx/conf的目录,在响应报文中将指定的文件扩展名映射至MIME对应的类型
default_type application/octet-stream; #除mime.types中文件类型外,设置其它文件默认类型,访问其它类型时会提示下载不匹配的类型文件
#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 logs/access.log main;
#作为web服务器的时候打开sendfile加快静态文件传输,指定是否使用sendfile系统调用来传输文件,
#sendfile系统调用在两个文件描述符之间直接传递数据(完全在内核中操作),从而避免了数据在内核缓冲区和用户缓冲区之间的拷贝,
#操作效率很高,被称之为零拷贝,硬盘 >> kernel buffer (快速拷贝到kernelsocket buffer) >>协议栈。
sendfile on;
#tcp_nopush on;
#keepalive_timeout 0;
keepalive_timeout 65; #长连接超时时间,单位是秒
#开启gzip压缩,若想关闭gzip压缩,则需要注释掉这句话,或者将on换成off
#gzip on;
#配置允许压缩的页面的最小字节数,页面字节数从header头中的Content-Length中获>取,建议设置成1k,因为如果数据小于1k,他也会压缩成1k,这样会起到反作用。
#gzip_min_length 1k;
#4个16k的数据流用于存储gzip的压缩结果数据流
#gzip_buffers 4 16k;
#支持的http版本为1.1
#gzip_http_version 1.1;
#判断客户端是否支持gzip技术,若不支持则不会进行gzip处理
#gzip_vary on;
# 全局跨域配置
#为 * 表示服务器可以接受所有的请求源(Origin),即接受所有跨域的请求,也可以指定一个确定的URL
add_header 'Access-Control-Allow-Origin' '*' always;
#可选字段,为true表示允许发送Cookie。同时,发送时,必须设置XMLHttpRequest.withCredentials为true才有效,请求若服务器不允许浏览器发送,删除该字段即可。
add_header 'Access-Control-Allow-Credentials' 'true';
#代表允许使用指定的方法请求该地址
add_header 'Access-Control-Allow-Methods' 'GET, POST, PATCH, DELETE, PUT, OPTIONS';
#代表允许在请求该地址的时候带上指定的请求头,例如:Content-Type,Authorization,使用逗号(,)拼接起来放在双引号(")中
add_header 'Access-Control-Allow-Headers' 'DNT,X-Mx-ReqToken,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type, X-Custom-Header, Access-Control-Expose-Headers, Token, Authorization';
add_header 'Access-Control-Allow-Headers' '*';
#代表着在 1728000 秒之内不用请求该地址的时候 不需要再进行预检请求,也就是跨域缓存。
add_header 'Access-Control-Max-Age' 1728000;
4、server 虚拟服务器详解及通用配置
#每个server用于定义一个虚拟主机,第一个server为默认虚拟服务器
server {
#设置一个虚拟机主机,可以包含自己的全局快,同时也可以包含多个location模块。
#比如本虚拟机监听的端口、本虚拟机的名称和IP配置,多个server 可以使用一个端口,比如都使用80端口提供web服务
listen 80; #配置server监听的端口
server_name localhost; #本server的名称,当访问此名称的时候nginx会调用当前serevr内部的配置进程匹配。
#是否在响应报文中的Content-Type显示指定的字符集,默认off不显示
#charset charset | off;
#charset koi8-r;#设置编码格式,默认是俄语格式,建议改为utf-8
#示例
#charset utf-8;
#access_log logs/host.access.log main;
autoindex on; # 显示目录,默认不开启
autoindex_localtime on;# 显示文件修改时间 # 显示文件大小
#多个 location 配置....
}
5、server 中 多个location 配置
#以http的方式转发mp4请求到指定web服务器。
#访问 http://127.0.0.1/6d.mp4 就可以播放视频,而视频6d.mp4就在html/dist目录下。
location ~ /.mp4$ {
#root E:shnginx; # 你的文件目录
mp4; # 支持mp4
mp4_buffer_size 10m;#处理mp4初始内存大小
mp4_max_buffer_size 50m;#处理mp4最大内存大小
}
location / {
root html/dist;#相当于默认页面的目录名称,默认是安装目录的相对路径,可以使用绝对路径配置。
index index.html index.htm;#默认的页面文件名称
#给OPTIONS 添加 204 的返回,为了处理在发送POST请求时Nginx依然拒绝访问的错误,发送"预检请求"时,需要用到方法 OPTIONS,所以服务器需要允许该方法。
if ($request_method = 'OPTIONS') {
return 204;
}
}
#proxy_pass的配置详解在后面
location /test {
proxy_pass http://127.0.0.1:9006;
proxy_redirect off;#关闭重定向
#proxy_redirect #旧地址 新地址;
#proxy_redirect default; #默认配置
#若客户端发过来的请求header中有HOST这个字段,$http_host和$host表示的就是原始请求host,比如请求的时候HOST的值是http://demo.com,那么反代后还是http://demo.com。
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;#将$remote_addr的值放进变量X-Real-IP中,此变量名可变,$remote_addr的值为客户端的ip
proxy_set_header X-forwarded-For $proxy_add_x_forwarded_for;#获得用户真实ip
}
location /ars {
proxy_pass http://192.8.3.211:9006;
}
#/person/getPersonUrl
location /kvc {
add_header 'Access-Control-Allow-Origin' '*' ;
add_header 'Access-Control-Allow-Credentials' 'true';
add_header 'Access-Control-Allow-Methods' '*';
add_header 'Access-Control-Allow-Headers' '*';
add_header 'Access-Control-Max-Age' 1728000;
proxy_pass http://192.8.3.211:1288;
}
location /about {
root /app/html; #必须要在html目录中创建一个名为about的目录才可以访问,否则报错。
}
location /about { #注意about后不要加/ , 使用alias的时候uri后面如果加了斜杠,则下面的路径配置必须加斜杠,否则403
alias /opt/html/about; #当访问about的时候,会显示alias定义的/opt/html/about里面的内容。
}
#注意:location中使用root指令和alias指令的意义不同
#root 给定的路径对应于location中的/uri 左侧的/
#alias 给定的路径对应于location中的/uri 的完整路径
#error_page 404 /404.html;#错误页面的文件名称
# redirect server error pages to the static page /50x.html
#
error_page 500 502 503 504 /50x.html;#错误页面的文件名称
location = /50x.html { #location处理对应的不同错误码的页面定义到/50x.html,这个跟对应其server中定义的目录下。
root html;#定义默认页面所在的目录
}
6、第二个server,单独处理视频播放
#serverd第二个服务虚拟服务器
#访问http://127.0.0.1:8088/6d.mp4 就可以播放视频,而视频6d.mp4就在E:/sh/nginx/nginx目录下。
server {
listen 8088;
server_name 127.0.0.1;
charset utf-8,gbk;
#root /usr/local/nginx/html/files; # 你的文件目录
root E:/sh/nginx/nginx; # 你的文件目录
# 显示目录,默认不开启
autoindex on;
# 显示文件大小
# 显示文件修改时间
autoindex_localtime on;
location ~ /.mp4$ {
mp4; # 支持mp4
mp4_buffer_size 10m;
mp4_max_buffer_size 50m;
}
}
7、第三个server 单独展示图片
#作为下载服务器配置
#官方文档:http://nginx.org/en/docs/http/ngx_http_autoindex_module.html
#作为上传服务器
# 定义缓存目录
proxy_cache_path E:/sh/nginx/nginx/cache levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m;
server {
listen 8081;
location ~* /.(jpg|jpeg|png|gif)$ {
# 开启缓存功能
proxy_cache my_cache;
# 指定缓存时间(单位为秒)
proxy_cache_valid any 30d;
# 如果未命中缓存则从后端服务器获取并进行缓存
#proxy_pass http://backend-server;
# 其他相关配置...
}
location ~* /.(css|js)$ {
#1h代表一小时
expires 1h;
# 开启缓存功能
proxy_cache my_cache;
# 指定缓存时间(单位为秒)
proxy_cache_valid any 30d;
}
}
8、整个配置文件展示
#全局配置端,对全局生效,主要设置nginx的启动用户/组,启动的工作进程数量,工作模式,Nginx的PID路径,日志路径等。
#user nobody;
#user nginx nginx;#启动Nginx工作进程的用户和组
worker_processes 1; #启动工作进程数数量
#worker_processes [number | auto]; #启动Nginx工作进程的数量,一般设为和CPU核心数相同
#worker_cpu_affinity 00000001 00000010 00000100 00001000 | auto ;
#将Nginx工作进程绑定到指定的CPU核心,默认Nginx是不进行进程绑定的,绑定并不是意味着当前nginx进程独占以一核心CPU,
#但是可以保证此进程不会运行在其他核心上,这就极大减少了nginx的工作进程在不同的cpu核心上的来回跳转,
#减少了CPU对进程的资源分配与回收以及内存管理等,因此可以有效的提升nginx服务器的性能。
#error_log logs/error.log;
#error_log logs/error.log notice;
#error_log logs/error.log info;
#pid logs/nginx.pid;
#events设置快,主要影响nginx服务器与用户的网络连接,比如是否允许同时接受多个网络连接,
#使用哪种事件驱动模型处理请求,每个工作进程可以同时支持的最大连接数,是否开启对多工作进程下的网络连接进行序列化等。
events {
#设置单个nginx工作进程可以接受的最大并发,作为web服务器的时候最大并发数为worker_connections * worker_processes,
#作为反向代理的时候为(worker_connections * worker_processes)/2
worker_connections 1024;
}
#http块是Nginx服务器配置中的重要部分,缓存、代理和日志格式定义等绝大多数功能和第三方模块都可以在这设置,
#http块可以包含多个server块,而一个server块中又可以包含多个location块,
#server块可以配置文件引入、MIME-Type定义、日志自定义、是否启用sendfile、连接超时时间和单个链接的请求上限等。
http {
include mime.types; #导入支持的文件类型,是相对于/apps/nginx/conf的目录,在响应报文中将指定的文件扩展名映射至MIME对应的类型
default_type application/octet-stream; #除mime.types中文件类型外,设置其它文件默认类型,访问其它类型时会提示下载不匹配的类型文件
#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 logs/access.log main;
#作为web服务器的时候打开sendfile加快静态文件传输,指定是否使用sendfile系统调用来传输文件,
#sendfile系统调用在两个文件描述符之间直接传递数据(完全在内核中操作),从而避免了数据在内核缓冲区和用户缓冲区之间的拷贝,
#操作效率很高,被称之为零拷贝,硬盘 >> kernel buffer (快速拷贝到kernelsocket buffer) >>协议栈。
sendfile on;
#tcp_nopush on;
#keepalive_timeout 0;
keepalive_timeout 65; #长连接超时时间,单位是秒
#开启gzip压缩,若想关闭gzip压缩,则需要注释掉这句话,或者将on换成off
#gzip on;
#配置允许压缩的页面的最小字节数,页面字节数从header头中的Content-Length中获>取,建议设置成1k,因为如果数据小于1k,他也会压缩成1k,这样会起到反作用。
#gzip_min_length 1k;
#4个16k的数据流用于存储gzip的压缩结果数据流
#gzip_buffers 4 16k;
#支持的http版本为1.1
#gzip_http_version 1.1;
#判断客户端是否支持gzip技术,若不支持则不会进行gzip处理
#gzip_vary on;
# 全局跨域配置
#为 * 表示服务器可以接受所有的请求源(Origin),即接受所有跨域的请求,也可以指定一个确定的URL
add_header 'Access-Control-Allow-Origin' '*' always;
#可选字段,为true表示允许发送Cookie。同时,发送时,必须设置XMLHttpRequest.withCredentials为true才有效,请求若服务器不允许浏览器发送,删除该字段即可。
add_header 'Access-Control-Allow-Credentials' 'true';
#代表允许使用指定的方法请求该地址
add_header 'Access-Control-Allow-Methods' 'GET, POST, PATCH, DELETE, PUT, OPTIONS';
#代表允许在请求该地址的时候带上指定的请求头,例如:Content-Type,Authorization,使用逗号(,)拼接起来放在双引号(")中
add_header 'Access-Control-Allow-Headers' 'DNT,X-Mx-ReqToken,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type, X-Custom-Header, Access-Control-Expose-Headers, Token, Authorization';
add_header 'Access-Control-Allow-Headers' '*';
#代表着在 1728000 秒之内不用请求该地址的时候 不需要再进行预检请求,也就是跨域缓存。
add_header 'Access-Control-Max-Age' 1728000;
#每个server用于定义一个虚拟主机,第一个server为默认虚拟服务器
server {
#设置一个虚拟机主机,可以包含自己的全局快,同时也可以包含多个location模块。
#比如本虚拟机监听的端口、本虚拟机的名称和IP配置,多个server 可以使用一个端口,比如都使用80端口提供web服务
listen 80; #配置server监听的端口
server_name localhost; #本server的名称,当访问此名称的时候nginx会调用当前serevr内部的配置进程匹配。
#是否在响应报文中的Content-Type显示指定的字符集,默认off不显示
#charset charset | off;
#charset koi8-r;#设置编码格式,默认是俄语格式,建议改为utf-8
#示例
#charset utf-8;
#access_log logs/host.access.log main;
autoindex on; # 显示目录,默认不开启
autoindex_localtime on;# 显示文件修改时间 # 显示文件大小
#以http的方式转发mp4请求到指定web服务器。
#访问 http://127.0.0.1/6d.mp4 就可以播放视频,而视频6d.mp4就在html/dist目录下。
location ~ /.mp4$ {
#root E:shnginx; # 你的文件目录
mp4; # 支持mp4
mp4_buffer_size 10m;#处理mp4初始内存大小,表示缓冲区大小为1 MB。这个值的设置可以根据服务器的性能和需求进行调整。
mp4_max_buffer_size 50m;#处理mp4最大内存大小,表示最大缓冲区大小为5 MB。一旦达到这个大小,Nginx 将开始向客户端发送视频数据,即使视频文件没有完全缓冲。
}
location / {
root html/dist;#相当于默认页面的目录名称,默认是安装目录的相对路径,可以使用绝对路径配置。
index index.html index.htm;#默认的页面文件名称
#给OPTIONS 添加 204 的返回,为了处理在发送POST请求时Nginx依然拒绝访问的错误,发送"预检请求"时,需要用到方法 OPTIONS,所以服务器需要允许该方法。
if ($request_method = 'OPTIONS') {
return 204;
}
}
#proxy_pass的配置详解区别 https://blog.csdn.net/jsxztshaohaibo/article/details/134578031
location /test {
proxy_pass http://127.0.0.1:9016;
proxy_redirect off;#关闭重定向
#proxy_redirect #旧地址 新地址;
#proxy_redirect default; #默认配置
#若客户端发过来的请求header中有HOST这个字段,$http_host和$host表示的就是原始请求host,比如请求的时候HOST的值是http://demo.com,那么反代后还是http://demo.com。
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;#将$remote_addr的值放进变量X-Real-IP中,此变量名可变,$remote_addr的值为客户端的ip
proxy_set_header X-forwarded-For $proxy_add_x_forwarded_for;#获得用户真实ip
}
location /artemis {
proxy_pass http://192.8.3.211:9006;
}
#/person/getPersonUrl
location /kcvc {
add_header 'Access-Control-Allow-Origin' '*' ;
add_header 'Access-Control-Allow-Credentials' 'true';
add_header 'Access-Control-Allow-Methods' '*';
add_header 'Access-Control-Allow-Headers' '*';
add_header 'Access-Control-Max-Age' 1728000;
proxy_pass http://192.8.3.211:1288;
}
location /about {
root /app/html; #必须要在html目录中创建一个名为about的目录才可以访问,否则报错。
}
location /about { #注意about后不要加/ , 使用alias的时候uri后面如果加了斜杠,则下面的路径配置必须加斜杠,否则403
alias /opt/html/about; #当访问about的时候,会显示alias定义的/opt/html/about里面的内容。
}
#注意:location中使用root指令和alias指令的意义不同
#root 给定的路径对应于location中的/uri 左侧的/
#alias 给定的路径对应于location中的/uri 的完整路径
#error_page 404 /404.html;#错误页面的文件名称
# redirect server error pages to the static page /50x.html
#
error_page 500 502 503 504 /50x.html;#错误页面的文件名称
location = /50x.html { #location处理对应的不同错误码的页面定义到/50x.html,这个跟对应其server中定义的目录下。
root html;#定义默认页面所在的目录
}
}
#serverd第二个服务虚拟服务器
#访问http://127.0.0.1:8088/6d.mp4 就可以播放视频,而视频6d.mp4就在E:/sh/nginx/nginx目录下。
server {
listen 8088;
server_name 127.0.0.1;
charset utf-8,gbk;
#root /usr/local/nginx/html/files; # 你的文件目录
root E:/sh/nginx/nginx; # 你的文件目录
# 显示目录,默认不开启
autoindex on;
# 显示文件大小
# 显示文件修改时间
autoindex_localtime on;
location ~ /.mp4$ {
mp4; # 支持mp4
mp4_buffer_size 10m;
mp4_max_buffer_size 50m;
}
}
#作为下载服务器配置
#官方文档:http://nginx.org/en/docs/http/ngx_http_autoindex_module.html
#作为上传服务器
# 定义缓存目录
proxy_cache_path E:/sh/nginx/nginx/cache levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m;
server {
listen 8081;
location ~* /.(jpg|jpeg|png|gif)$ {
# 开启缓存功能
proxy_cache my_cache;
# 指定缓存时间(单位为秒)
proxy_cache_valid any 30d;
# 如果未命中缓存则从后端服务器获取并进行缓存
#proxy_pass http://backend-server;
# 其他相关配置...
}
location ~* /.(css|js)$ {
#1h代表一小时
expires 1h;
# 开启缓存功能
proxy_cache my_cache;
# 指定缓存时间(单位为秒)
proxy_cache_valid any 30d;
}
}
}
9、参考proxy_pass的配置详解区别
参考代理uri区别文章
到此,单体服务的多种使用场景从不同角度展示出来了,分享告一段落,后面会持续更新,敬请期待!