实现逻辑
主要是网上教程太乱,而且很碎片;我这边做一个整体教程和演示。
主要有两种形式:带tomcat的jar包
、不带tomcat的war包
。
简述一下逻辑:
本次教程,Tomcat项目打包成war包到服务器上发布,Springboot项目打包为jar或war包到服务器上发布:
- war:Tomcat/Springboot项目打包
- jar:Spring web项目(Springboot)打包
前提
服务器前提
既然要部署到服务器,给公网用户访问,肯定是需要一台服务器的(Linux系统比较推荐,Windows Server占用系统资源过高)。
如果你不会操作Linux,可以使用宝塔面板。
推选服务器:
- 腾讯学生轻量应用服务器
- 腾讯云服务器采购节
如果你并不知道买什么服务器,可以评论区留言项目规模。
本地前提
- 可上传文件至服务器的工具(可以本地用WinSCP,或者服务器安装宝塔等)。
- 一个JavaWeb项目,且可以运行。
视频演示教程
Tomcat项目打包成war
觉得视频有用,可以投币点赞嗷:
Bilibili:Tomcat项目打包成war
Springboot项目打包成jar
觉得视频有用,可以点赞和评论嗷:
腾讯云社区:【玩转腾讯云】10分钟零基础部署本地JavaWeb项目到腾讯云轻量应用服务器原创
本地构建JavaWeb项目
首先,我们要区分你本地的JavaWeb项目
Tomcat工程
Tomcat项目打包为.war
结尾的war文件其实很简单,但是IDEA上要提前配置:
这一步,其实也是本地IDEA启动Tomcat的前提条件。如果图开不清,可以点开查看嗷;步骤是:
打开Project Structure
-- Artifacts
-- 点
号 -- Web Application: Exploded
-- Apply
Spring工程
以Springboot项目为例
打包为jar
这个过于简单,以至于前期无需准备步骤,如果真的要说,Maven里不要设置打包为war即可(默认打包为jar
)。
打包为war
相对于打包出jar,打包为war会复杂点:
Maven的pom.xml里设置:
代码语言:txt复制<packaging>war</packaging>
然后,在spring-boot-starter-web依赖节点中移除tomcat相关外部包:
代码语言:txt复制<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<!-- 移除嵌入式tomcat插件 -->
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
</exclusion>
</exclusions>
</dependency>
最后,在依赖包内添加Servlet的包:
代码语言:txt复制<!-- 打包成war包,添加Servlet依赖-->
<dependency>
<groupId>org.apache.tomcat</groupId>
<artifactId>tomcat-servlet-api</artifactId>
<version>9.0.43</version>
</dependency>
打包项目为war文件
适用于Tomcat项目、Spring项目。
构建准备
war文件,实际上就是一自压缩文件;我们的服务器上Tomcat会解析war文件为工程项目。
如果你的项目是Tomcat项目,IDEA首先添加打包的Archive
:
如果图开不清,可以点开查看嗷;步骤是:
打开Project Structure
– Artifacts
– 点
号 – Web Application: Archive
– For name
– Apply
其中,name
为你本地构建JavaWeb项目设置的Web Application: Exploded
名字。
如果你的项目是Spring项目,需要设置启动主类SpringBootServletInitializer,创建一个SpringBootStartApplication
类,同时继承SpringBootServletInitializerl
类:
public class SpringBootStartApplication extends SpringBootServletInitializer {
@Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
// 注意这里要指向原先用main方法执行的Application启动类
return builder.sources(ToolApplication.class);
}
}
正式构建
如果你的项目是Tomcat项目:
如果图开不清,可以点开查看嗷;步骤是:
打开Build
– Build Artifacts
– Build name
其中,name
为你刚刚构建准备设置的Web Application: Archive
名字。构建成功,会在out–artifacts
文件夹的子目录内找到一个.war
结尾的文件,这就是我们要上传服务器的文件。
而基于Maven骨架的Spring项目,只需要打包IDEA自带的Maven工具,进行打包操作:
当然,你也可以直接到项目目录下,使用Maven命令打包:
代码语言:txt复制mvn clean
mvn package
之后,在target
目录下生成.war
结尾的文件,这就是我们要上传到服务器的文件。
服务器安装配置Tomcat(War)
对于war
包,内部是什么Tomcat服务器的,需要我们手动在服务器上配置一个。如果你打包成jar
则不需要。
下载Tomcat镜像文件到服务器
首先去官网下载Tomcat镜像文件:https://tomcat.apache.org/download-80.cgi
因为是给服务器配置,我们需要下载的tar.gz的core版本。
这边下载方法很多,比如你可以直接wget下载到服务器,也可以本地WinSCP上传到服务器,甚至还可以用宝塔下载。
解压文件
解压刚刚下载的文件,比如我下载下来,文件是apache-tomcat-8.5.55.tar.gz
,解压后是apache-tomcat-8.5.55文件夹
;为了方便配置;我重命名apache-tomcat-8.5.55文件夹为Tomcat,并移动到根目录
。
配置JDK
考虑到这个过于简单,建议自己配置JDK,推荐OpenJDK。
如果你重来没用过Linux,可以参考图文教程:
Linux的JDK和Jenv(JAVA_HOME管理器)的详细配置使用教程
我配置的JDK的JAVA_Home地址: /usr/java/jdk
配置Tomcat环境变量
服务器终端输入(若未事先配置zsh,一般Linux默认为Bash):
代码语言:txt复制# 如果你使用Bash
vim /etc/profile
# 如果你使用zsh
vim ~/.zshrc
按 i 进入编辑并在最底部添加:
代码语言:txt复制#tomcat
CATALINA_HOME=/Tomcat
export CATALINA_HOME
随后按ESC
;输入:wq
后回车(保存并退出)。
最后,重载一次配置文件,使环境变量文件生效:
代码语言:txt复制source /etc/profile
# 如果你使用zsh
source ~/.zshrc
配置tomcat的catalina.sh文件
进入tomcat的bin目录
代码语言:txt复制cd $CATALINA_HOME/bin
vim catalina.sh
找到 # OS specific support
,然后在这行下面添加以下配置
# OS specific support. $var _must_ be set to either true or false.
CATALINA_HOME=
JAVA_HOME=
(其中,CATALINA_HOME、JAVA_HOME要根据自己前面配置路径,自己填写)
保存退出
上传打包好的war包
将刚刚打包好的.war文件,上传到tomcat里的/webapps内;因为我的tomcat8,重命名了并且放在根目录下(/Tomcat),所以我只需要上传到:/Tomcat/webapps
:
配置server.xml文件
为了方便项目访问,我们还需要配置tomcat里/conf/server.xml文件。因为我的tomcat8,重命名了并且放在根目录(/Tomcat),所以我只需要修改:/Tomcat/conf/server.xml
:
vim /Tomcat/conf/server.xml
在</Host>前,添加:
代码语言:txt复制<Context path="" docBase="/Tomcat/webapps/MintimateAll.war" debug="0" reloadable="true" />
- path:你希望用什么访问地址到你项目文件
- docBase:项目地址(可以是绝对路径,也可相对路径)
保存,退出即可。
配置tomcat服务
这里有两种方式,一种是注册为系统服务
:
# 进入Tomcat安装目录下的bin目录
cd $CATALINA_HOME/bin
# 移动Tomcat配置文件到系统Service文件内
cp catalina.sh /etc/systemd/system/tomcat
之后,启动或关闭Tomcat服务器:
代码语言:txt复制# 启动
service tomcat start
# 停用
service tomcat stop
如果都没有报错,则说明配置成功了。
另外一种是不注册为系统服务器,手动开启或关闭Tomcat
:
# 进入Tomcat安装目录下的bin目录
cd $CATALINA_HOME/bin
之后,启动或关闭Tomcat:
代码语言:txt复制# 启动Tomcat
bash startup.sh
# 关闭Tomcat
bash shutdown.sh
以上方法二选一即可。
删除初始ROOT文件夹
因为Tomcat自带一个演示文件,所以想通过浏览器:IP:8080直接访问到你项目,需要删除ROOT文件夹。该文件夹在刚刚上传项目文件夹内。
代码语言:txt复制rm -rf /Tomcat/webapps/ROOT
这样,当你只配置了一个项目时,这个项目或默认替换ROOT项目。当然,如果你有多个项目需要配置不同一级目录,那么需要在打包时,注意命名。
启动/重启Tomcat
要让Tomcat重新编译,我们只需要重启Tomcat服务即可:
代码语言:txt复制# 如果你注册Tomcat为系统服务:
## 停用
service tomcat stop
## 启动
service tomcat start
# 如果你没有注册Tomcat为系统服务:
cd $CATALINA_HOME/bin
## 关闭Tomcat
bash shutdown.sh
## 启动Tomcat
bash startup.sh
访问成功
这个时候,就可以通过服务器公网IP 8080端口
或公网IP 8080端口 项目地址
,访问到我们的项目了。(如果你不希望是8080端口,可以在conf/server.xml文件内更改)。
打包项目为jar文件
这个适用于Spring项目,尤其是Springboot项目,以一个主类启动项目且集成了Tomcat内建服务器。
构建准备
Maven上无需额外操作
正式构建
只需要打包IDEA自带的Maven工具,进行打包操作:
当然,你也可以直接到项目目录下,使用Maven命令打包:
代码语言:txt复制mvn clean
mvn package
之后,在target
目录下生成.jar结尾的文件,即为打包后的文件。之后上传服务器即可。
服务器运行带Tomcat的jar(Jar)
配置JDK
考虑到这个过于简单,建议自己配置JDK,推荐OpenJDK。
如果你重来没用过Linux,可以参考图文教程:
Linux的JDK和Jenv(JAVA_HOME管理器)的详细配置使用教程
我配置的JDK的JAVA_Home地址: /usr/java/jdk
上传打包好的jar包
jar因为自带Tomcat环境,相对来说简单很多。为方便管理,我们创建一个myWeb
文件夹,在里面放我们的jar包:
cd /
mkdir myWeb
cd myWeb
之后上传本地jar包
启动/关闭Jar
为了方便管理,我们以前台运行方式,运行java程序,先创建screen虚拟终端:
代码语言:txt复制screen -R Web
启动服务器:
代码语言:txt复制java -jar -Xmx128M YouJarName.jar
这个时候,就运行我们的网站了。而因为我们使用screen的原因,我们可以按ctrl a
再按d
,退出虚拟终端,使其保存后台运行。
如果要关闭Web服务:
代码语言:txt复制# 重新进入虚拟终端
screen -R Web
之后按ctrl c
,即可关闭。
访问成功
这个时候,就可以通过服务器公网IP 端口
即可访问,记得到运营商后台放行端口嗷
配置Nginx反向代理(可选)
如果你配置好项目,往往需要IP 端口
形式访问,但是如果你用域名,如何使用纯粹的域名访问呢?
很简单,使用Nginx,设置反向代理即可。为方便操作,我们使用宝塔面板进行操作(主要是篇幅受限):
宝塔官网,根据自己服务器系统,即可安装宝塔面板
在宝塔面板内安装好Nginx后,创建新网站:
点击创建的网站,设置方向代理:
之后就可以使用域名访问了。