全网最全Tomcat完全卸载重装教程小结

Tomcat 完全卸载与重装教程，适用于 Windows、Linux 和 macOS 系统。

一、完全卸载 Tomcat

1. 停止 Tomcat 服务

# Windows（以管理员身份运行CMD）
net stop Tomcat9
# 或直接结束进程
taskkill /F /IM tomcat*.exe

# Linux/macOS
sudo systemctl stop tomcat
# 或使用 startup.sh 对应的 shutdown.sh
/path/to/tomcat/bin/shutdown.sh

2. 卸载服务（Windows）

# 进入 Tomcat bin 目录
cd C:\Tomcat\bin
service.bat remove

3. 删除 Tomcat 安装目录

# Windows
rmdir /S /Q C:\Tomcat

# Linux/macOS
sudo rm -rf /opt/tomcat

4. 删除环境变量

• Windows：系统属性 → 高级 → 环境变量
  • 删除 CATALINA_HOME
  • 删除 CATALINA_BASE
  • 从 PATH 中移除 Tomcat bin 目录
• Linux/macOS：编辑 ~/.bashrc 或 ~/.zshrc

  # 删除或注释以下行
  export CATALINA_HOME=/opt/tomcat
  export PATH=$CATALINA_HOME/bin:$PATH

5. 删除相关文件和注册表（Windows）

• 删除 C:\Program Files\Apache Software Foundation
• 清理注册表（谨慎操作）：
  • 运行 regedit
  • 删除 HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation
  • 删除 HKEY_CURRENT_USER\Software\Apache Software Foundation

6. 删除临时文件

# Windows
rmdir /S /Q %TEMP%\tomcat*
rmdir /S /Q C:\Users\%USERNAME%\AppData\Local\Temp\tomcat*

# Linux/macOS
sudo rm -rf /tmp/tomcat*
sudo rm -rf /var/tmp/tomcat*

7. 清理端口占用（可选）

# Windows 查看端口占用
netstat -ano | findstr :8080

# Linux/macOS
sudo lsof -i :8080

二、全新安装 Tomcat

1. 下载最新版本

• 官网：https://tomcat.apache.org
• 推荐版本：Tomcat 9.x 或 10.x（根据需求选择）

2. 安装步骤

# 1. 解压到指定目录（建议非系统盘）
C:\Apache\Tomcat9

# 2. 配置环境变量
CATALINA_HOME = C:\Apache\Tomcat9
PATH 添加 %CATALINA_HOME%\bin

# 3. 安装服务
cd %CATALINA_HOME%\bin
service.bat install

# 4. 启动服务
net start Tomcat9

# 1. 解压安装包
sudo tar -zxvf apache-tomcat-9.x.tar.gz -C /opt
sudo mv /opt/apache-tomcat-9.x /opt/tomcat

# 2. 创建专用用户
sudo useradd -r -m -U -d /opt/tomcat -s /bin/false tomcat

# 3. 设置权限
sudo chown -R tomcat: /opt/tomcat
sudo chmod +x /opt/tomcat/bin/*.sh

# 4. 创建 systemd 服务
sudo nano /etc/systemd/system/tomcat.service

3. Systemd 服务文件（Linux）

[Unit]
Description=Apache Tomcat Web Application Container
After=network.target

[Service]
Type=forking
User=tomcat
Group=tomcat
Environment="CATALINA_PID=/opt/tomcat/temp/tomcat.pid"
Environment="JAVA_HOME=/usr/lib/jvm/java-11-openjdk"
Environment="CATALINA_HOME=/opt/tomcat"
Environment="CATALINA_BASE=/opt/tomcat"
ExecStart=/opt/tomcat/bin/startup.sh
ExecStop=/opt/tomcat/bin/shutdown.sh

[Install]
WantedBy=multi-user.target

4. 启动服务

# Linux
sudo systemctl daemon-reload
sudo systemctl enable tomcat
sudo systemctl start tomcat

# 验证
sudo systemctl status tomcat

三、基础配置

1. 修改默认端口

编辑 conf/server.xml：

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

2. 配置管理员账户

编辑 conf/tomcat-users.xml：

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

3. 启用管理界面访问

编辑 webapps/manager/META-INF/context.xml：

<!-- 注释掉 Valve 配置 -->
<!-- <Valve className="org.apache.catalina.valves.RemoteAddrValve"
       allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" /> -->

四、验证安装

五、常见问题解决

1. 端口冲突

# 修改 server.xml 中的端口号
<Connector port="8081" ... />

2. 权限拒绝

# Linux 设置权限
sudo chmod 755 /opt/tomcat -R

3. JAVA_HOME 未设置

# 检查 Java 安装
java -version
# 设置环境变量
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk

六、最佳实践建议

按照以上步骤操作，即可完成 Tomcat 的彻底卸载和全新安装。