一篇文章彻底解决Win10系统下同时部署多个版本的Tomcat

Win10系统下同时部署多个Tomcat版本的终极指南

一、前言

在Java Web开发中，有时需要同时运行多个不同版本的Tomcat服务器，例如：

• 同时开发和测试多个项目，每个项目依赖不同的Tomcat版本
• 迁移旧项目时需要新旧版本Tomcat并行运行
• 学习和比较不同Tomcat版本的特性

本指南将详细介绍在Windows 10系统下同时部署和运行多个Tomcat版本的完整解决方案。

二、准备工作

1. 下载不同版本的Tomcat

访问Apache Tomcat官网下载所需版本：

https://tomcat.apache.org/download-xx.cgi

建议下载zip压缩包版本（便于部署多个实例）

2. 确保Java环境已正确安装

# 检查Java版本
java -version

# 检查JAVA_HOME环境变量
echo %JAVA_HOME%

三、部署多个Tomcat实例

方案一：基于不同端口的标准部署（推荐）

1. 创建目录结构

D:\TomcatServers\
├── tomcat9-8080\
├── tomcat9-8081\
├── tomcat10-8082\
└── tomcat10-8083\

2. 配置第一个Tomcat实例（Tomcat 9，端口8080）

步骤1：解压并重命名 将apache-tomcat-9.0.xx.zip解压到D:\TomcatServers\tomcat9-8080

步骤2：修改server.xml中的端口配置 编辑 conf/server.xml：

<!-- 修改以下端口，确保与其他实例不冲突 -->
<Server port="8005" shutdown="SHUTDOWN">  <!-- 改为8005 -->

<Connector port="8080" protocol="HTTP/1.1"  <!-- 保持8080 -->
           connectionTimeout="20000"
           redirectPort="8443" />

<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />  <!-- 改为8009 -->

步骤3：配置CATALINA_HOME和CATALINA_BASE 创建 bin\setenv.bat：

@echo off
set JAVA_HOME=C:\Program Files\Java\jdk-11.0.xx
set JRE_HOME=%JAVA_HOME%
set CATALINA_HOME=D:\TomcatServers\tomcat9-8080
set CATALINA_BASE=D:\TomcatServers\tomcat9-8080

3. 配置第二个Tomcat实例（Tomcat 9，端口8081）

步骤1：复制并重命名 将第一个Tomcat文件夹复制为tomcat9-8081

步骤2：修改server.xml中的端口 编辑 conf/server.xml：

<Server port="8006" shutdown="SHUTDOWN">  <!-- 改为8006 -->

<Connector port="8081" protocol="HTTP/1.1"  <!-- 改为8081 -->
           connectionTimeout="20000"
           redirectPort="8444" />           <!-- 改为8444 -->

<Connector port="8010" protocol="AJP/1.3" redirectPort="8444" />  <!-- 改为8010 -->

步骤3：修改setenv.bat

@echo off
set JAVA_HOME=C:\Program Files\Java\jdk-11.0.xx
set JRE_HOME=%JAVA_HOME%
set CATALINA_HOME=D:\TomcatServers\tomcat9-8081
set CATALINA_BASE=D:\TomcatServers\tomcat9-8081

4. 配置Tomcat 10实例（类似方法，端口8082、8083）

方案二：使用服务方式运行多个Tomcat

1. 安装Tomcat为Windows服务

# 进入Tomcat的bin目录
cd D:\TomcatServers\tomcat9-8080\bin

# 安装服务（指定服务名称）
service.bat install Tomcat9-8080

# 同理安装其他实例
cd D:\TomcatServers\tomcat9-8081\bin
service.bat install Tomcat9-8081

2. 修改服务配置

编辑注册表或使用tomcat9w.exe配置每个服务的：

• Java虚拟机路径
• 启动参数
• 内存设置

四、详细配置说明

1. 端口规划表

服务	HTTP端口	SHUTDOWN端口	AJP端口	Redirect端口
Tomcat9-1	8080	8005	8009	8443
Tomcat9-2	8081	8006	8010	8444
Tomcat10-1	8082	8007	8011	8445
Tomcat10-2	8083	8008	8012	8446

2. 完整的setenv.bat模板

@echo off
rem ========== JDK配置 ==========
set "JAVA_HOME=C:\Program Files\Java\jdk-11.0.xx"
set "JRE_HOME=%JAVA_HOME%\jre"

rem ========== Tomcat路径配置 ==========
set "CATALINA_HOME=%~dp0.."
set "CATALINA_BASE=%CATALINA_HOME%"

rem ========== 内存配置 ==========
set "JAVA_OPTS=%JAVA_OPTS% -Xms512m -Xmx1024m"
set "JAVA_OPTS=%JAVA_OPTS% -XX:MaxPermSize=256m"

rem ========== 编码配置 ==========
set "JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF-8"

rem ========== 时区配置 ==========
set "JAVA_OPTS=%JAVA_OPTS% -Duser.timezone=Asia/Shanghai"

rem ========== 调试配置（可选） ==========
rem set "JAVA_OPTS=%JAVA_OPTS% -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005"

3. 统一启动/停止脚本

创建 D:\TomcatServers\manage_all.bat：

@echo off
echo ========================================
echo    多Tomcat实例管理脚本
echo ========================================
echo.
echo 1. 启动所有Tomcat实例
echo 2. 停止所有Tomcat实例
echo 3. 启动Tomcat9-8080
echo 4. 启动Tomcat9-8081
echo 5. 启动Tomcat10-8082
echo 6. 启动Tomcat10-8083
echo 7. 退出
echo.
set /p choice=请选择操作(1-7):

if "%choice%"=="1" goto start_all
if "%choice%"=="2" goto stop_all
if "%choice%"=="3" goto start1
if "%choice%"=="4" goto start2
if "%choice%"=="5" goto start3
if "%choice%"=="6" goto start4
if "%choice%"=="7" exit

:start_all
call :start1
call :start2
call :start3
call :start4
goto :eof

:stop_all
call :stop1
call :stop2
call :stop3
call :stop4
goto :eof

:start1
echo 正在启动Tomcat9-8080...
call "D:\TomcatServers\tomcat9-8080\bin\startup.bat"
goto :eof

:stop1
echo 正在停止Tomcat9-8080...
call "D:\TomcatServers\tomcat9-8080\bin\shutdown.bat"
goto :eof

:start2
echo 正在启动Tomcat9-8081...
call "D:\TomcatServers\tomcat9-8081\bin\startup.bat"
goto :eof

:stop2
echo 正在停止Tomcat9-8081...
call "D:\TomcatServers\tomcat9-8081\bin\shutdown.bat"
goto :eof

:start3
echo 正在启动Tomcat10-8082...
call "D:\TomcatServers\tomcat10-8082\bin\startup.bat"
goto :eof

:stop3
echo 正在停止Tomcat10-8082...
call "D:\TomcatServers\tomcat10-8082\bin\shutdown.bat"
goto :eof

:start4
echo 正在启动Tomcat10-8083...
call "D:\TomcatServers\tomcat10-8083\bin\startup.bat"
goto :eof

:stop4
echo 正在停止Tomcat10-8083...
call "D:\TomcatServers\tomcat10-8083\bin\shutdown.bat"
goto :eof

五、常见问题与解决方案

问题1：端口冲突

症状：启动时提示"Address already in use" 解决：

检查端口占用：netstat -ano | findstr :8080 修改冲突的端口号 杀死占用进程：taskkill /F /PID 进程ID

问题2：JAVA_HOME未设置

症状：Neither the JAVA_HOME nor the JRE_HOME environment variable is defined 解决：

确保setenv.bat中正确设置了JAVA_HOME 或在系统环境变量中设置全局JAVA_HOME

问题3：多个Tomcat实例共享lib问题

解决：确保每个实例的CATALINA_BASE指向独立目录

问题4：内存不足

解决：调整setenv.bat中的内存参数：

set "JAVA_OPTS=%JAVA_OPTS% -Xms256m -Xmx512m -XX:MaxPermSize=128m"

六、优化建议

1. 使用Nginx反向代理（可选）

配置nginx.conf：

http {
    upstream tomcat_cluster {
        server localhost:8080 weight=1;
        server localhost:8081 weight=1;
        server localhost:8082 weight=1;
    }

    server {
        listen       80;
        server_name  localhost;

        location / {
            proxy_pass http://tomcat_cluster;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
        }
    }
}

2. 日志文件分离

修改每个实例的 conf/logging.properties：

1catalina.org.apache.juli.AsyncFileHandler.directory = ${catalina.base}/logs
2localhost.org.apache.juli.AsyncFileHandler.directory = ${catalina.base}/logs
3manager.org.apache.juli.AsyncFileHandler.directory = ${catalina.base}/logs
4host-manager.org.apache.juli.AsyncFileHandler.directory = ${catalina.base}/logs

3. 性能监控配置

在每个Tomcat的 conf/server.xml 中添加：

<Valve className="org.apache.catalina.valves.AccessLogValve"
       directory="logs"
       prefix="localhost_access_log"
       suffix=".txt"
       pattern="%h %l %u %t &quot;%r&quot; %s %b %D" />

七、验证部署

1. 启动所有Tomcat实例

cd D:\TomcatServers
call manage_all.bat
选择1启动所有实例

2. 验证各实例运行状态

在浏览器中访问：

• http://localhost:8080
• http://localhost:8081
• http://localhost:8082
• http://localhost:8083

3. 查看日志

检查各实例logs目录下的日志文件：

• catalina.out
• localhost.yyyy-mm-dd.log
• manager.yyyy-mm-dd.log

八、总结

通过以上步骤，您可以在Windows 10系统上成功部署和管理多个Tomcat版本。关键要点：

端口规划：确保每个实例使用不同的端口组 独立配置：每个实例应有独立的CATALINA_BASE 环境隔离：通过setenv.bat为每个实例配置独立环境 统一管理：使用批处理脚本统一管理所有实例

这种部署方式不仅适用于开发和测试环境，经过适当调整也可用于生产环境的多实例部署。根据实际需求，您还可以进一步配置负载均衡、会话共享等高级功能。