项目中经常使用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:\sh\nginx; # 你的文件目录 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:\sh\nginx; # 你的文件目录 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区别文章
到此,单体服务的多种使用场景从不同角度展示出来了,分享告一段落,后面会持续更新,敬请期待!