Tomcat安装及配置教程（保姆级）

Tomcat安装及配置教程（保姆级·Windows+Linux）

Tomcat是Java Web必备服务器，全程无坑、解压即用、配置极简，以下分Windows、Linux双系统，从下载→安装→环境变量→启动→配置→部署→常见问题全覆盖。

一、准备工作（必做）

1. 版本兼容（关键）

• Tomcat 9 → JDK 8+ （新手首选，最稳定）
• Tomcat 10 → JDK 11+ （包名变更，兼容旧项目需改包）
• Tomcat 11 → JDK 17+ （最新版）

2. 检查JDK

打开CMD/终端，输入：

java -version

显示版本号即正常；无JDK先装JDK并配置JAVA_HOME。

3. 下载Tomcat（官方）

• 官网：​​​​
• 左侧选版本（9.x推荐）→ Binary Distributions → Core

• Windows：zip（解压版，推荐）
• Linux：tar.gz

• 国内镜像（加速）：清华/华为镜像站

二、Windows系统安装（100%成功）

步骤1：解压（核心：路径无中文、无空格）

• 解压到：​​D:devapache-tomcat-9.0.85​​
• 错误：​​C:Program FilesTomcat 9.0​​（含空格）、​​D:软件Tomcat​​（含中文）

步骤2：配置环境变量（避免闪退）

1. 右键 此电脑 → 属性 → 高级系统设置 → 环境变量
2. 系统变量 → 新建：

• 变量名：​​CATALINA_HOME​​
• 变量值：​​D:devapache-tomcat-9.0.85​​（你的解压路径）

3. 找到 Path → 编辑 → 新建：

%CATALINA_HOME%bin

1. 全部窗口 确定 保存

步骤3：启动与验证

1. 进入 bin 文件夹，双击 startup.bat
2. 出现黑窗口、无闪退、打印 Server startup in xxx ms → 成功
3. 浏览器访问：​​​​ 看到Tomcat欢迎页 → 安装完成
4. 关闭：双击 shutdown.bat

三、Linux系统安装（CentOS/Ubuntu通用）

步骤1：上传/下载安装包

# 1. 下载（以Tomcat 9为例）
cd /usr/local
wget 

# 2. 解压
tar -zxvf apache-tomcat-9.0.85.tar.gz

# 3. 重命名（方便使用）
mv apache-tomcat-9.0.85 tomcat

步骤2：权限配置（必做）

# 给启动脚本执行权限
chmod +x /usr/local/tomcat/bin/*.sh

# 可选：创建专用用户（安全）
useradd -r -s /sbin/nologin tomcat
chown -R tomcat:tomcat /usr/local/tomcat

步骤3：环境变量（永久生效）

vi /etc/profile

# 末尾添加
export CATALINA_HOME=/usr/local/tomcat
export PATH=$CATALINA_HOME/bin:$PATH

# 生效
source /etc/profile

步骤4：启动与验证

# 启动
/usr/local/tomcat/bin/startup.sh

# 查看进程
ps -ef | grep tomcat

# 访问（服务器IP:8080）
curl http://localhost:8080

# 关闭
/usr/local/tomcat/bin/shutdown.sh

四、核心配置（实战必备）

1. 修改默认端口（8080→80/8081）

• 文件：​​conf/server.xml​​
• 找到：

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

• 修改 ​​port="8081"​​ 或 ​​port="80"​​（80端口无需写端口号）
• 保存 → 重启Tomcat 生效

2. 开启管理后台（Tomcat Manager）

• 文件：​​conf/tomcat-users.xml​​
• 末尾 ​​</tomcat-users>​​ 前添加：

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

• 重启 → 访问：​​​​

3. 解决Windows中文乱码

• 文件：​​conf/logging.properties​​
• 修改：

java.util.logging.ConsoleHandler.encoding = GBK

• 重启 → 日志正常显示中文

五、Web项目部署（3种方法）

方法1：直接丢WAR包（最简单）

• 把项目 ​​.war​​ 复制到 ​​webapps​​ 文件夹
• Tomcat 自动解压、自动部署
• 访问：​​项目名​​

方法2：配置外部路径（开发推荐）

• 修改 ​​conf/server.xml​​，在 ​​<Host>​​ 内添加：

<Context path="/myweb" docBase="D:projectmyweb" reloadable="true"/>

• ​​path​​：访问路径
• ​​docBase​​：项目本地路径
• 重启 → 访问：​​​​

方法3：Manager后台上传（可视化）

• 登录Manager → 选择WAR包 → 部署
• 一键启动/停止/卸载项目

六、Linux设置开机自启（生产必备）

1. 创建服务文件：

vi /etc/systemd/system/tomcat.service

1. 写入：

[Unit]
Description=Apache Tomcat
After=network.target

[Service]
Type=forking
User=tomcat
Group=tomcat
Environment="JAVA_HOME=/usr/local/jdk1.8.0_301"
Environment="CATALINA_HOME=/usr/local/tomcat"
ExecStart=/usr/local/tomcat/bin/startup.sh
ExecStop=/usr/local/tomcat/bin/shutdown.sh
Restart=on-failure

[Install]
WantedBy=multi-user.target

1. 启用自启：

systemctl daemon-reload
systemctl enable tomcat
systemctl start tomcat

七、常见问题（99%新手坑）

1. 启动闪退

• 原因：​​JAVA_HOME​​ 未配置/错误
• 解决：正确配置系统变量 ​​JAVA_HOME​​（指向JDK根目录）

2. 端口8080被占用

• 解决：修改 ​​server.xml​​ 端口 或 关闭占用程序

3. 访问404

• 检查：Tomcat已启动、端口正确、项目部署成功

4. Linux启动无反应

• 解决：​​chmod +x *.sh​​ 赋权、查看 ​​logs/catalina.out​​ 日志

八、目录结构（一看就懂）

• ​​bin​​：启动/关闭脚本（​​startup.bat/sh​​）
• ​​conf​​：核心配置（​​server.xml​​、​​tomcat-users.xml​​）
• ​​webapps​​：项目部署目录
• ​​logs​​：日志文件（排错看这里）
• ​​lib​​：依赖库
• ​​work​​：JSP编译临时文件

九、总结

1. Tomcat = 解压即用，无需复杂安装
2. 核心：JDK环境 + 无中文路径
3. 配置：​​server.xml​​（端口）、​​tomcat-users.xml​​（权限）
4. 部署：​​webapps​​丢WAR包最省事
5. 问题：看 ​​logs/catalina.out​​ 日志，90%问题可解决

需要我帮你生成一份 Tomcat常用命令速查表（启动/关闭/日志/端口/部署），方便你随时查阅吗？