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

用户975147075136
27 阅读4分钟

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（官方）

  • Windows：zip（解压版，推荐）
  • Linux：tar.gz
  • 国内镜像（加速）：清华/华为镜像站

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

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

  • 解压到：​​D:\dev\apache-tomcat-9.0.85​​
  • ❌ 错误：​​C:\Program Files\Tomcat 9.0​​（含空格）、​​D:\软件\Tomcat​​（含中文）

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

  1. 右键 此电脑 → 属性 → 高级系统设置 → 环境变量
  2. 系统变量 → 新建：
  • 变量名：​​CATALINA_HOME​​
  • 变量值：​​D:\dev\apache-tomcat-9.0.85​​（你的解压路径）
  1. 找到 Path → 编辑 → 新建：
%CATALINA_HOME%\bin
  1. 全部窗口 确定 保存

步骤3：启动与验证

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

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

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

# 1. 下载（以Tomcat 9为例）
cd /usr/local
wget https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.85/bin/apache-tomcat-9.0.85.tar.gz

# 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包（最简单）

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

  • 修改 ​​conf/server.xml​​，在 ​​<Host>​​ 内添加：
<Context path="/myweb" docBase="D:\project\myweb" reloadable="true"/>

方法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根目录）
  1. 端口8080被占用
  • 解决：修改 ​​server.xml​​ 端口 或 关闭占用程序
  1. 访问404
  • 检查：Tomcat已启动、端口正确、项目部署成功
  1. 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常用命令速查表（启动/关闭/日志/端口/部署），方便你随时查阅吗？

avatar
文章
阅读
粉丝