Windows 10 Tomcat 配置指南

在 Windows 10 专业版上配置 Tomcat 可以分为以下几个清晰的步骤。本指南将涵盖从下载、安装、环境变量配置到服务安装和管理的全过程。

准备工作

确保已安装 Java (JDK)
Tomcat 是基于 Java 的，所以必须先安装 Java。

检查是否已安装： 打开命令提示符 ( cmd)，输入  java -version。如果显示了版本信息（如  java version "1.8.0_xxx" 或  java version "17.0.x"），则说明已安装。

如果未安装：

前往 Oracle JDK 官网 或 OpenJDK 官网 下载。

对于 Tomcat，建议使用 JDK 8, 11, 或 17（请根据你的项目需求选择，Tomcat 10 及以上需要 JDK 11+）。

安装 JDK，记住安装路径（例如  C:Program FilesJavajdk-17）。

配置 JAVA_HOME 环境变量

在 Windows 搜索栏输入 “编辑系统环境变量” 并打开。

点击下方的 “环境变量”。

在 “系统变量” 部分，点击 “新建”。

变量名：  JAVA_HOME

变量值： 你的 JDK 安装路径（例如  C:Program FilesJavajdk-17）

找到并选中系统变量中的  Path，点击 “编辑”。

点击 “新建”，添加一行：  %JAVA_HOME%in

点击 “确定” 保存所有更改。

验证： 打开一个新的命令提示符，输入  echo %JAVA_HOME%，应该能正确显示路径。再输入  java -version 确认无误。

第一步：下载和安装 Tomcat

下载 Tomcat

访问 Apache Tomcat 官方网站。

在左侧 "Download" 下，选择你需要版本的 "Tomcat 10", "Tomcat 9" 等（建议选择最新的稳定版，如 Tomcat 10.x）。注意版本与 Servlet/JSP 规范的对应关系。

在 "Binary Distributions" -> "Core" 下，选择  zip 压缩包（例如  apache-tomcat-10.1.xx-windows-x64.zip）进行下载。

“安装” Tomcat

Tomcat 是绿色软件，不需要安装程序。只需解压到你想要的目录即可。

创建一个你喜欢的目录，例如  C:Program Files 或  D:Servers。

将下载的 ZIP 文件解压到这个目录。解压后会得到一个类似  apache-tomcat-10.1.xx 的文件夹。

为了方便，你可以将文件夹重命名为一个简单的名字，如  Tomcat10。

完整路径示例：  D:ServersTomcat10

第二步：配置 Tomcat

配置 CATALINA_HOME 环境变量（可选但推荐）

和配置  JAVA_HOME 类似，在 系统变量 中新建一个变量：

变量名：  CATALINA_HOME

变量值： 你的 Tomcat 解压目录（例如  D:ServersTomcat10）

这个变量在很多脚本和 IDE 配置中会用到。

测试基本运行

打开文件资源管理器，进入你的 Tomcat 目录下的  bin 文件夹（例如  D:ServersTomcat10in）。

双击运行  startup.bat 文件。

会弹出一个新的命令提示符窗口，并开始输出启动日志。如果最后看到类似  Server startup in [xxxx] milliseconds 的信息，说明启动成功。

打开你的浏览器，访问  http://localhost:8080。

如果你看到了 Tomcat 的默认欢迎页面（有一只汤姆猫），恭喜你，基础配置成功！

要关闭服务器，可以运行  bin 目录下的  shutdown.bat，或者直接关闭启动时弹出的命令窗口。

第三步：将 Tomcat 安装为 Windows 服务（推荐）

以服务方式运行 Tomcat，可以做到开机自启、在后台运行、更稳定的管理。

使用 service.bat 安装服务

以 管理员身份 打开命令提示符 ( cmd)。

导航到你的 Tomcat 的  bin 目录：

cmd

cd /d D:ServersTomcat10in

运行以下命令安装服务：

cmd

service.bat install

如果成功，你会看到  The service 'Tomcat10' has been installed 的提示。服务名默认基于文件夹名。

管理和配置服务

按  Win + R，输入  services.msc 并回车，打开 “服务” 管理控制台。

在服务列表中找到你刚安装的 Tomcat 服务（名称如  Tomcat10）。

你可以在这里右键点击服务，进行 启动、停止、重启 操作。

配置启动类型： 右键点击服务 -> 属性 -> 启动类型。可以选择：

自动： 开机时自动启动 Tomcat。

手动： 需要时手动启动。

现在，你可以通过服务来启动/停止 Tomcat，而无需运行  startup.bat。

第四步：常见配置与管理

修改端口号
Tomcat 默认使用 8080 端口。如果该端口被占用，需要修改。

打开 Tomcat 目录下的  conf 文件夹。

用文本编辑器（如 Notepad++ 或 VS Code）打开  server.xml 文件。

找到以下行（大约在 70 行左右）：

xml

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />

将  port="8080" 修改为你想要的端口，例如  port="8081"。

保存文件，并重启 Tomcat 服务。

管理用户配置（访问 Manager App）
为了使用 Tomcat 自带的 Web 管理界面（Manager App），需要配置用户角色。

打开  conf 目录下的  tomcat-users.xml 文件。

在  <tomcat-users> 标签内，添加如下配置（在  </tomcat-users> 之前）：

xml

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

manager-gui 角色允许管理 Web 应用程序（部署、卸载）。

admin-gui 角色允许访问主机管理界面。

保存文件，并重启 Tomcat 服务。

现在你可以通过  http://localhost:8080/manager/html 和  http://localhost:8080/host-manager/html 来访问管理界面，并用你设置的用户名密码登录。

部署 Web 应用

简单方式： 将你的  .war 文件或整个 Web 项目文件夹，复制到 Tomcat 的  webapps 目录下。Tomcat 启动或重载时会自动解压和部署。

通过管理界面： 使用上面配置的 Manager App ( http://localhost:8080/manager/html)，在 "WAR file to deploy" 区域上传并部署你的  .war 文件。

故障排除

启动窗口一闪而过：

最常见的原因是  JAVA_HOME 环境变量未正确设置。请仔细检查。

可以尝试在  startup.bat 文件的最后一行添加  pause，然后再次运行，这样窗口不会关闭，可以看到具体的错误信息。

端口被占用：

修改  server.xml 中的端口号。

或者找到并关闭占用 8080 端口的程序。可以使用命令  netstat -ano | findstr :8080 查找 PID，然后在任务管理器中结束该进程。

访问  localhost:8080 被拒绝：

检查 Tomcat 服务是否真的成功启动。查看服务状态或  logs 目录下的  catalina.out 日志文件。

检查 Windows 防火墙是否阻止了 Tomcat。

按照以上步骤，你应该可以在 Windows 10 专业版上顺利完成 Tomcat 的配置。