前一阵子用nginx摊派了我网站由tomcat处理的的http做事修车工作群群名称,本文就跟人人共享下我的实战历程,以及若何从0运转用nginx来走访你的前端形貌,接待诸位感酷爱的拓荒者阅读本文。
写在前边我开源形貌[1]的第三方登录模块用到了localStorage来得回用户的授权恶果,前几天有个网友响应说他从我著作的辘集中点进去没法登录。

经过一番排查后,我发现我在著作中留的辘集是https://kaisir.cn/chat-system[2],而第三方鉴权回调确立的辘集是https://www.kaisir.cn/chat-system[3]。由于我域名通晓何处设置了@走访与www走访指向的都是消除个网站,因此两者走访界面调换。然而回调地址中有www,苦求授权的走访界面莫得www,出现了跨域问题。
跨域后,localStorage里的东西当然是不一样的,因此就出现了这个网友所说的问题。
处祈望法既然两者走访的都是消除个做事器上的资源,那么咱们就不错在做事端设置重定向,当苦求的地址莫得佩带www时,咱们就给他重定向到带www的地址。
于是我搜了一波使用tomcat设置未佩带www的网站自动添加www,看了一眼有蓄意,相比清贫,不念念折腾。

经过一番搜索后,我发现使用nginx处理这个问题相比简约,于是我花了少许时辰学了下nginx,圆善处理了这个问题。
注重:本文不先容若何安设nginx,对此不了解的拓荒者,请移步nginx官网[4]进行学习。
移除tomcat的设置领先咱们先把tomact已设置好的一些http做事移撤回,此处要删除的有:http走访跳转https、域名文凭、静态资源。
注重:如若你莫得使用tomcat不错跳过此章节, 径直学习nginx的有关设置。
关闭https走访,删除域名文凭
咱们大开tomcat的conf目次下的server.xml,找到Service标签里port为80的Connector标签,删除标签内的redirectPort属性,如下图所示。

注重:你还需要修改port的值,将其改为恣意一个非80的值,因为nginx需要使用80端标语。
随后,接续找port为443的Connector标签,将其删除,如下图所示。

临了,删除你目次下后缀为jks的域名文献即可。

大开tomcat的webapps目次将你的静态资源(前端形貌)删掉即可。

咱们大开tomcat的conf目次下的web.xml文献,找到login-config标签和security-constraint的履行,将其删除,如下所示:
<!--开启http强制跳转https走访--> 修车工作群群名称<login-config> <!-- Authorization setting for SSL --> <auth-method>CLIENT-CERT</auth-method> <realm-name>Client Cert Users-only Area</realm-name> </login-config> <security-constraint> <!-- Authorization setting for SSL --> <web-resource-collection> <web-resource-name>SSL</web-resource-name> <url-pattern>/*</url-pattern> </web-resource-collection> <user-data-constraint> <transport-guarantee>CONFIDENTIAL</transport-guarantee> </user-data-constraint> </security-constraint>
设置nginx
接下来,咱们来设置nginx,让它来全面经受客户端的http苦求,反向代理tomcat提供的做事,告捷与tomcat完成团结。
设置诬捏主机领先,咱们需要先把诬捏主机设置好,它的作用便是模块化照看你的总计做事器资源,幸免一都都一股脑的写入nginx的主设置文献,从而导致的可珍爱性缩小问题。
咱们大开nginx的conf目次,在其目次下找到virtualhost.conf的文献(如若莫得则需要手动创建),该文献的作用便是将总计的做事器设置引入进来进行长入照看,大开文献后,咱们写入如下所示的履行:
# VirtualHost Configuration. # 默许存在的,如若不存在不错不睬 include vhosts/localhost.vhost; # 咱们新加的 include vhosts/kaisir.cn;
在上头的设置文献中,咱们新加了一个kaisir.cn的设置,咱们需要在vhosts目次下创建这个文献,这个目次亦然在conf目次中的(如若莫得就我方创建),咱们径直创建这个文献即可。

注重:创建的文献不可包含后缀名,如若你有多个诈欺则在此处创建,然后在virtualhost.conf文献中使用include提醒进行引入即可。
随后,咱们大开conf目次下的nginx.conf文献,把刚才创建的virtualhost.conf文献引入进去,咱们找到http标签,在标签里面添加如下所示的履行:
# ...其他履行不祥... http { # 引入做事设置文献 include virtualhost.conf; }
作念完上述操作后,咱们就不错惬心的剪辑咱们在vhosts目次下创建的文献了。
做事器设置文献在上述设置中,咱们在vhosts目次下创建的文献便是咱们的做事器设置文献了,柬埔寨修车群http走访的有关设置都是在此文献中进行写入。
设置端口监听咱们大开前边创建的kaisir.cn文献,写入如下所示的履行:
server { listen 80; listen 443 ssl; }
上述设置中:
server 为本文献的根提醒,本章节背面总计的设置都是写在这个这个提醒里面的 listen 监听80端口(即宽泛http的走访) listen 监听443端口以及ssl走访(即https的走访) 设置ssl文凭咱们写入如下所示的代码用来设置https走访时所需的ssl文凭文献:
# 设置ssl文凭 ssl_certificate /Users/likai/nginx-website/conf/kaisir.cn/1_kaisir.cn_bundle.crt; ssl_certificate_key /Users/likai/nginx-website/conf/kaisir.cn/2_kaisir.cn.key; ssl_session_timeout 5m; ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4; ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3; ssl_prefer_server_ciphers on;
上述设置中,咱们主要修改2个部分的设置:
ssl_certificate 你域名的ssl文凭文献位置(文献类型一定为crt本事的) ssl_certificate_key 你域名文凭所对应的密钥文献 (文献类型一定为key本事的)注重:ssl文凭需要去你域名的注册商何处下载
设置网站走访旅途接下来,咱们来设置下每个走访旅途所指向的静态资源(前端形貌),咱们会用location提醒来设置一条旅途的走访,如下所示,咱们设置了域名的根目次指向(即/的含义),提醒里面离别指定了静态资源在硬盘中的旅途以及默许的首页文献。
# 根旅途 location / { # 形貌旅途 root /Users/likai/nginx-website/kasir.cn; # 默许首页文献 index index.html index.htm; }
设置完根目次后,咱们再来看下子目次的有关走访设置,如下所示:
location /chat-system { # 形貌旅途 alias /Users/likai/nginx-website/chat-system/; # 默许首页文献 index index.html index.htm; # 处理网页刷新404 try_files $uri $uri/ /chat-system/index.html; }
通过不雅察上述设置后,咱们发现的不同点如下:
alias 设置子目次时,咱们使用了alias来指向形貌 try_files 这里是处理vue形貌启用history花式后,网页刷新404问题注重:如若你的vue形貌是用Vue CLI搭建的,那么就需要修改vue.config.js中的publicPath属性值为:process.env.NODE_ENV === "development" ? "./" : "/chat-system"。"/chat-system"即为坐褥环境的走访旅途,便是咱们刚才在location提醒行所设置的。如若此处设置演叨的话,你打包后的vue形貌在浏览器走访将使一派空缺??
临了,在路由设置文献中,传入参数:createWebHistory(process.env.BASE_URL)。
具体代码请移步提交记载:build: 启用路由的history花式[5]
自界说演叨页在浏览器走访一个不存在的页面概略做事器里面发生演叨时,咱们可能需要对其进行处理,此时咱们就需要用到error_page提醒,如下所示:
# 自界说404与500页面,指向底下的location error_page 404 500 /404.html; # 自界说404页面 location /404.html { alias /Users/likai/nginx-website/404-page/; # 默许首页文献 index index.html index.htm; }
注重:设置了error_page后,一定要设置location来指向你要走访的静态形貌。
反向代理tomcat提供的做事咱们需要在location提醒里面使用proxy_pass来代理tomcat提供的做事,设置如下所示:
# 反向代理Java接口,多旅途收受正则抒发式匹配 location ~ ^/(api|uploads|download|other)/ { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; }
注重:location提醒中使用正则进行了接口前缀地址的匹配,此处匹配的是/api/*、/uploads/*、/download/*、/other/*
如若你的tomcat还提供了websocket做事,那么还需要单独配一条location提醒,用来代理,设置如下所示:
# 反向代理websocket苦求 location /websocket { proxy_pass http://127.0.0.1:8080/websocket/; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; }
如若你莫得使用Java来作念做事端,而是使用python、php、c#等话语作念的,也不错使用proxy_pass来作念反向代理。
重定向未佩带www的苦求临了,咱们来处理下本文滥觞所说的问题,在nginx中处理这个问题特地简约,咱们只需要判断下苦求地址中是否包含www即可,如若不包含则301重定向到带www的地址即可,设置如下所示:
# 主机称呼,哪个写在前边,默许就跳转哪个 server_name www.kaisir.cn kaisir.cn; # 苦求网址中不包含www, 则重定向到佩带www的https地址 if ($http_host !~ "^www.kaisir.cn$") { return 301 https://$server_name$request_uri; }
设置完成后,咱们大开浏览器走访kaisir.cn[6]来考证下是否达到了咱们的预期,如下图所示,圆善处理??

注重:上述设置中,咱们使用正则抒发式对url进行了一波匹配,其中server_name提醒的作用是如若走访地址中包含此地点写的东西,就会触发践诺这里的设置。
此设置还会将你的http苦求默许重定向到https。
完整的设置文献本章节完整的设置文献履行如下所示:
server { listen 80; listen 443 ssl; # 主机称呼,哪个写在前边,默许就跳转哪个 server_name www.kaisir.cn kaisir.cn; # 苦求网址中不包含www, 则重定向到佩带www的https地址 if ($http_host !~ "^www.kaisir.cn$") { return 301 https://$server_name$request_uri; } error_page 497 https://$server_name$request_uri; # 自界说404与500页面,指向底下的location error_page 404 500 /404.html; # 设置ssl文凭 ssl_certificate /Users/likai/nginx-website/conf/kaisir.cn/1_kaisir.cn_bundle.crt; ssl_certificate_key /Users/likai/nginx-website/conf/kaisir.cn/2_kaisir.cn.key; ssl_session_timeout 5m; ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4; ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3; ssl_prefer_server_ciphers on; # 援用诬捏设置文献 include vhosts/_nginx.vhost.fpm; # 根旅途 location / { # 形貌旅途 root /Users/likai/nginx-website/kasir.cn; # 默许首页文献 index index.html index.htm; } location /chat-system { # 形貌旅途 alias /Users/likai/nginx-website/chat-system/; # 默许首页文献 index index.html index.htm; # 处理网页刷新404 try_files $uri $uri/ /chat-system/index.html; } # 自界说404页面 location /404.html { alias /Users/likai/nginx-website/404-page/; # 默许首页文献 index index.html index.htm; } # 反向代理Java接口,多旅途收受正则抒发式匹配 location ~ ^/(api|uploads|download|other)/ { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } # 反向代理websocket苦求 location /websocket { proxy_pass http://127.0.0.1:8080/websocket/; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; } }
nginx设置文献
接下来,咱们来看下nginx的设置文献,作念一些小优化。本章节的总计设置都是在nginx.conf文献中完成,本章节提到的总计设置文献均指nginx.conf。
最大勾搭数最大勾搭数也不错成为并发数,即消除时刻最多援助若干个客户端接入,在设置文献中加入如下所示的设置:
events { # 允许的勾搭数 worker_connections 20000; }
开启gzip
gzip压缩不错勤俭咱们的带宽资源,擢升网站的加载速率。它的开启式样也很简约,在设置文献的http提醒内添加,如下所示:
http { # 开启gzip gzip on; # 允许压缩的最小字节数 gzip_min_length 10; # IE浏览器1-6版块禁用gzip gzip_disable "MSIE [1-6]."; # 启用gzip的文献类型 gzip_types text/plain application/x-javascript text/css text/javascript application/xml; }
设置日记
日记不错用来记载每个客户端的走访时辰、ip、浏览器等信息,对咱们后续的网站珍爱带来匡助,在设置文献的http提醒内添加如下所示的设置:
# 确立日记本事,添加客户端真确ip等信息 format chatSystemLogFormat '$http_x forwarded_for - $remote_user [$time_local]' '"$request" $status $body_bytes_sent' '"$http_referer" "$http_user_agent"'; # 走访日记文献存放旅途 ss_log /Users/likai/nginx-website/logs-chat-system/access.log chatSystemLogFormat buffer=32k;设置文献上传大小
如若你的网站提供了文献上传做事,那么文献的大小放弃除了在你的做事端形貌中设置外,还需要在nginx中设置。
雷同的,在设置文献的http提醒内添加如下所示的设置:
# 客户端不错上传的文献大小 client_max_body_size 100m;完整的设置文献
完整的设置如下所示:
user likai staff; worker_processes 8; error_log /Applications/MxSrvs/logs/errors_nginx.log; #error_log logs/error.log notice; #error_log logs/error.log info; #pid logs/nginx.pid; events { # 允许的勾搭数 worker_connections 20000; } http { # gzip匹配类型设置文献 include mime.types; default_type application/octet-stream; # 客户端不错上传的文献大小 client_max_body_size 100m; # 开启gzip gzip on; # 允许压缩的最小字节数 gzip_min_length 10; # IE浏览器1-6版块禁用gzip gzip_disable "MSIE [1-6]."; # 启用gzip的文献类型 gzip_types text/plain application/x-javascript text/css text/javascript application/xml; # 确立日记本事,添加客户端真确ip等信息 log_format chatSystemLogFormat '$http_x forwarded_for - $remote_user [$time_local]' '"$request" $status $body_bytes_sent' '"$http_referer" "$http_user_agent"'; # 走访日记文献存放旅途 access_log /Users/likai/nginx-website/logs-chat-system/access.log chatSystemLogFormat buffer=32k; # 引入做事设置文献 include virtualhost.conf; sendfile on; keepalive_timeout 65; }
参考贵寓
[1]开源形貌: https://kaisir.cn/chat-system
[2]https://kaisir.cn/chat-system: https://kaisir.cn/chat-system
[3]https://www.kaisir.cn/chat-system: https://www.kaisir.cn/chat-system
[4]nginx官网: https://www.nginx.com/resources/wiki/start/topics/tutorials/install/
[5]build: 启用路由的history花式: https://github.com/likaia/chat-system/commit/e7c55a714f2610a87a5c87d5864bc4c342a298b0
[6]kaisir.cn: http://kaisir.cn
[7]个东说念主网站: https://www.kaisir.cn/