资讯详情

深入了解 · 专业解读

Linux服务器部署多Tomcat实例：端口规划、服务化与运维指南

发布时间：2026/8/15 21:22:52
Linux服务器部署多Tomcat实例：端口规划、服务化与运维指南 1. 项目概述与核心价值在中小型企业的实际运维场景里或者个人开发者手头只有一台性能尚可的服务器时我们常常会面临一个非常现实的需求如何在这一台物理或云服务器上同时运行多个基于Tomcat的Java Web应用。这可能是为了隔离不同客户的项目、区分测试与生产环境或者仅仅是最大化利用服务器资源。直接在一份Tomcat里部署多个应用虽然可行但在日志管理、应用重启、资源隔离和版本依赖方面会带来诸多不便。因此学会在一台服务器上部署多个独立的Tomcat实例每个实例承载一个或多个项目是一项非常实用且基础的服务器管理技能。这篇文章我将结合自己多年的部署经验为你拆解从零开始在一台Linux服务器以CentOS 7为例上部署多个Tomcat及项目的完整流程。整个过程会涵盖环境准备、Tomcat实例的独立配置、项目部署、服务化管理以及最重要的——端口冲突的解决与日常运维技巧。无论你是刚接触服务器部署的开发者还是需要优化现有部署结构的运维人员这篇手把手的图文指南都能提供清晰的路径。2. 环境准备与规划在开始动手之前清晰的规划是避免后续混乱的关键。我们需要从软件环境和部署结构两方面做好准备。2.1 基础软件环境检查与安装首先确保你的服务器已经具备了运行Java Web应用的基础环境。通过SSH连接到你的服务器执行以下检查与安装步骤。Java环境JDKTomcat运行依赖于Java环境。推荐使用JDK 8或JDK 11这些长期支持版本。# 检查是否已安装Java及其版本 java -version如果未安装可以使用yum进行安装以OpenJDK 8为例# 搜索可用的JDK包 yum search java-1.8.0-openjdk # 安装JDK开发包包含JRE yum install -y java-1.8.0-openjdk-devel安装后再次验证java -version和javac -version。规划安装目录为了管理清晰建议为所有Tomcat实例创建一个统一的父目录。例如我习惯在/opt下创建tomcats目录。mkdir -p /opt/tomcats cd /opt/tomcats后续下载的Tomcat压缩包和解压后的各个实例都将放在这个目录下。2.2 部署结构规划这是核心步骤。我们需要决定部署多少个Tomcat实例以及如何为它们分配唯一的标识和资源。确定实例数量与命名假设我们需要部署两个Tomcat实例分别运行“客户门户系统”和“内部管理系统”。我们可以这样命名tomcat-portal: 对应客户门户。tomcat-internal: 对应内部系统。 清晰的命名有助于后续的脚本编写和日志查看。端口规划表至关重要单个Tomcat默认使用8080端口HTTP、8005端口SHUTDOWN和8009端口AJP。多实例必须避免端口冲突。我们需要为每个实例规划一套唯一的端口。建议制作一个表格实例名称HTTP端口SHUTDOWN端口AJP端口备注tomcat-portal808080058009默认实例可保留tomcat-internal808180068010第二个实例全部递增tomcat-app3808280078011预留第三个实例端口注意在生产环境中如果服务器内存充足建议为每个实例的SHUTDOWN端口也设置不同的值这是Tomcat官方推荐的做法可以防止误操作关闭错误的实例。AJP端口通常在使用Apache HTTPD等前端代理时才需要如果只用Tomcat可以暂时不修改但为了规范性建议一并修改。目录结构预览规划好后的/opt/tomcats目录结构将如下所示/opt/tomcats/ ├── apache-tomcat-9.0.xx.tar.gz # 下载的原始压缩包 ├── tomcat-portal/ # 实例一目录 │ ├── bin/ # 启动脚本等 │ ├── conf/ # 配置文件需修改 │ ├── logs/ # 实例专属日志 │ ├── webapps/ # 部署项目war包在此 │ └── ... └── tomcat-internal/ # 实例二目录 ├── bin/ ├── conf/ ├── logs/ ├── webapps/ └── ...3. 下载、解压与多实例配置有了清晰的规划我们就可以开始具体的配置工作了。3.1 下载与解压Tomcat首先从Apache官网下载Tomcat的二进制压缩包tar.gz格式。以Tomcat 9为例# 进入规划好的目录 cd /opt/tomcats # 使用wget下载请替换为官网最新的稳定版链接 wget https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.xx/bin/apache-tomcat-9.0.xx.tar.gz # 解压压缩包 tar -zxvf apache-tomcat-9.0.xx.tar.gz # 解压后得到目录 apache-tomcat-9.0.xx3.2 创建第一个Tomcat实例tomcat-portal我们将解压后的目录复制一份作为我们的第一个实例并以其命名。# 复制并重命名创建第一个实例 cp -r apache-tomcat-9.0.xx tomcat-portal现在进入tomcat-portal的配置目录开始修改端口。cd tomcat-portal/conf # 使用vi或nano编辑 server.xml vi server.xml在server.xml文件中找到以下三个关键连接器Connector配置HTTP/1.1 Connector(默认端口8080):Connector port8080 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 /因为我们规划tomcat-portal使用默认端口所以这里不需要修改。如果你想让它使用其他端口比如8080被占用可以在这里修改。AJP Connector(默认端口8009):Connector port8009 protocolAJP/1.3 redirectPort8443 /同样按规划我们保留8009不需要修改。Server Port(SHUTDOWN端口默认8005):Server port8005 shutdownSHUTDOWN这是Tomcat监听关闭指令的端口。按规划保留8005不需要修改。第一个实例配置完成。它将继续使用Tomcat的默认端口组8080, 8005, 8009。3.3 创建并配置第二个Tomcat实例tomcat-internal现在创建第二个实例并修改其所有端口避免与第一个实例冲突。# 回到tomcats根目录 cd /opt/tomcats # 复制原始解压目录创建第二个实例 cp -r apache-tomcat-9.0.xx tomcat-internal # 进入其配置目录 cd tomcat-internal/conf vi server.xml在第二个实例的server.xml中根据我们之前的规划表进行修改修改HTTP端口为8081:Connector port8081 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 /修改AJP端口为8010:Connector port8010 protocolAJP/1.3 redirectPort8443 /修改SHUTDOWN端口为8006:Server port8006 shutdownSHUTDOWN保存并退出编辑器。至此第二个实例的端口配置已完成它将在8081端口提供HTTP服务。3.4 配置技巧与注意事项环境变量隔离每个Tomcat实例的bin/catalina.sh脚本会读取CATALINA_HOME和CATALINA_BASE环境变量。在我们这种复制目录的部署方式中每个实例的目录本身就是其CATALINA_BASE而CATALINA_HOME可以指向原始解压目录或留空脚本会自动处理。这种结构实现了天然的隔离。内存参数调整如果服务器内存有限或者应用本身比较吃内存需要为每个Tomcat实例单独设置JVM内存参数。编辑每个实例bin/catalina.sh文件在文件开头附近注释之后添加类似如下的设置# 在 bin/catalina.sh 中添加 export JAVA_OPTS-server -Xms512m -Xmx1024m -XX:MetaspaceSize128m -XX:MaxMetaspaceSize256m这样可以为该实例设定初始堆内存512MB最大堆内存1024MB。请根据服务器总内存和应用需求合理分配确保所有实例总和不超过物理内存。日志目录每个实例的logs目录是独立的这非常有利于排查问题。你可以通过tail -f tomcat-portal/logs/catalina.out来单独跟踪某个应用的输出。4. 项目部署与启动测试配置好Tomcat实例后下一步就是将我们的Web应用通常是WAR包部署进去并测试启动。4.1 部署WAR包假设我们有两个WAR包customer-portal.war和internal-system.war。# 将WAR包分别放入对应实例的webapps目录下 # 可以使用SCP等工具从本地上传这里假设已上传到服务器/tmp目录 cp /tmp/customer-portal.war /opt/tomcats/tomcat-portal/webapps/ cp /tmp/internal-system.war /opt/tomcats/tomcat-internal/webapps/Tomcat在启动时会自动解压webapps目录下的WAR文件。你也可以将WAR包解压成一个目录再放入这样可以预先修改一些配置文件。4.2 启动Tomcat实例我们进入每个实例的bin目录使用脚本来启动。# 启动第一个实例 (tomcat-portal) cd /opt/tomcats/tomcat-portal/bin ./startup.sh # 查看启动日志确认无报错 tail -f ../logs/catalina.out # 按 CtrlC 退出日志跟踪 # 启动第二个实例 (tomcat-internal) cd /opt/tomcats/tomcat-internal/bin ./startup.sh tail -f ../logs/catalina.out4.3 验证部署结果启动完成后通过浏览器或curl命令访问服务验证部署是否成功。# 验证第一个实例端口8080 curl http://localhost:8080/customer-portal/ # 或者访问服务器IP: http://你的服务器IP:8080/customer-portal/ # 验证第二个实例端口8081 curl http://localhost:8081/internal-system/如果看到应用的首页或者正常的HTTP响应而非404错误说明部署成功。4.4 防火墙配置如果服务器开启了防火墙如firewalld需要放行我们使用的端口。# 放行8080和8081端口 firewall-cmd --permanent --add-port8080/tcp firewall-cmd --permanent --add-port8081/tcp # 重载防火墙规则 firewall-cmd --reload # 查看已放行的端口 firewall-cmd --list-ports5. 将Tomcat配置为系统服务Systemd使用startup.sh和shutdown.sh手动管理在服务器重启后不会自动启动也不便于集中管理。最佳实践是将每个Tomcat实例配置为独立的系统服务Systemd Service。5.1 为每个实例创建Service文件为tomcat-portal创建服务文件vi /etc/systemd/system/tomcat-portal.service将以下内容粘贴进去请务必根据你的实际路径修改CATALINA_HOME和JAVA_HOME[Unit] DescriptionApache Tomcat 9 Instance - Portal Aftersyslog.target network.target [Service] Typeforking # 设置环境变量JAVA_HOME指向你的JDK安装目录 EnvironmentJAVA_HOME/usr/lib/jvm/java-1.8.0-openjdk # CATALINA_HOME 可以指向原始Tomcat目录也可以指向实例目录。这里指向实例目录。 EnvironmentCATALINA_HOME/opt/tomcats/tomcat-portal EnvironmentCATALINA_BASE/opt/tomcats/tomcat-portal EnvironmentCATALINA_PID${CATALINA_BASE}/temp/tomcat.pid # 可以在这里设置JVM参数覆盖catalina.sh中的设置 EnvironmentJAVA_OPTS-server -Xms512m -Xmx1024m -Djava.awt.headlesstrue # 启动命令 ExecStart${CATALINA_HOME}/bin/startup.sh # 停止命令 ExecStop${CATALINA_HOME}/bin/shutdown.sh Userroot Grouproot UMask0007 RestartSec10 Restartalways [Install] WantedBymulti-user.target同理为tomcat-internal创建服务文件/etc/systemd/system/tomcat-internal.service内容基本相同只需修改Description、CATALINA_HOME、CATALINA_BASE以及JAVA_OPTS如果需要不同的内存配置。5.2 启用并管理服务创建好服务文件后重新加载systemd配置然后启用并启动服务。# 重新加载systemd配置 systemctl daemon-reload # 启用tomcat-portal服务开机自启 systemctl enable tomcat-portal.service # 启动tomcat-portal服务 systemctl start tomcat-portal.service # 查看服务状态 systemctl status tomcat-portal.service # 对tomcat-internal执行同样操作 systemctl enable tomcat-internal.service systemctl start tomcat-internal.service systemctl status tomcat-internal.service现在你可以使用标准的systemctl命令来管理你的Tomcat实例了systemctl start|stop|restart|status tomcat-portaljournalctl -u tomcat-portal -f# 查看该服务的实时日志6. 高级配置、优化与日常运维部署完成并能正常运行只是第一步要让多实例环境稳定、高效还需要一些进阶配置和运维技巧。6.1 会话共享与负载均衡考虑虽然本文重点是多实例部署在同一服务器但了解其扩展方向很重要。如果未来流量增长需要横向扩展这两个实例可以很容易地加入到负载均衡器如Nginx后面。在Nginx中可以这样配置 upstreamhttp { upstream backend_servers { # 指向同一台机器的不同端口 server 127.0.0.1:8080 weight1; server 127.0.0.1:8081 weight1; # 如果未来加了新服务器直接添加即可 # server 192.168.1.102:8080 weight1; } server { listen 80; server_name yourdomain.com; location / { proxy_pass http://backend_servers; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } } }注意如果应用使用了Session默认情况下Session存储在各自Tomcat的内存中在负载均衡时会导致用户会话丢失。此时需要配置Session共享常见方案有Session粘滞Sticky Session在负载均衡器设置让同一用户的请求始终转发到同一台Tomcat。Session复制在Tomcat的server.xml中配置Cluster让多个Tomcat实例间同步Session数据对网络和性能有影响。外部Session存储将Session存入Redis或数据库等外部存储这是最推荐的方式彻底解耦。Spring Boot项目可以轻松集成Spring Session来实现。6.2 日志管理与切割Tomcat默认的日志不会自动切割长期运行会导致catalina.out文件巨大。我们可以使用Linux自带的logrotate工具来管理。创建日志切割配置文件vi /etc/logrotate.d/tomcat-portal内容如下/opt/tomcats/tomcat-portal/logs/catalina.out { copytruncate daily rotate 30 compress missingok dateext size 100M create 644 root root }同样为tomcat-internal创建一份。这样配置后日志会按天或大小100MB进行切割保留30份旧的会被压缩。6.3 性能监控与JVM调优对于生产环境监控是必不可少的。启用JMX远程监控在某个实例的bin/catalina.sh的JAVA_OPTS中添加JMX参数即可使用JConsole或VisualVM进行远程监控。export JAVA_OPTS$JAVA_OPTS -Dcom.sun.management.jmxremote \ -Dcom.sun.management.jmxremote.port9090 \ -Dcom.sun.management.jmxremote.sslfalse \ -Dcom.sun.management.jmxremote.authenticatefalse \ -Djava.rmi.server.hostname你的服务器IP安全警告上述配置关闭了SSL和认证仅适用于内网测试环境。生产环境务必启用SSL和强密码认证。GC日志分析在JAVA_OPTS中添加GC日志参数有助于分析内存使用情况和垃圾回收问题。export JAVA_OPTS$JAVA_OPTS -XX:PrintGCDetails -XX:PrintGCDateStamps -XX:PrintGCTimeStamps -Xloggc:../logs/gc.log6.4 自动化部署脚本对于频繁更新的项目可以编写简单的Shell脚本实现一键停止、备份、部署、启动。创建一个deploy-portal.sh脚本#!/bin/bash TOMCAT_HOME/opt/tomcats/tomcat-portal WAR_SOURCE/data/new-releases/customer-portal.war BACKUP_DIR/data/backups/$(date %Y%m%d_%H%M%S) echo “停止Tomcat服务...” systemctl stop tomcat-portal echo “备份旧应用...” mkdir -p $BACKUP_DIR cp -r $TOMCAT_HOME/webapps/customer-portal* $BACKUP_DIR/ 2/dev/null || true echo “清理工作目录...” rm -rf $TOMCAT_HOME/webapps/customer-portal* rm -rf $TOMCAT_HOME/work/Catalina/localhost/customer-portal echo “部署新WAR包...” cp $WAR_SOURCE $TOMCAT_HOME/webapps/ echo “启动Tomcat服务...” systemctl start tomcat-portal echo “等待应用启动...” sleep 30 # 可以添加一个健康检查例如curl应用的健康端点 if curl -s --max-time 10 http://localhost:8080/customer-portal/health /dev/null; then echo “部署成功” else echo “部署可能存在问题请检查日志$TOMCAT_HOME/logs/catalina.out” fi记得给脚本执行权限chmod x deploy-portal.sh。7. 常见问题排查与解决方案实录在实际操作中你几乎一定会遇到一些问题。这里记录了几个最常见的问题和我的排查思路。7.1 端口冲突问题问题现象启动第二个Tomcat实例时失败日志中报java.net.BindException: Address already in use。排查步骤确认错误端口查看日志明确是哪个端口被占用例如8081、8006。查找占用进程使用netstat或lsof命令。# 查看8081端口被谁占用 netstat -tlnp | grep :8081 # 或 lsof -i :8081分析原因被其他服务占用可能是其他软件如Nginx、另一个Tomcat占用了该端口。如果是修改冲突方的端口或停止该服务。被自己的僵尸进程占用有时Tomcat非正常关闭进程未完全退出。使用ps -ef | grep tomcat找到残留进程用kill -9 PID强制结束。配置未生效确认修改的是正确的server.xml文件并且重启了Tomcat。7.2 应用启动失败但Tomcat本身正常问题现象访问应用URL返回404或500错误但Tomcat默认首页http://ip:port可以访问。排查步骤检查部署位置确认WAR包或应用目录是否在正确的webapps目录下。查看应用专属日志Tomcat会在logs目录下为每个应用生成一个日志文件如localhost_customer-portal_yyyy-MM-dd.log。这里是应用初始化失败信息的第一现场。查看Catalina日志重点查看catalina.out和localhost.log寻找SEVERE或ERROR级别的日志通常会有详细的堆栈跟踪。常见原因数据库连接失败检查应用配置的数据库IP、端口、用户名密码。依赖缺失检查WEB-INF/lib下是否有所有必需的JAR包。对于Spring Boot项目通常一个可执行JAR或WAR包已包含所有依赖。内存不足检查catalina.out是否有OutOfMemoryError。需要调整JAVA_OPTS中的-Xmx参数。文件权限问题确保Tomcat进程用户如root或tomcat用户对应用目录、临时目录有读写权限。7.3 服务无法开机自启问题现象配置了systemd服务并enable了但服务器重启后Tomcat没有启动。排查步骤检查服务状态systemctl status tomcat-portal看是否显示active (running)。查看服务日志journalctl -u tomcat-portal -xe这里会有详细的启动失败信息。常见原因依赖服务未就绪在tomcat-portal.service的[Unit]部分可以增加对网络或数据库的依赖例如Afternetwork.target mysqld.service。环境变量问题systemd服务文件中的JAVA_HOME路径可能不正确。使用which java和readlink -f $(which java)找到准确的JAVA_HOME路径。启动超时如果应用启动非常慢可能超过systemd默认的超时时间默认90秒。可以在[Service]部分增加TimeoutStartSec300来延长等待时间。7.4 如何优雅地更新应用直接替换WAR包Tomcat会尝试热部署但在复杂应用中容易出错。我推荐的流程是通过systemctl停止服务systemctl stop tomcat-portal。备份旧应用和日志可选但建议。删除webapps下的旧应用目录和WAR包同时删除work/Catalina/localhost下对应的缓存目录。放入新的WAR包。通过systemctl启动服务systemctl start tomcat-portal。通过tail -f监控日志直到看到应用启动成功的标志。这种“停止-清理-部署-启动”的模式比热部署更稳定对于绝大多数应用来说几十秒的停机时间是可以接受的。如果要求零停机则需要设计蓝绿部署或滚动更新方案这通常需要结合负载均衡器和更复杂的脚本。

相关新闻