Linux 安装 Tomcat 须手动解压、正确配置 JAVA_HOME 指向 JDK（非 JRE）、修改 tomcat-users.xml 启用 manager-gui 角色，并用 systemd 托管时配对 Type=forking 与 PIDFile。
Linux 上安装 Tomcat 不需要“安装包”意义上的安装，而是解压即用；但必须确保 JAVA_HOME 正确且 java -version 能输出 JDK 8+ 版本，否则 startup.sh 会静默失败或报 Cannot find ./bin/setclasspath.sh 类似错误。
确认系统已装 JDK 并配置 JAVA_HOME
Tomcat 是 Java 应用，不自带 JRE，依赖系统级 JDK。常见误区是只装了 openjdk-11-jre（只有运行时），没装 openjdk-11-jdk（含 javac 和 tools.jar，Tomcat 启动脚本会检测）。
- 运行
java -version和javac -version，两者输出版本号必须一致且 ≥ 8 - 检查
$JAVA_HOME：执行echo $JAVA_HOME，应指向 JDK 根目录（如/usr/lib/jvm/java-11-openjdk-amd64），不是jre子目录 - 若未设置，临时生效可运行：
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64；永久生效需写入~/.bashrc或/etc/profile
下载并解压 Tomcat，避免用系统包管理器安装
Debian/Ubuntu 的 apt install tomcat9 或 CentOS 的 yum install tomcat 会把文件散落到 /usr/share/tomcat9、/var/lib/tomcat9 等多处，权限、日志路径、启动方式均被封装，不利于调试和定制。生产环境推荐手动解压部署。
- 从官网下载二进制 tar.gz 包（如
apache-tomcat-10.1.24.tar.gz），不要下 zip 或 src 包 - 解压到非 root 目录，例如：
tar -xzf apache-tomcat-10.1.24.tar.gz -C /opt/→ 得到/opt/apache-tomcat-10.1.24 - 改属主（尤其如果你用
sudo解压过）：sudo chown -R $USER:$USER /opt/apache-tomcat-10.1.24
启动前必须修改 conf/tomcat-users.xml 才能访问 Manager 页面
默认 Tomcat 禁用所有管理界面，直接访问 http://localhost:8080/manager/html 会 403。这不是端口或防火墙问题，是权限配置缺失。
立即学习“Java免费学习笔记（深入）”；
- 编辑
/opt/apache-tomcat-10.1.24/conf/tomcat-users.xml - 在
manager-gui，不是旧版的manager）： - 同时需确认
webapps/manager/META-INF/context.xml中注释掉 IP 限制（或删掉allow属性），否则本地也访问不了
用 systemd 托管服务时，Type=forking 和 PIDFile 必须配对
直接运行 bin/startup.sh 是前台调试用法；生产必须用 systemd 管理生命周期。错配 Type 会导致 systemctl start tomcat 返回 success，但实际没进程，或 status 显示 inactive。
- 新建服务文件：
/etc/systemd/system/tomcat.service - 关键字段必须为：
Type=forkingPIDFile=/opt/apache-tomcat-10.1.24/logs/catalina.pidExecStart=/opt/apache-tomcat-10.1.24/bin/startup.shExecStop=/opt/apache-tomcat-10.1.24/bin/shutdown.sh - Tomcat 默认不生成
catalina.pid，需在bin/catalina.sh开头添加：CATALINA_PID="$CATALINA_BASE/logs/catalina.pid"
最常被跳过的一步：改完 tomcat-users.xml 后没重启服务，或用 startup.sh 启动却忘了先 source ~/.bashrc 让 JAVA_HOME 生效——这两个点占了 70% 的“启动成功但打不开页面”问题。
