linux tomcat部署war

在Linux服务器环境中部署Java Web应用时，Tomcat作为轻量级开源应用服务器，因其稳定性和易用性被广泛采用，WAR（Web Application Archive）包是Java Web应用的标准化部署格式，本文将详细介绍在Linux系统下Tomcat部署WAR包的完整流程，包括环境准备、Tomcat安装配置、部署操作及常见问题处理，帮助读者高效完成应用部署。

环境准备：搭建基础运行环境

在开始部署前,需确保Linux系统满足Tomcat运行的基本要求，主要包括操作系统、Java环境及网络配置。

操作系统与Java环境

Tomcat是基于Java的应用服务器,需预先安装JDK（Java Development Kit），以CentOS 7为例，可通过以下步骤安装OpenJDK 11（Tomcat 9推荐JDK 8+）：

# 更新软件包仓库
yum update -y  
# 安装OpenJDK 11
yum install java-11-openjdk-devel -y  
# 验证Java安装
java -version  

若使用Ubuntu系统,可通过apt install openjdk-11-jdk安装，安装后同样需验证java -version输出版本信息（需确保版本为1.8+）。

网络与防火墙配置

Tomcat默认使用8080端口,需确保Linux防火墙允许该端口访问，以CentOS 7的firewalld为例：

# 开放8080端口
firewall-cmd --permanent --add-port=8080/tcp  
# 重启防火墙生效
firewall-cmd --reload  

若使用iptables,可通过iptables -A INPUT -p tcp --dport 8080 -j ACCEPT开放端口，并保存规则。

Tomcat安装与配置：搭建应用服务器

环境准备完成后,需下载并配置Tomcat，确保其能够正常运行并接收部署请求。

下载与解压Tomcat

从Tomcat官网（https://tomcat.apache.org/）下载稳定版本（如Tomcat 9），以二进制压缩包（tar.gz）为例：

# 下载Tomcat 9（需根据实际版本调整链接）
wget https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.65/bin/apache-tomcat-9.0.65.tar.gz  
# 解压到/usr/local目录
tar -zxvf apache-tomcat-9.0.65.tar.gz -C /usr/local/  
# 重命名目录方便管理
mv /usr/local/apache-tomcat-9.0.65 /usr/local/tomcat  

配置Tomcat环境变量

为方便全局调用Tomcat命令,需设置CATALINA_HOME环境变量，编辑/etc/profile文件：

vim /etc/profile  

在文件末尾添加以下内容：

export CATALINA_HOME=/usr/local/tomcat  
export PATH=$PATH:$CATALINA_HOME/bin  

保存后执行source /etc/profile使配置生效，可通过echo $CATALINA_HOME验证变量是否生效。

配置Tomcat用户权限

为通过Tomcat Manager管理应用，需配置tomcat-users.xml文件（位于$CATALINA_HOME/conf/），添加具有部署权限的用户：

vim $CATALINA_HOME/conf/tomcat-users.xml  

在<tomcat-users>标签内添加：

<role rolename="manager-gui"/>  
<role rolename="manager-script"/>  
<user username="admin" password="yourpassword" roles="manager-gui,manager-script"/>  

manager-gui允许网页管理，manager-script允许脚本部署，密码需自行设置强密码。

优化Tomcat配置（可选）

为提升性能,可修改$CATALINA_HOME/conf/server.xml中的连接器配置，例如调整端口、连接池大小等：

<Connector port="8080" protocol="HTTP/1.1"  
           connectionTimeout="20000"  
           redirectPort="8443"  
           maxThreads="200"  
           minSpareThreads="20"  
           acceptCount="100"/>  

参数说明：maxThreads最大线程数，minSpareThreads最小空闲线程数，acceptCount最大等待连接数，需根据服务器配置调整。

WAR包部署：上传与启动应用

Tomcat支持多种WAR包部署方式,包括直接复制、Manager管理页面部署及命令行部署，可根据实际需求选择。

方式一：直接复制到webapps目录

Tomcat默认会自动部署$CATALINA_HOME/webapps/目录下的WAR包，无需额外配置，操作步骤：

• 将WAR包上传至服务器（可通过scp、rsync或FTP工具），例如上传至/tmp/目录：

  scp yourapp.war root@your-server:/tmp/  

• 将WAR包复制到webapps目录：

  cp /tmp/yourapp.war $CATALINA_HOME/webapps/  

• Tomcat会自动检测并解压WAR包,解压后的目录名与WAR包名一致（如yourapp），访问地址为http://your-server:8080/yourapp。

方式二：通过Tomcat Manager页面部署

若已配置Manager用户,可通过网页界面完成部署，步骤如下：

• 启动Tomcat（$CATALINA_HOME/bin/startup.sh），访问http://your-server:8080/manager/html，输入配置的用户名密码登录。
• 在“Deploy”区域点击“Choose File”，选择本地WAR包文件，或填写“Context Path”（应用路径，如/yourapp）和“WAR file or Directory URL”（服务器上的WAR包路径，如file:///tmp/yourapp.war）。
• 点击“Deploy”按钮，等待部署完成，页面会显示应用状态为“Running”。

方式三：命令行部署（适合自动化场景）

通过Tomcat提供的manager应用接口，可实现脚本化部署，适合CI/CD流程，使用curl命令调用Manager接口：

# 部署WAR包（需替换用户名、密码及WAR包路径）
curl -u admin:yourpassword --upload-file /tmp/yourapp.war "http://your-server:8080/manager/text/deploy?path=/yourapp&update=true"  

参数说明：-u指定Manager用户名密码，--upload-file上传WAR包文件，path指定应用路径，update=true表示覆盖已存在的应用。

验证部署结果

部署完成后,可通过以下方式验证应用是否正常运行：

• 浏览器访问应用URL（如http://your-server:8080/yourapp），检查页面是否正常显示。
• 查看Tomcat日志（$CATALINA_HOME/logs/catalina.out），确认无启动错误：

  tail -f $CATALINA_HOME/logs/catalina.out  

• 检查应用目录是否生成（$CATALINA_HOME/webapps/yourapp），确认WAR包已解压。

常见问题与解决技巧

部署过程中可能遇到各类问题,掌握常见问题排查方法可提升效率。

启动失败：端口冲突或权限问题

• 问题现象：执行startup.sh后提示“Port 8080 already in use”或“Permission denied”。
• 解决方法：
  • 端口冲突：使用netstat -tlnp | grep 8080查看占用端口的进程，终止进程（kill -9 PID）或修改Tomcat端口（server.xml中的Connector端口）。
  • 权限问题：确保执行startup.sh的用户有$CATALINA_HOME目录的读写权限，或使用chmod +x $CATALINA_HOME/bin/*.sh赋予脚本执行权限。

应用无法访问：404或403错误

• 问题现象：访问应用时返回404（资源未找到）或403（禁止访问）。
• 解决方法：
  • 404：检查Context Path是否正确（如部署时路径为/yourapp，访问时需完整路径），确认WAR包已解压且文件完整。
  • 403：检查$CATALINA_HOME/webapps/yourapp目录权限，确保Tomcat运行用户（如tomcat）有读取权限，或修改server.xml中Context的reloadable属性为true。

内存溢出：JVM参数调整

• 问题现象：应用运行时提示“OutOfMemoryError”或Tomcat频繁重启。
• 解决方法：在$CATALINA_HOME/bin/setenv.sh（若不存在需创建）中设置JVM内存参数：

  export JAVA_OPTS="-Xms512m -Xmx1024m -XX:MaxPermSize=256m"  

  参数说明：-Xms初始堆内存，-Xmx最大堆内存，-XX:MaxPermSize方法区内存（JDK 8+可省略），需根据服务器内存调整。

乱码问题：编码配置

• 问题现象：应用页面或日志中出现乱码。
• 解决方法：修改$CATALINA_HOME/conf/server.xml中Connector标签，添加URIEncoding="UTF-8"：

  <Connector port="8080" URIEncoding="UTF-8" .../>  

  同时确保应用代码使用UTF-8编码，并检查JVM参数中-Dfile.encoding=UTF-8。

小编总结与最佳实践

Linux环境下Tomcat部署WAR包是Java Web应用运维的基础技能，核心流程可概括为“环境准备→Tomcat安装配置→WAR包部署→验证与优化”，为提升部署效率和稳定性，建议遵循以下最佳实践：

1. 版本管理：使用固定版本的Tomcat和JDK，避免因版本升级导致兼容性问题。
2. 安全加固：修改默认端口（如8080改为8081），关闭Manager页面的远程访问（仅允许内网IP），定期更换Manager用户密码。
3. 日志监控：配置日志轮转（logrotate），避免日志文件过大占用磁盘空间，并通过ELK等工具集中管理日志。
4. 自动化部署：结合Ansible、Jenkins等工具实现自动化部署，减少人工操作失误。

通过以上步骤和技巧,可高效完成Tomcat WAR包部署，并确保应用稳定运行，实际操作中需根据业务需求和环境差异灵活调整，积累问题排查经验，逐步提升运维能力。