使用 Nginx 部署 Java Web 服务

使用 Nginx 部署 Java web 服务

比较早之前,部署 Java web 服务只是单纯使用 Tomcat 做 Web 服务器,前后端代码融合在一个工程之中。Tomcat 启动后对外提供一个端口接收和相应 http请求。随着 Nginx 的越来越流行,同时加上其优秀的反响代理和负载均衡功能,我们在线上的 Java web 通常会结合二者,即使用 Nginx + Tomcat 的方式来部署 Java web 服务。最近两年,随着微服务化和前后端工程分离思想的流行,使用 Spring Boot 和 Vue 框架进行 Java web 开发的人的人越来越多。由于前后端分离后需要解决请求跨域的问题,往往会使用 Nginx 做一层反向代理,这样可以减少一些代码风险。所以,目前主流的 Java web开发模式是:

  • 基于 Vue 等优秀的前端框架完成页面开发;

  • 使用 Spring Boot 等 java web 框完成后端服务开发;

  • 前端工程打包后是一堆静态文件,可以直接由 Nginx 进行代理访问;后端服务启动后会占用端口等待请求,Nginx 将使用反向代理功能将前端发起的 http 请求转到对应的后台服务去处理。如果在多台机器上部署了相同的服务,还可以使用 Nginx 中的负载均衡功能,将请求均匀分发到上游的服务,实现系统的高可用性。

1. 部署前端

前端框架如 Vue 打包出来往往是静态的文件 index.html 加上一个 static 目录。static 目录下有 fonts、css、js、img等静态资源目录。前端的访问是从 index.html 开始的。假设服务器上打包出的前端代码放到/root/test-web目录下,对应部署前端的配置如下:

...http{server {   # 监听8080端口   listen ;     
       # 指定域名,不指定也可以   server_name www.xxx.com;   
       # 浏览器交互调参,打开gzip压缩、缓存等等   gzip on;   ...   
       location / {   root  /root/test-web;   # 也可以简单使用 index index.html   try_files $uri $uri/ /index.html;   }   
       # vue 页面中向后台 java 服务发送请求   ...}}...

2. 部署java后台服务

Nginx 部署 Java Web 服务时,主要用到是 Nginx 的代理转发功能,对于不同类型的接口而言,可能会有不同的转发逻辑。如果是使用 spring cloud 这样的微服务框架,每个服务可能会部署多个会这分开部署在不同机器,在 Nginx 同样只需要使用 proxy_pass 指令将 http 请求转发到对应的上游服务上即可,同时负载均衡模块也在 java web 后台服务中用到的比较多。最后是在java web 的开发中,也常常会涉及到 websocket 协议,因此 Nginx 在部署 java web 服务时也会用到 websocket 代理转发。所以 Nginx 在部署 Java Web 服务时的基本配置大概如下:

...http{server {   # 监听8080端口   listen ;     
       # 指定域名,不指定也可以   server_name www.xxx.com;   
       # 参数调优   client_max_body_size 20m; 
       client_body_buffer_size 128k       ...   
       # 如果使用多个后台服务,可以配置负载均衡   ...   
       # 访前端的 vue 页面   location / {   ...   }   # vue 页面中向后台 java 服务发送请求   location /xxxx { proxy_pass http://xxxx:xx/xxx;   }   
       # 配置多种方向代理,不同类型接口有不同的转发方式   ...   
       # 如果有,则配置websocket代理   location /xxxy {   proxy_http_version ;   proxy_set_header Upgrade $http_upgrade;   proxy_set_header Connection upgrade;   proxy_pass http://xxxxx:xx/yyy;   }}   }...

如果涉及的服务较多, Nginx 的配置往往会拆成多个文件进行编写,这样就用到了前面提到的 include 指令。

3. 小结

总结 Nginx 部署 java 服务,主要是使用 proxy_pass 指令进行端口转发,因为都是 http 请求的转发,所以配置会比较简单。但是如果服务较多时, Nginx 需要编写多个 server 指令块或者多个 location 块去匹配不同的 URL并转发到对应的上游服务。往往大型网站使用的服务较多时,会使用 include 指令对 Nginx 的配置进行拆分,不同的配置处理不同服务的转发,这样会更简洁明了,方便网站运维人员管理和修改 Nginx 配置。